PHP parse_ini_file 文件系统函数

• 

  定义和用法

  parse_ini_file - 解析一个配置文件
• 

  版本支持

  PHP4	PHP5	PHP7
  支持	支持	支持

• 

  语法

  parse_ini_file ( string $filename [, bool $process_sections = false [, int $scanner_mode = INI_SCANNER_NORMAL ]] )   
  

  parse_ini_file() 载入一个由 filename 指定的 ini 文件，并将其中的设置作为一个联合数组返回。 ini 文件的结构和 php.ini 的相似。
• 

  参数

  参数	必需的	描述
  filename	是	要解析的 ini 文件的文件名。
  process_sections	否	如果将最后的 process_sections 参数设为 TRUE，将得到一个多维数组，包括了配置文件中每一节的名称和设置。process_sections 的默认值是 FALSE。
  scanner_mode	否	可以是 INI_SCANNER_NORMAL（默认）或 INI_SCANNER_RAW。 如果提供了 INI_SCANNER_RAW ，则不会解析选项值。

• 

  返回值

  成功时以关联数组返回设置，失败时返回 FALSE。
• 

  示例

  假如有以下配置文件：

  ; This is a sample configuration file
  ; Comments start with ';', as in php.ini
  
  [first_section]
  one = 1
  five = 5
  animal = BIRD
  
  [second_section]
  path = "/usr/local/bin"
  URL = "http://www.example.com/~username"
  
  [third_section]
  phpversion[] = "5.0"
  phpversion[] = "5.1"
  phpversion[] = "5.2"
  phpversion[] = "5.3"
  

  现在我们可以把这个文件解析到PHP数组：

  <?php
  // 不解析小节
  $ini_array = parse_ini_file("sample.ini");
  print_r($ini_array);
  
  echo '<br/>';
  // 解析小节
  $ini_array = parse_ini_file("sample.ini", true);
  print_r($ini_array);
  ?>
  

  尝试一下

  注意: 本函数和 php.ini 文件没有关系，该文件在运行脚本时就已经处理过了。本函数可以用来读取你自己的应用程序的配置文件。

  注意: 如果 ini 文件中的值包含任何非字母数字的字符，需要将其括在双引号中（"）。

  注意: 有些保留字不能作为 ini 文件中的键名，包括：null，yes，no，true 和 false。值为 null，no 和 false 等效于 ""，值为 yes 和 true 等效于 "1"。字符 {}|&~![()" 也不能用在键名的任何地方，而且这些字符在选项值中有着特殊的意义。

• 

  相关函数

  parse_ini_string() - 解析配置字符串