ini_set

(PHP 4 , PHP 5)

ini_set -- Sets the value of a configuration option

Description

string ini_set ( string varname, string newvalue)

Sets the value of the given configuration option. Returns the old value on success, FALSE on failure. The configuration option will keep this new value during the script's execution, and will be restored at the script's ending.

Not all the available options can be changed using ini_set(). Below is a table with a list of all PHP options (as of PHP 4.2.0), indicating which ones can be changed/set and at what level.

Table 1. Configuration options

NameDefaultChangeable
allow_call_time_pass_reference"1"PHP_INI_PERDIR
allow_url_fopen"1"PHP_INI_SYSTEM
always_populate_raw_post_data"0"PHP_INI_PERDIR
apc.cache_by_default"1"PHP_INI_SYSTEM
apc.enabled"1"PHP_INI_SYSTEM
apc.filters""PHP_INI_SYSTEM
apc.gc_ttl"3600"PHP_INI_SYSTEM
apc.mmap_file_maskNULLPHP_INI_SYSTEM
apc.num_files_hint"1000"PHP_INI_SYSTEM
apc.optimization"0"PHP_INI_SYSTEM
apc.shm_segments"1"PHP_INI_SYSTEM
apc.shm_size"30"PHP_INI_SYSTEM
apc.ttl"0"PHP_INI_SYSTEM
apd.dumpdirNULLPHP_INI_ALL
apd.statement_tracing"0"PHP_INI_ALL
arg_separator.input"&"PHP_INI_PERDIR
arg_separator.output"&"PHP_INI_ALL
asp_tags"0"PHP_INI_PERDIR
assert.active"1"PHP_INI_ALL
assert.bail"0"PHP_INI_ALL
assert.callbackNULLPHP_INI_ALL
assert.quiet_eval"0"PHP_INI_ALL
assert.warning"1"PHP_INI_ALL
auto_append_fileNULLPHP_INI_PERDIR
auto_detect_line_endings"0"PHP_INI_ALL
auto_globals_jit"1"PHP_INI_PERDIR
auto_prepend_fileNULLPHP_INI_PERDIR
bcmath.scale"0"PHP_INI_ALL
blenc.key_file"/usr/local/etc/blenckeys"PHP_INI_ALL
browscapNULLPHP_INI_SYSTEM
child_terminate"0"PHP_INI_ALL
com.allow_dcom"0"PHP_INI_SYSTEM
com.autoregister_casesensitive"1"PHP_INI_ALL
com.autoregister_typelib"0"PHP_INI_ALL
com.autoregister_verbose"0"PHP_INI_ALL
com.code_page""PHP_INI_ALL
com.typelib_file""PHP_INI_SYSTEM
crack.default_dictionaryNULLPHP_INI_SYSTEM
date.default_latitude"31.7667"PHP_INI_ALL
date.default_longitude"35.2333"PHP_INI_ALL
date.sunrise_zenith"90.83"PHP_INI_ALL
date.sunset_zenith"90.83"PHP_INI_ALL
dba.default_handler""PHP_INI_ALL
dbx.colnames_case"unchanged"PHP_INI_SYSTEM
default_charset""PHP_INI_ALL
default_mimetype"text/html"PHP_INI_ALL
default_socket_timeout"60"PHP_INI_ALL
define_syslog_variables"0"PHP_INI_ALL
disable_classes""php.ini only
disable_functions""php.ini only
display_errors"1"PHP_INI_ALL
display_startup_errors"0"PHP_INI_ALL
docref_ext""PHP_INI_ALL
docref_root""PHP_INI_ALL
doc_rootNULLPHP_INI_SYSTEM
enable_dl"1"PHP_INI_SYSTEM
engine"1"PHP_INI_ALL
error_append_stringNULLPHP_INI_ALL
error_logNULLPHP_INI_ALL
error_prepend_stringNULLPHP_INI_ALL
error_reportingNULLPHP_INI_ALL
exif.decode_jis_intel"JIS"PHP_INI_ALL
exif.decode_jis_motorola"JIS"PHP_INI_ALL
exif.decode_unicode_intel"UCS-2LE"PHP_INI_ALL
exif.decode_unicode_motorola"UCS-2BE"PHP_INI_ALL
exif.encode_jis""PHP_INI_ALL
exif.encode_unicode"ISO-8859-15"PHP_INI_ALL
expose_php"1"php.ini only
extension_dir"@PREFIX@"PHP_INI_SYSTEM
fbsql.allow_persistent"1"PHP_INI_SYSTEM
fbsql.autocommit"1"PHP_INI_SYSTEM
fbsql.batchsize"1000"PHP_INI_USER
fbsql.default_database""PHP_INI_SYSTEM
fbsql.default_database_password""PHP_INI_SYSTEM
fbsql.default_hostNULLPHP_INI_SYSTEM
fbsql.default_password""PHP_INI_SYSTEM
fbsql.default_user"_SYSTEM"PHP_INI_SYSTEM
fbsql.generate_warnings"0"PHP_INI_SYSTEM
fbsql.max_connections"128"PHP_INI_SYSTEM
fbsql.max_links"128"PHP_INI_SYSTEM
fbsql.max_persistent"-1"PHP_INI_SYSTEM
fbsql.max_results"128"PHP_INI_SYSTEM
file_uploads"1"PHP_INI_SYSTEM
highlight.bg"#FFFFFF"PHP_INI_ALL
highlight.comment"#FF8000"PHP_INI_ALL
highlight.default"#0000BB"PHP_INI_ALL
highlight.html"#000000"PHP_INI_ALL
highlight.keyword"#007700"PHP_INI_ALL
highlight.string"#DD0000"PHP_INI_ALL
html_errors"1"PHP_INI_ALL
hyperwave.allow_persistent"0"PHP_INI_SYSTEM
hyperwave.default_port"418"PHP_INI_ALL
ibase.allow_persistent"1"PHP_INI_SYSTEM
ibase.dateformat"%Y-%m-%d"PHP_INI_ALL
ibase.default_charsetNULLPHP_INI_ALL
ibase.default_dbNULLPHP_INI_SYSTEM
ibase.default_passwordNULLPHP_INI_ALL
ibase.default_userNULLPHP_INI_ALL
ibase.max_links"-1"PHP_INI_SYSTEM
ibase.max_persistent"-1"PHP_INI_SYSTEM
ibase.timeformat"%H:%M:%S"PHP_INI_ALL
ibase.timestampformat"%Y-%m-%d %H:%M:%S"PHP_INI_ALL
iconv.input_encoding"ISO-8859-1"PHP_INI_ALL
iconv.internal_encoding"ISO-8859-1"PHP_INI_ALL
iconv.output_encoding"ISO-8859-1"PHP_INI_ALL
ifx.allow_persistent"1"PHP_INI_SYSTEM
ifx.blobinfile"1"PHP_INI_ALL
ifx.byteasvarchar"0"PHP_INI_ALL
ifx.charasvarchar"0"PHP_INI_ALL
ifx.default_hostNULLPHP_INI_SYSTEM
ifx.default_passwordNULLPHP_INI_SYSTEM
ifx.default_userNULLPHP_INI_SYSTEM
ifx.max_links"-1"PHP_INI_SYSTEM
ifx.max_persistent"-1"PHP_INI_SYSTEM
ifx.nullformat"0"PHP_INI_ALL
ifx.textasvarchar"0"PHP_INI_ALL
ignore_repeated_errors"0"PHP_INI_ALL
ignore_repeated_source"0"PHP_INI_ALL
ignore_user_abort"0"PHP_INI_ALL
implicit_flush"0"PHP_INI_ALL
include_path".;@PREFIX@\pear"PHP_INI_ALL
ingres.allow_persistent"1"PHP_INI_SYSTEM
ingres.default_databaseNULLPHP_INI_ALL
ingres.default_passwordNULLPHP_INI_ALL
ingres.default_userNULLPHP_INI_ALL
ingres.max_links"-1"PHP_INI_SYSTEM
ingres.max_persistent"-1"PHP_INI_SYSTEM
ircg.control_user"nobody"PHP_INI_ALL
ircg.keep_alive_interval"60"PHP_INI_ALL
ircg.max_format_message_sets"12"PHP_INI_ALL
ircg.shared_mem_size"6000000"PHP_INI_ALL
ircg.work_dir"/tmp/ircg"PHP_INI_ALL
last_modified"0"PHP_INI_ALL
ldap.max_links"-1"PHP_INI_SYSTEM
log_errors"0"PHP_INI_ALL
log_errors_max_len"1024"PHP_INI_ALL
magic_quotes_gpc"1"PHP_INI_PERDIR
magic_quotes_runtime"0"PHP_INI_ALL
magic_quotes_sybase"0"PHP_INI_ALL
mail.force_extra_parametersNULLPHP_INI_PERDIR
mailparse.def_charset"us-ascii"PHP_INI_ALL
max_execution_time"30"PHP_INI_ALL
max_input_time"-1"PHP_INI_PERDIR
mbstring.detect_orderNULLPHP_INI_ALL
mbstring.encoding_translation"0"PHP_INI_PERDIR
mbstring.func_overload"0"PHP_INI_PERDIR
mbstring.http_input"pass"PHP_INI_ALL
mbstring.http_output"pass"PHP_INI_ALL
mbstring.internal_encodingNULLPHP_INI_ALL
mbstring.language"neutral"PHP_INI_PERDIR
mbstring.script_encodingNULLPHP_INI_ALL
mbstring.substitute_characterNULLPHP_INI_ALL
mcrypt.algorithms_dirNULLPHP_INI_ALL
mcrypt.modes_dirNULLPHP_INI_ALL
memory_limit"8M"PHP_INI_ALL
mime_magic.debug"0"PHP_INI_SYSTEM
mime_magic.magicfilePHP_PREFIXPHP_INI_SYSTEM
mssql.allow_persistent"1"PHP_INI_SYSTEM
mssql.batchsize"0"PHP_INI_ALL
mssql.compatability_mode"0"PHP_INI_ALL
mssql.connect_timeout"5"PHP_INI_ALL
mssql.datetimeconvert"1"PHP_INI_ALL
mssql.max_links"-1"PHP_INI_SYSTEM
mssql.max_persistent"-1"PHP_INI_SYSTEM
mssql.max_procs"25"PHP_INI_ALL
mssql.min_error_severity"10"PHP_INI_ALL
mssql.min_message_severity"10"PHP_INI_ALL
mssql.secure_connection"0"PHP_INI_SYSTEM
mssql.textlimit"-1"PHP_INI_ALL
mssql.textsize"-1"PHP_INI_ALL
mssql.timeout"60"PHP_INI_ALL
mysql.allow_persistent"1"PHP_INI_SYSTEM
mysql.connect_timeout"60"PHP_INI_ALL
mysql.default_hostNULLPHP_INI_ALL
mysql.default_passwordNULLPHP_INI_ALL
mysql.default_portNULLPHP_INI_ALL
mysql.default_socketNULLPHP_INI_ALL
mysql.default_userNULLPHP_INI_ALL
mysql.max_links"-1"PHP_INI_SYSTEM
mysql.max_persistent"-1"PHP_INI_SYSTEM
mysql.trace_mode"0"PHP_INI_ALL
mysqli.default_hostNULLPHP_INI_ALL
mysqli.default_port"3306"PHP_INI_ALL
mysqli.default_pwNULLPHP_INI_ALL
mysqli.default_socketNULLPHP_INI_ALL
mysqli.default_userNULLPHP_INI_ALL
mysqli.max_links"-1"PHP_INI_SYSTEM
mysqli.reconnect"0"PHP_INI_SYSTEM
namazu.debugmode"0"PHP_INI_ALL
namazu.langNULLPHP_INI_ALL
namazu.loggingmode"0"PHP_INI_ALL
namazu.sortmethodNULLPHP_INI_ALL
namazu.sortorderNULLPHP_INI_ALL
nsapi.read_timeout"60"PHP_INI_ALL
odbc.allow_persistent"1"PHP_INI_SYSTEM
odbc.check_persistent"1"PHP_INI_SYSTEM
odbc.defaultbinmode"1"PHP_INI_ALL
odbc.defaultlrl"4096"PHP_INI_ALL
odbc.default_dbNULLPHP_INI_ALL
odbc.default_pwNULLPHP_INI_ALL
odbc.default_userNULLPHP_INI_ALL
odbc.max_links"-1"PHP_INI_SYSTEM
odbc.max_persistent"-1"PHP_INI_SYSTEM
open_basedirNULLPHP_INI_SYSTEM
output_buffering"0"PHP_INI_PERDIR
output_handlerNULLPHP_INI_PERDIR
pdo.global_value"42"PHP_INI_ALL
pfpro.defaulthost"test-payflow.verisign.com"PHP_INI_ALL
pfpro.defaultport"443"PHP_INI_ALL
pfpro.defaulttimeout"30"PHP_INI_ALL
pfpro.proxyaddress""PHP_INI_ALL
pfpro.proxylogon""PHP_INI_ALL
pfpro.proxypassword""PHP_INI_ALL
pfpro.proxyport""PHP_INI_ALL
pgsql.allow_persistent"1"PHP_INI_SYSTEM
pgsql.auto_reset_persistent"0"PHP_INI_SYSTEM
pgsql.ignore_notice"0"PHP_INI_ALL
pgsql.log_notice"0"PHP_INI_ALL
pgsql.max_links"-1"PHP_INI_SYSTEM
pgsql.max_persistent"-1"PHP_INI_SYSTEM
post_max_size"8M"PHP_INI_PERDIR
precision"14"PHP_INI_ALL
printer.default_printer""PHP_INI_ALL
register_argc_argv"1"PHP_INI_PERDIR
register_globals"0"PHP_INI_PERDIR
register_long_arrays"1"PHP_INI_PERDIR
report_memleaks"1"PHP_INI_ALL
report_zend_debug"1"PHP_INI_ALL
safe_mode"0"PHP_INI_SYSTEM
safe_mode_allowed_env_vars"PHP_"PHP_INI_SYSTEM
safe_mode_exec_dir"/usr/local/php/bin"PHP_INI_SYSTEM
safe_mode_gid"0"PHP_INI_SYSTEM
safe_mode_include_dirNULLPHP_INI_SYSTEM
safe_mode_protected_env_vars"LD_LIBRARY_PATH"PHP_INI_SYSTEM
sendmail_fromNULLPHP_INI_ALL
sendmail_pathNULLPHP_INI_SYSTEM
serialize_precision"100"PHP_INI_ALL
session.auto_start"0"PHP_INI_ALL
session.bug_compat_42"1"PHP_INI_ALL
session.bug_compat_warn"1"PHP_INI_ALL
session.cache_expire"180"PHP_INI_ALL
session.cache_limiter"nocache"PHP_INI_ALL
session.cookie_domain""PHP_INI_ALL
session.cookie_lifetime"0"PHP_INI_ALL
session.cookie_path"/"PHP_INI_ALL
session.cookie_secure""PHP_INI_ALL
session.entropy_file""PHP_INI_ALL
session.entropy_length"0"PHP_INI_ALL
session.gc_divisor"100"PHP_INI_ALL
session.gc_maxlifetime"1440"PHP_INI_ALL
session.gc_probability"1"PHP_INI_ALL
session.hash_bits_per_character"4"PHP_INI_ALL
session.hash_function"0"PHP_INI_ALL
session.name"PHPSESSID"PHP_INI_ALL
session.referer_check""PHP_INI_ALL
session.save_handler"files"PHP_INI_ALL
session.save_path""PHP_INI_ALL
session.serialize_handler"php"PHP_INI_ALL
session.use_cookies"1"PHP_INI_ALL
session.use_only_cookies"0"PHP_INI_ALL
session.use_trans_sid"0"PHP_INI_ALL
session_pgsql.create_table"1"PHP_INI_SYSTEM
session_pgsql.db"host=localhost dbname=php_session user=nobody"PHP_INI_SYSTEM
session_pgsql.disable"0"PHP_INI_SYSTEM
session_pgsql.failover_mode"0"PHP_INI_SYSTEM
session_pgsql.gc_interval"3600"PHP_INI_SYSTEM
session_pgsql.keep_expired"0"PHP_INI_SYSTEM
session_pgsql.sem_file_name"/tmp/php_session_pgsql"PHP_INI_SYSTEM
session_pgsql.serializable"0"PHP_INI_SYSTEM
session_pgsql.short_circuit"0"PHP_INI_SYSTEM
session_pgsql.use_app_vars"0"PHP_INI_SYSTEM
session_pgsql.vacuum_interval"21600"PHP_INI_SYSTEM
short_open_tag"1"PHP_INI_PERDIR
simple_cvs.authMethod"0"PHP_INI_ALL
simple_cvs.compressionLevel"0"PHP_INI_ALL
simple_cvs.cvsRoot"0"PHP_INI_ALL
simple_cvs.host"0"PHP_INI_ALL
simple_cvs.moduleName"0"PHP_INI_ALL
simple_cvs.userName"0"PHP_INI_ALL
simple_cvs.workingDir"0"PHP_INI_ALL
SMTP"localhost"PHP_INI_ALL
smtp_port"25"PHP_INI_ALL
soap.wsdl_cache_dir"/tmp"PHP_INI_ALL
soap.wsdl_cache_enabled"1"PHP_INI_ALL
soap.wsdl_cache_ttl"86400"PHP_INI_ALL
sql.safe_mode"0"PHP_INI_SYSTEM
sqlite.assoc_case"0"PHP_INI_ALL
sybct.allow_persistent"1"PHP_INI_SYSTEM
sybct.deadlock_retry_count"0"PHP_INI_ALL
sybct.hostnameNULLPHP_INI_ALL
sybct.login_timeout"-1"PHP_INI_ALL
sybct.max_links"-1"PHP_INI_SYSTEM
sybct.max_persistent"-1"PHP_INI_SYSTEM
sybct.min_client_severity"10"PHP_INI_ALL
sybct.min_server_severity"10"PHP_INI_ALL
tidy.clean_output"0"PHP_INI_PERDIR
tidy.default_config""PHP_INI_SYSTEM
track_errors"0"PHP_INI_ALL
unserialize_callback_funcNULLPHP_INI_ALL
upload_max_filesize"2M"PHP_INI_PERDIR
upload_tmp_dirNULLPHP_INI_SYSTEM
url_rewriter.tags"a=href,area=href,frame=src,form=,fieldset="PHP_INI_ALL
user_agentNULLPHP_INI_ALL
user_dirNULLPHP_INI_SYSTEM
valkyrie.auto_validate"0"PHP_INI_ALL
valkyrie.config_pathNULLPHP_INI_ALL
variables_order"EGPCS"PHP_INI_ALL
xbithack"0"PHP_INI_ALL
xmlrpc_errors"0"PHP_INI_SYSTEM
xmlrpc_error_number"0"PHP_INI_ALL
xmms.path"/usr/bin/xmms"PHP_INI_ALL
xmms.session"0"PHP_INI_ALL
y2k_compliance"1"PHP_INI_ALL
yaz.keepalive"120"PHP_INI_ALL
yaz.log_fileNULLPHP_INI_ALL
yaz.max_links"100"PHP_INI_ALL
zend.ze1_compatibility_mode"0"PHP_INI_ALL
zlib.output_compression"0"PHP_INI_ALL
zlib.output_compression_level"-1"PHP_INI_ALL
zlib.output_handler""PHP_INI_ALL

Table 2. Definition of PHP_INI_* constants

ConstantValueMeaning
PHP_INI_USER1Entry can be set in user scripts
PHP_INI_PERDIR2 Entry can be set in php.ini, .htaccess or httpd.conf
PHP_INI_SYSTEM4 Entry can be set in php.ini or httpd.conf
PHP_INI_ALL7Entry can be set anywhere

See also: get_cfg_var(), ini_get(), ini_get_all(), and ini_restore()