PHP 7.2.0 Beta 1 Released


(PHP 4, PHP 5, PHP 7)

get_cfg_varGets the value of a PHP configuration option


string get_cfg_var ( string $option )

Gets the value of a PHP configuration option.

This function will not return configuration information set when the PHP was compiled, or read from an Apache configuration file.

To check whether the system is using a configuration file, try retrieving the value of the cfg_file_path configuration setting. If this is available, a configuration file is being used.



The configuration option name.

Return Values

Returns the current value of the PHP configuration variable specified by option, or FALSE if an error occurs.


Version Description
5.3.0 get_cfg_var() was fixed to be able to return "array" ini options.

See Also

add a note add a note

User Contributed Notes 5 notes

surfchen at gmail dot com
10 years ago
get_cfg_var returns the value from php.ini directly,while the ini_get returns   the runtime config value. I have tried it on PHP 5.1.6

[EDIT by danbrown AT php DOT net: The author of this note means that ini_get() will return values set by ini_set(), .htaccess, a local php.ini file, and other functions at runtime.  Conversely, get_cfg_var() will return strictly the server php.ini.]
tbrix13 at uzitech dot com
3 years ago
keep in mind get_cfg_var() returns a string(1) '1' for the value: On

//in php.ini
//A = On

$A1 = get_cfg_var("A") === "On";
$A2 = get_cfg_var("A") === 1;
$A3 = get_cfg_var("A") === "1";

//$A1 is false
//$A2 is false
//$A3 is true
gabriel b
4 years ago
settings with the value of 'yes' will be returned as '1'.

//#my ini file
//A = 1
//B = any-thing
//C = yes
//D = /some/path/file

get_cfg_var('A') // returns '1'
get_cfg_var('B') // returns 'any-thing'
get_cfg_var('C') // returns '1', wait, why?
get_cfg_var('D') // returns '/some/path/file'

I had my setting = yes and then checked it as ==="yes" for epic fail.
techno dot rahul1988 at gmail dot com
3 years ago
The difference between ini_get() and get_cfg_var() is as follows:
@) ini_get(): returns the current value in .htaccess or as defined in PHP_INI_USER or PHP_INI_PERDIR
@) get_cfg_var: returns the values defined in the php.ini
10 years ago
Regarding the statement by the earlier poster that:

"Unfortunately, you almost never want to know the original value in the config file. Instead, you want to know the value currently in effect."

I have found this useful for changing the error reporting levels for a few specific pages while testing. I turn on all error_reporting while testing, but for a few pages I want to turn off notices. So, I put this at the top of the page:


and this at the bottom:


to put it back to whatever default I had at the time.
To Top