PHP parse_ini_file() 函数

定义和用法

parse_ini_file() 函数解析一个配置文件，并以数组的形式返回其中的设置。

语法

  1. 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" 的内容：

  1. [names]
  2. me = Robert
  3. you = Peter
  4.  
  5. [urls]
  6. first = "http://www.example.com"
  7. second = "http://www.baidu.com"

PHP 代码：

  1. <?php
  2. print_r(parse_ini_file("test.ini"));
  3. ?>

输出：

  1. Array
  2. (
  3. [me] => Robert
  4. [you] => Peter
  5. [first] => http://www.example.com
  6. [second] => http://www.baidu.com
  7. )

例子 2

"test.ini" 的内容：

  1. [names]
  2. me = Robert
  3. you = Peter
  4.  
  5. [urls]
  6. first = "http://www.example.com"
  7. second = "http://www.baidu.com"

PHP 代码（process_sections 设置为 true）：

  1. <?php
  2. print_r(parse_ini_file("test.ini",true));
  3. ?>

输出：

  1. Array
  2. (
  3. [names] => Array
  4.   (
  5.   [me] => Robert
  6.   [you] => Peter
  7.   )
  8. [urls] => Array
  9.   (
  10.   [first] => http://www.example.com
  11.   [second] => http://www.baidu.com
  12.   )
  13. )