(PHP 4, PHP 5, PHP 7, PHP 8)
ini_get — 獲取一個(gè)配置選項的值
$varname
): string成功時(shí)返回配置選項的值。
varname
配置選項名稱(chēng)。
成功是返回配置選項值的字符串,null
的值則返回空字符串。如果配置選項不存在,將會(huì )返回 false
。
示例 #1 一些 ini_get() 例子
<?php
/*
我們的 php.ini 包含了以下的設置:
display_errors = On
register_globals = Off
post_max_size = 8M
*/
echo 'display_errors = ' . ini_get('display_errors') . "\n";
echo 'register_globals = ' . ini_get('register_globals') . "\n";
echo 'post_max_size = ' . ini_get('post_max_size') . "\n";
echo 'post_max_size+1 = ' . (ini_get('post_max_size')+1) . "\n";
echo 'post_max_size in bytes = ' . return_bytes(ini_get('post_max_size'));
function return_bytes($val) {
$val = trim($val);
$last = strtolower($val[strlen($val)-1]);
switch($last) {
// 自 PHP 5.1.0 起可以使用修飾符 'G'
case 'g':
$val *= 1024;
case 'm':
$val *= 1024;
case 'k':
$val *= 1024;
}
return $val;
}
?>
以上例程的輸出類(lèi)似于:
display_errors = 1 register_globals = 0 post_max_size = 8M post_max_size+1 = 9 post_max_size in bytes = 8388608
注意: 當查詢(xún)一個(gè) boolean 值
一個(gè)
off
的 boolean ini 值將會(huì )以空字符串或者 "0" 返回;on
的 ini 值會(huì )以 "1" 返回。 此函數也會(huì )返回 INI 值的文字字符串。
注意: 當查詢(xún)一個(gè)內存尺寸的值
許多內存尺寸的 ini 值,類(lèi)似 upload_max_filesize 是以簡(jiǎn)寫(xiě)表示法儲存在 php.ini 文件里。 ini_get() 會(huì )返回 php.ini 文件中儲存的確切字符串,而不是它的等量 integer。 嘗試對這些值使用常規算術(shù)運算函數將不會(huì )得到預期的結果。 以上例子顯示了轉換簡(jiǎn)寫(xiě)表示法為字節的一種方式,和 PHP 源碼所做的比較像。
注意:
ini_get() 無(wú)法讀取 "array" 的 ini 選項,例如 pdo.dsn.*,在這個(gè)例子中會(huì )返回
false
。
版本 | 說(shuō)明 |
---|---|
5.3.0 |
當配置項不存在,之前會(huì )返回空字符串,現在會(huì )返回 false 。
|