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