INI Settings

int zend_alter_ini_entry(char *name, uint name_length, char *value, uint value_length, int modify_type, int stage); int zend_restore_ini_entry(char *name, uint name_length, int stage);

Changes or restores an INI setting.

Argument

Purpose

name

NULL-terminated name of INI entry being modified.

name_length

Length of name including the trailing NULL byte.

value

New value as a text string, regardless of what the ultimate storage type is. NULL-terminated as always.

value_length

Length of value excluding the trailing NULL byte.

modify_type

Calling scope's declared access level; must contain the same level as the option being modified but can include other levels as well: PHP_INI_SYSTEM, PHP_INI_PERDIR, PHP_INI_USER.

stage

Current execution stage of the Zend Engine. One of: PHP_INI_STAGE_STARTUP, PHP_INI_STAGE_ACTIVATE, PHP_INI_STAGE_RUNTIME, PHP_INI_STAGE_DEACTIVATE, PHP_INI_STAGE_SHUTDOWN.

long zend_ini_long(char *name, uint name_length, int orig); double zend_ini_double(char *name, uint name_length, int orig); char *zend_ini_string(char *name, uint name_length, int orig);

Fetches and converts an INI value. These API functions also come wrapped in macros such as INI_STR() or INI_ORIG_LONG(); refer to Chapter 13, "INI Settings," for more information.

Argument

Purpose

name

NULL-terminated name of INI option to look up.

length

Length of name including trailing NULL byte.

orig

When set to zero, the current INI settingwhich might have been overriddenwill be returned. Otherwise, the original, unmodified setting will be returned.

Категории