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
  )
)