PHP: Hypertext Preprocessor (original) (raw)
ini_set
(PHP 4, PHP 5, PHP 7, PHP 8)
ini_set — Sets the value of a configuration option
Description
Parameters
option
Not all the available options can be changed usingini_set(). There is a list of all available options in the appendix.
value
The new value for the option.
Return Values
Returns the old value on success, [false](reserved.constants.php#constant.false) on failure.
Changelog
| Version | Description |
|---|---|
| 8.1.0 | value now accepts any scalar type (including null). Previously, only string values were accepted. |
Examples
Example #1 Setting an ini option
`<?php
echo ini_get('display_errors');
if (!
ini_get('display_errors')) {
ini_set('display_errors', '1');
}
echo
ini_get('display_errors');
?>`
See Also
- get_cfg_var() - Gets the value of a PHP configuration option
- ini_get() - Gets the value of a configuration option
- ini_get_all() - Gets all configuration options
- ini_restore() - Restores the value of a configuration option
- How to change configuration settings
Found A Problem?
10 years ago
I have experienced on some systems that ini_set() will fail and return a false, when trying to set a setting that was set inside php.ini inside a per-host setting. Beware of this.
Tr909 at com dot nospam dot bigfoot ¶
22 years ago
`[[[Editors note: Yes, this is very true. Same with
register_globals, magic_quotes_gpc and others.
]]]
Many settings, although they do get set, have no influence in your script.... like upload_max_filesize will get set but uploaded files are already passed to your PHP script before the settings are changed.
Also other settings, set by ini_set(), may be to late because of this (post_max_size etc.).
beware, try settings thru php.ini or .htaccess.
`
7 years ago
`When checking for the success of ini_set(), keep in mind that it will return the OLD value upon success - which may have been "0". Therefore you cannot just compare the return value - you have to check for "identity":
This explains reported situations where ini_set() "always" seems to fail!
`
18 years ago
`Be careful with setting an output_handler, as you can't use ini_set() to change it. sigh
In my php.ini I have this for my web pages (and I want it):
output_handler = ob_gzhandler
But this causes my command line scripts to not show output until the very end.
#!/usr/bin/php -q
" . ini_get('output_handler') . "\n";
?>
root@# ./myscript.php
output_handler => ob_gzhandler
Apparently (acording to Richard Lynch):
TOO LATE!
The ob_start() has already kicked in by this point.
ob_flush() until there are no more buffers.
`
22 years ago
`If it's not your server and therefore you want to hide the data in your session variables from other users, it�s very useful to set the session.save_handler in your scripts to shared memory with:
Remember: You have to set it in every script that uses the session variables BEFORE "session_start()" or php won't find them.
`
10 years ago
Note that this function only works with PHP_INI_ALL options!
19 years ago
`set PHP_INI_PERDIR settings in a .htaccess file with 'php_flag' like this:
php_flag register_globals off
php_flag magic_quotes_gpc on
`
19 years ago
`When your ISP does not allow you to add the default include directories - it might be useful to extend the 'include_path' variable:
`
13 years ago
`Careful - in some cases, when setting zlib.output_compression to "On" via ini_set, PHP won't send the Content-type header and browsers will garble the output. Set it to the desired buffer size instead, which sends the correct header:
`
3 years ago
`In order to change zend.assertions or assert.exception values, try with the ini_set() function but be aware that it may fail.
Example:
<?php
$ret = @ini_set('zend.assertions', '1');
if ($ret === false) echo 'ini_set() failed before line ', LINE, PHP_EOL;
`
johnzoet at netscape dot com ¶
23 years ago
`[[[Editors note: Just because you're able to set something
doesn't mean it will work as expected. Depends on the
setting. For example. setting register_globals at
runtime will be of little use as its job has already
been completed by the time it reaches your script.
]]]
When a setting can not be changed in a user script, the return value of ini_set is "empty", not "false" as you may expect.
If you check in your script for return value is "false" the script will continue processing, although the setting has not been set.
The boolean return value is used for settings that can be changed in a script. Otherwise the empty value is returned.
To test for both error conditions use:
`
9 years ago
`if u receive an Error with generic like :
Maximum execution time of 30 seconds exceeded
if u set ini_set(max_execution_time, 300);
your problem will be solved
pls note that the 300 , is 300 seconds , which means 5 minute you can set another value !
`