使用parse_ini_file讀取配置文件的方法

一、概述

在PHP應用程序開發過程中，經常會用到配置文件來存儲一些常量、數據庫連接串、文件路徑等等內容，便於開發者快速修改配置信息。而PHP提供了parse_ini_file函數來解析INI格式的配置文件。

二、使用方法

parse_ini_file函數的用法非常簡單，只需要傳入要解析的INI配置文件路徑即可，返回一個關聯數組，數組的鍵名即為配置項名稱，數組的鍵值即為配置項值。下面是一個示例：

// config.ini文件內容如下：
;database configure
db_host = "localhost"
db_user = "root"
db_pass = "123456"
db_name = "test"

// PHP腳本代碼如下：
$config = parse_ini_file('config.ini');
var_dump($config);

解析後輸出的結果如下：

array(4) {
  ["db_host"]=>
  string(9) "localhost"
  ["db_user"]=>
  string(4) "root"
  ["db_pass"]=>
  string(6) "123456"
  ["db_name"]=>
  string(4) "test"
}

三、INI文件格式

INI文件是一種比較簡單規範的配置文件格式，其格式類似於Windows下的INI文件，在Linux下叫做conf文件，其基本格式如下：

;注釋
配置項名稱 = 配置項值

其中「;」號開頭的是注釋信息，解析時會自動忽略。

四、常用參數

parse_ini_file函數還可以接受一個可選的第二個參數，用於指定解析模式，常用模式有兩種：

• INI_SCANNER_NORMAL：默認模式，支持使用分號「;」進行注釋，不支持多行配置項。
• INI_SCANNER_RAW：原生模式，不會對配置項值進行任何處理，可以支持多行配置項。

示例代碼如下：

// a.ini文件內容如下：
[fruit]
name[] = "apple"
name[] = "banana"
name[] = "pear"
color.red = "紅色"
color.blue = "藍色"
color.green = "綠色"

// PHP腳本代碼如下：
$config1 = parse_ini_file('a.ini', true, INI_SCANNER_NORMAL);
$config2 = parse_ini_file('a.ini', true, INI_SCANNER_RAW);
var_dump($config1, $config2);

解析後輸出的結果如下：

array(1) {
  ["fruit"]=>
  array(1) {
    ["name[]"]=>
    string(5) "pear"
  }
}
array(1) {
  ["fruit"]=>
  array(3) {
    ["name[]"]=>
    array(3) {
      [0]=>
      string(5) "apple"
      [1]=>
      string(6) "banana"
      [2]=>
      string(4) "pear"
    }
    ["color.red"]=>
    string(6) "紅色"
    ["color.blue"]=>
    string(6) "藍色"
  }
}

五、注意事項

在使用parse_ini_file函數解析INI配置文件時，有以下注意點：

• 配置項的名稱和值不能包含分號「;」和等號「=」，否則會被解析為注釋或分隔符。
• 配置項的值如果是字符串，需要使用雙引號或單引號引起來。
• 配置項名稱不能重複，否則後面的配置會覆蓋前面的。
• 如果配置項值包含引號或特殊字符，可以使用反斜線「\」進行轉義。

六、總結

使用parse_ini_file函數可以很方便地解析INI配置文件，本文介紹了函數的使用方法、INI文件格式、常用參數和注意事項等內容。希望本文能夠幫助大家更好地應用parse_ini_file函數。