PHP parse_ini_file() 函數(shù)
定義和用法
parse_ini_file() 函數(shù)解析一個配置文件,并以數(shù)組的形式返回其中的設(shè)置。
語法
parse_ini_file(file,process_sections)
參數(shù) | 描述 |
---|---|
file | 必需。規(guī)定要檢查的 ini 文件。 |
process_sections | 可選。如果設(shè)置為 true,則返回一個多維數(shù)組,包括了配置文件中每一節(jié)的名稱和設(shè)置。默認(rèn)是 false。 |
說明
ini 文件的結(jié)構(gòu)和 php.ini 的相似。
常量也可以在 ini 文件中被解析,因此如果在運(yùn)行 parse_ini_file() 之前定義了常量作為 ini 的值,將會被集成到結(jié)果中去。只有 ini 的值會被求值。
由數(shù)字組成的鍵名和小節(jié)名會被 PHP 當(dāng)作整數(shù)來處理,因此以 0 開頭的數(shù)字會被當(dāng)作八進(jìn)制而以 0x 開頭的會被當(dāng)作十六進(jìn)制。
提示和注釋
注釋:本函數(shù)可以用來讀取你自己的應(yīng)用程序的配置文件。本函數(shù)與 php.ini 文件沒有關(guān)系,該文件在運(yùn)行腳本時就已經(jīng)處理過了。
注釋:如果 ini 文件中的值包含任何非字母數(shù)字的字符,需要將其括在雙引號中(")。
注釋:有些保留字不能作為 ini 文件中的鍵名,包括:null,yes,no,true 和 false。值為 null,no 和 false 等效于 "",值為 yes 和 true 等效于 "1"。字符 {}|"~![()" 也不能用在鍵名的任何地方,而且這些字符在選項(xiàng)值中有著特殊的意義。
注釋:自 PHP 5.0 版本開始,該函數(shù)也處理選項(xiàng)值內(nèi)的新行。
例子
例子 1
"test.ini" 的內(nèi)容:
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.dbjr.com.cn"
PHP 代碼:
<?php print_r(parse_ini_file("test.ini")); ?>
輸出:
Array ( [me] => Robert [you] => Peter [first] => http://www.example.com [second] => http://www.dbjr.com.cn)
例子 2
"test.ini" 的內(nèi)容:
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.dbjr.com.cn"
PHP 代碼(process_sections 設(shè)置為 true):
<?php print_r(parse_ini_file("test.ini",true)); ?>
輸出:
Array ( [names] => Array ( [me] => Robert [you] => Peter ) [urls] => Array ( [first] => http://www.example.com [second] => http://www.dbjr.com.cn ) )