PHP parse_ini_file() 函数

PHP Filesystem Functions

定义和用法

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

PHP Filesystem Functions