Funkcja PHP parse_ini_file()
Definicja i użycie
Funkcja parse_ini_file() analizuje plik konfiguracyjny i zwraca jego ustawienia w formie tablicy.
Gramatyka
parse_ini_file(file,process_sections)
| Parametry | Opis |
|---|---|
| file | Wymagane. Określa plik ini do sprawdzenia. |
| process_sections | Opcjonalne. Jeśli ustawione na true, zwraca wielowymiarowy tablicę, która zawiera nazwy sekcji i ustawienia z pliku konfiguracyjnego. Domyślnie jest false. |
Wyjaśnienie
Struktura pliku ini jest podobna do php.ini.
Stałe mogą być również przetwarzane w pliku ini, więc jeśli stałe są zdefiniowane jako wartości ini przed uruchomieniem parse_ini_file(), będą one włączone do wyniku. Tylko wartości ini są obliczane.
Imiona kluczy i sekcji złożone z cyfr są traktowane jako liczby całkowite przez PHP, więc liczby zaczynające się od 0 są traktowane jako ósemkowe, a zaczynające się od 0x jako szesnastkowe.
Wskazówki i komentarze
Komentarz:Ta funkcja może być używana do odczytywania pliku konfiguracyjnego swojego aplikacji. Funkcja ta nie ma związku z plikiem php.ini, który jest już przetworzony podczas uruchamiania skryptu.
Komentarz:Jeśli wartość w pliku ini zawiera jakiekolwiek znaki inne niż alfanumeryczne, należy je otoczyć znakami cudzysłowymi (").
Komentarz:Niektóre zarezerwowane słowa nie mogą być używane jako nazwy kluczy w plikach ini, w tym: null, yes, no, true i false. Wartości null, no i false są równoważne "", a wartości yes i true są równoważne "1". Znakami {}|"~![()" nie można używać w żadnej części nazwy klucza, a te znaki mają specjalne znaczenie w wartościach opcji.
Komentarz:Od wersji PHP 5.0, funkcja ta obsługuje również nowe wiersze w wartościach opcji.
Przykład
Przykład 1
Zawartość pliku "test.ini":
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Kod PHP:
<?php
print_r(parse_ini_file("test.ini"));
?>
Wyjście:
Tablica ( [me] => Robert [you] => Peter [first] => http://www.example.com [second] => http://www.codew3c.com )
Przykład 2
Zawartość pliku "test.ini":
[names] me = Robert you = Peter [urls] first = "http://www.example.com" second = "http://www.codew3c.com"
Kod PHP (process_sections Ustawione na true):
<?php
print_r(parse_ini_file("test.ini",true));
?>
Wyjście:
Tablica ( [names] => Tablica ( [me] => Robert [you] => Peter ) [urls] => Tablica ( [first] => http://www.example.com [second] => http://www.codew3c.com ) )
