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