php-doc-ru/reference/filesystem/functions/parse-ini-file.xml

<?xml version="1.0" encoding="windows-1251"?>
<!-- EN-Revision: 1.17 Maintainer: freespace Status: ready -->
<!-- $Revision: 1.1 $ -->
<!-- splitted from ./en/functions/filesystem.xml, last change in rev 1.87 -->
  <refentry id="function.parse-ini-file">
   <refnamediv>
    <refname>parse_ini_file</refname>
    <refpurpose>Обрабатывает конфигурационный файл</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Описание</title>
     <methodsynopsis>
      <type>array</type><methodname>parse_ini_file</methodname>
      <methodparam><type>string</type><parameter>filename</parameter></methodparam>
      <methodparam choice="opt"><type>bool</type><parameter>process_sections</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>parse_ini_file</function> загружает
     ini-файл, указанный в аргументе <parameter>filename</parameter>,
     и возвращает его настройки в виде ассоциативного массива.
     Установив последний аргумент <parameter>process_sections</parameter>
     в &true;, вы получаете многомерный массив, который включает как название
     отдельных настроек, так и секции. По умолчанию
     <parameter>process_sections</parameter> равен &false;
    </para>
    <note>
     <para>
      Эта функция не имеет никакого отношения к файлу &php.ini;.
      К моменту выполнения вашего скрипта, он уже обработан.
      Эта функция может быть использована для загрузки настроек
      вашего собственного приложения.
     </para>
    </note>
    <note>
     <para>
      Если значение в ini-файле содержит прочие символы, кроме букв и цифр,
      оно должно заключаться в двойные кавычки (").
     </para>
    </note>
    <note>
     <simpara>
      Начиная с версии PHP 4.2.1, на поведение этой функции влияет &safemode; и
      <link linkend="ini.open-basedir">open_basedir</link>.
     </simpara>
    </note>
    <note>
     <simpara>
      Существует зарезервированные слова, которые вы не можете использовать
      в качестве ключей в ini-файлах. Такими словами являются следующие:
      null, yes, no, true и false.
     </simpara>
    </note>
    <para>
     Структура ini-файла похожа на структуру &php.ini;.
    </para>
    <para>
     <link linkend="language.constants">Константы</link> также могут быть
     обработаны в ini-файле, так что если вы объявите константу в виде значения
     для ini-файла до вызова <function>parse_ini_file</function>, она (константа)
     будет правильно обработана. Таким образом обрабатываются только значения.
     Например:
    </para>
    <para>
     <example>
      <title>Содержимое <filename>sample.ini</filename></title>
      <programlisting>
<![CDATA[
; Это пример файла настроек
; Комментарии начинаются с ';', как в php.ini

[first_section]
one = 1
five = 5
animal = BIRD

[second_section]
path = /usr/local/bin
URL = "http://www.example.com/~username"
]]>
      </programlisting>
     </example>
    </para>
    <para>
     <example>
      <title>Пример использования функции <function>parse_ini_file</function></title>
      <programlisting role="php">
<![CDATA[
<?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);

?>
]]>
      </programlisting>
      <para>
       Результат:
      </para>
      <screen>
<![CDATA[
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
        )

)
]]>
      </screen>
     </example>
    </para>
    <para>
     Ключи и имена секций, состоящие из цифр, будут обработаны как
     <link linkend="language.types.integer">целые числа</link> в PHP,
     поэтому числа, начинающиеся с 0 будут считаться восьмиричными,
     а начинающиеся с 0x - шестнадцатиричными.
    </para>
   </refsect1>
  </refentry>

<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->