(PHP 4, PHP 5)
parse_ini_file — Parse a configuration file
parse_ini_file() зарежда ini файл посочен чрез filename и връща настройките в него като асоциативен масив.
Структурата на ini файла трябва да е същата като на php.ini.
Името на ini файла, който ще бъде парснат.
Чрез подаване на TRUE на process_sections функцията ще върне многомерен масив, съдържащ имената на секциите и настройките. По подразбиране process_sections е FALSE.
При успех - връща настройките като асоциативен масив; при неуспех връща FALSE
Версия | Описание |
---|---|
5.2.7 | Ако открие ситнтактична грешка ще върне FALSE вместо празен масив. array |
5.2.4 | Ключовете и имената на секциите, които са съставени от числа ще бъдат оценени като PHP цели числа, т.е. числата, започващи с 0 ще бъдат оценени като осмични стойности и номерата, започващо с 0x ще бъдат оценени като шестнайсетични. |
5.0.0 | Стойностите заградени с двойни кавички могат да съдържат нови редове. |
4.2.1 | От PHP 4.2.1 тази функция взима под внимание ограниченията на защитен режим и open_basedir. |
Example #1 Съдържанието на sample.ini
; Това е примерен конфигурационен файл ; Коментарите започват с ;', както в php.ini [first_section] one = 1 five = 5 animal = BIRD [second_section] path = "/usr/local/bin" URL = "http://www.example.com/~username"
Example #2 parse_ini_file() пример
Константите също може да се парсват в ini файл ако сте ги дефинирали преди да се използвате parse_ini_file(). По този начин техните стойности ще присъстват в резултите. Само ini стойностите ще бъдат оценявани за съвпадение с имената на константите. Например:
<?php
define('BIRD', 'Dodo bird');
// Парсване без секции
$ini_array = parse_ini_file("sample.ini");
print_r($ini_array);
// Парсване със секции
$ini_array = parse_ini_file("sample.ini", true);
print_r($ini_array);
?>
Примерът по-горе ще изведе нещо подобно на:
Array ( [one] => 1 [five] => 5 [animal] => Dodo bird [path] => /usr/local/bin [URL] => http://www.example.com/~username ) Array ( [first_section] => Array ( [one] => 1 [five] => 5 [animal] = Dodo bird ) [second_section] => Array ( [path] => /usr/local/bin [URL] => http://www.example.com/~username ) )
Забележка: Тази функция няма нищо общо с файла php.ini, който е вече е обработен преди да е старитиран текущия скрипт. Тази функция е предназначена да зарежда конфигурационните файлове на вашето собствено приложение.
Забележка: Ако някоя стойност в ini файла съдържа символи, които не са букви или числа - то трябва стойността да е оградена с кавички.
Забележка: Има запазени думи, които трябва да не бъдат използвани като ключове в ini файловете. Те са: null, yes, no, true, и false. Стойностите null, no и false се превръщат в "", yes и true в "1". Символите {}|&~![()" не трябва да бъдат използвани в ключовете и имат специално значение в стойностите.