velocity.ini [ApplicationSettings] #

The block [ApplicationSettings] of settings/velocity.ini, with 2 setting(s).

Never edit settings/velocity.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

• settings/override/velocity.ini.append.php for every siteaccess,
• settings/siteaccess/<siteaccess>/velocity.ini.append.php for one siteaccess,
• extension/<extension>/settings/velocity.ini.append.php in an extension (read when the extension is active).

KeepGlobals #

Globals the application keeps between requests.

A registry filled by a file the kernel reaches with include_once cannot be
refilled once cleared, because include_once will not run that file again.
Four registries in this kernel are built that way -- datatypes, workflow
events, notification events and payment gateways -- and clearing one leaves
a worker unable to resolve it for the rest of its life.

Those are facts about the kernel, so they are exp:velocity's built-in
defaults (expVelocity::DEFAULT_KEEP_GLOBALS) and need no setting. This list
ADDS to them, as does --keep-global=Name[,Name] on start, restart and
command; each name is kept once. `exp:velocity command` shows the result.

Nothing else belongs here. Request-scoped globals must be cleared, and
keeping one leaks a request into the next.

Default: an empty list.

<?php /* #?ini charset="utf-8"?
# settings/override/velocity.ini.append.php
[ApplicationSettings]
# an empty "KeepGlobals[]" first replaces the shipped list; without it the items are added
KeepGlobals[]
*/ ?>

KeepGlobalsDefaults #

enabled (default) keeps the built-in list; disabled starts from nothing,
for a kernel that does not build those registries.

Default: enabled.

<?php /* #?ini charset="utf-8"?
# settings/override/velocity.ini.append.php
[ApplicationSettings]
KeepGlobalsDefaults=enabled
*/ ?>

Related #

• All blocks of velocity.ini
• All INI files
• The settings page

Generated by ./console exp:help:examples from settings/velocity.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.