(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
ini_get_all — すべての設定オプションを得る
$extension = null, bool $details = true): array|falseすべての登録済み設定オプションを返します。
extension
オプションで指定する拡張モジュール名。
この値が null でない場合、
または 文字列 core を指定した場合、
その拡張モジュールに関するオプションのみを返します。
details
詳細な設定を取得するか、あるいは各設定の現在の値のみを取得するか。
デフォルトは true (詳細情報を取得する) です。
ディレクティブ名をキーとする連想配列を返します。
extension が存在しない場合は、
false を返し、E_WARNING レベルの警告を発生させます。
details が true (デフォルト) の場合、
配列の値は、
global_value (php.iniで設定されている)、
local_value (おそらくini_set()または
.htaccessでセットされている)、access (アクセスレベル)
を含む配列となります。
details が false の場合、
配列の値はそのオプションの現在の値となります。
アクセスレベルの意味についてはマニュアルを参照ください。
注意:
ひとつのディレクティブに複数のアクセスレベルを設定することができます。
accessがビットマスク値となっているのはそのためです。
例1 ini_get_all() の例
<?php
print_r(ini_get_all("pcre"));
print_r(ini_get_all());
?>
上の例の出力は、 たとえば以下のようになります。
Array
(
[pcre.backtrack_limit] => Array
(
[global_value] => 100000
[local_value] => 100000
[access] => 7
)
[pcre.recursion_limit] => Array
(
[global_value] => 100000
[local_value] => 100000
[access] => 7
)
)
Array
(
[allow_call_time_pass_reference] => Array
(
[global_value] => 0
[local_value] => 0
[access] => 6
)
[allow_url_fopen] => Array
(
[global_value] => 1
[local_value] => 1
[access] => 4
)
...
)
例2 details を無効にする例
<?php
print_r(ini_get_all("pcre", false)); // PHP 5.3.0 で追加されました
print_r(ini_get_all(null, false)); // PHP 5.3.0 で追加されました
?>
上の例の出力は、 たとえば以下のようになります。
Array
(
[pcre.backtrack_limit] => 100000
[pcre.recursion_limit] => 100000
)
Array
(
[allow_call_time_pass_reference] => 0
[allow_url_fopen] => 1
...
)
注意:
ini_get_all() は、"配列" 形式の ini オプション (pdo.dsn.* など) を無視します。
I guess the third entry is the required access level (to change this variable at runtime):
Constant Value Meaning
PHP_INI_USER 1 Entry can be set in user scripts
PHP_INI_PERDIR 2 Entry can be set in php.ini, .htaccess or httpd.conf
PHP_INI_SYSTEM 4 Entry can be set in php.ini or httpd.conf
PHP_INI_ALL 7 Entry can be set anywhere
See also the docs for ini_set()
Hugo.
If you want to load and parse your own ini file, have a look at parse_ini_file() function. Example:
<?php
// ...
$my_data = parse_ini_file($my_file, true);
echo recreate_php_ini();
/**
* Sample function to re-create a php ini config file.
*
* @return string
*/
function recreate_php_ini() {
$a = ini_get_all();
$data = [];
foreach (array_keys($a) as $k) {
$ss = split("\.", $k);
if (count($ss) == 1) {
$sec = "PHP";
$v = $k;
} else {
$sec = $ss[0];
$v = $ss[1];
}
$data[$sec][$v] = $a[$k]['global_value'];
}
ksort($data);
$out = "";
foreach ($data as $sec => $data) {
$out .= "[$sec]\n";
ksort($data);
foreach ($data as $k => $v) {
if (is_numeric($v)) {
$out .= sprintf("%-40s = %s\n", $k, $v);
} else {
$out .= sprintf("%-40s = \"%s\"\n", $k, $v);
}
}
$out .= "\n";
}
return $out;
}
You can use the following snippet on servers to grab the live/staging configs in order to be able to replicate those in your development environment. (I use `php -a` for this)
<?php
foreach (ini_get_all(null, false) as $key => $value) echo "$key=$value;\n";
?>
Since a certain PHP version (I think it's 5.2.5) it is no longer possible to override INI entrys set with php_admin_* in httpd.conf. The access level will be set to 4 (PHP_INI_SYSTEM), which is also returned by this function.
The constants mentioned below are available in PHP, but without the prefix (e.g. INI_USER, INI_PERDIR).
