ini_get

(PHP 4, PHP 5, PHP 7, PHP 8)

ini_get — 獲取一個(gè)配置選項(xiàng)的值

說明

ini_get(string $varname): string

成功時(shí)返回配置選項(xiàng)的值。

參數(shù)

varname

配置選項(xiàng)名稱。

返回值

成功是返回配置選項(xiàng)值的字符串，null 的值則返回空字符串。如果配置選項(xiàng)不存在，將會(huì)返回 false。

范例

示例 #1 一些 ini_get() 例子

<?php
/*
我們的 php.ini 包含了以下的設(shè)置：

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

注釋

注意: 當(dāng)查詢一個(gè) boolean 值

一個(gè) off 的 boolean ini 值將會(huì)以空字符串或者 "0" 返回；on 的 ini 值會(huì)以 "1" 返回。 此函數(shù)也會(huì)返回 INI 值的文字字符串。

注意: 當(dāng)查詢一個(gè)內(nèi)存尺寸的值

許多內(nèi)存尺寸的 ini 值，類似 upload_max_filesize 是以簡寫表示法儲(chǔ)存在 php.ini 文件里。 ini_get() 會(huì)返回 php.ini 文件中儲(chǔ)存的確切字符串，而不是它的等量 integer。 嘗試對(duì)這些值使用常規(guī)算術(shù)運(yùn)算函數(shù)將不會(huì)得到預(yù)期的結(jié)果。 以上例子顯示了轉(zhuǎn)換簡寫表示法為字節(jié)的一種方式，和 PHP 源碼所做的比較像。

注意:

ini_get() 無法讀取 "array" 的 ini 選項(xiàng)，例如 pdo.dsn.*，在這個(gè)例子中會(huì)返回 false 。

更新日志

版本 說明
5.3.0 當(dāng)配置項(xiàng)不存在，之前會(huì)返回空字符串，現(xiàn)在會(huì)返回 false。

參見