(PHP 4, PHP 5)
ini_get — 獲取一個配置選項的值
說明
string ini_get ( string$varname
)
成功時返回配置選項的值。
參數
varname
配置選項名稱。
返回值
成功是返回配置選項值的字符串,null 的值則返回空字符串。如果配置選項不存在,將會返回 FALSE
。
范例
Example #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;
}
?>
以上例程的輸出類似于:
display_errors = 1 register_globals = 0 post_max_size = 8M post_max_size+1 = 9 post_max_size in bytes = 8388608
注釋
Note:
當查詢一個 boolean 值
一個 off 的 boolean ini 值將會以空字符串或者 "0" 返回;on 的 ini 值會以 "1" 返回。 此函數也會返回 INI 值的文字字符串。
Note:
當查詢一個內存尺寸的值
許多內存尺寸的 ini 值,類似 upload_max_filesize 是以簡寫表示法儲存在 php.ini 文件里。 ini_get() 會返回 php.ini 文件中儲存的確切字符串,而不是它的等量 integer。 嘗試對這些值使用常規算術運算函數將不會得到預期的結果。 以上例子顯示了轉換簡寫表示法為字節的一種方式,和 PHP 源碼所做的比較像。
更新日志
版本
說明
5.3.0
當配置項不存在,之前會返回空字符串,現在會返回 FALSE
。
參見
get_cfg_var() - 獲取 PHP 配置選項的值 ini_get_all() - 獲取所有配置選項 ini_restore() - 恢復配置選項的值 ini_set() - 為一個配置選項設置值