parse_ini_fileParse a configuration file
&reftitle.description;
arrayparse_ini_filestringfilenameboolprocess_sectionsparse_ini_file loads in the
ini file specified in filename,
and returns the settings in it in an associative array.
The structure of the ini file is the same as the &php.ini;'s.
&reftitle.parameters;
filename
The filename of the ini file being parsed.
process_sections
By setting the last process_sections
parameter to &true;, you get a multidimensional array, with
the section names and settings included. The default
for process_sections is &false;
&reftitle.returnvalues;
The settings are returned as an associative array.
&reftitle.changelog;
&Version;&Description;5.2.4
Keys and section names consisting of numbers are now evaluated as PHP
integers thus numbers
starting by 0 are evaluated as octals and numbers starting by 0x are
evaluated as hexadecimals.
5.0.0
Values enclosed in double quotes can contain new lines.
4.2.1
This function is now affected by &safemode;
and open_basedir.
&reftitle.examples;
Contents of <filename>sample.ini</filename><function>parse_ini_file</function> example
Constants may also be parsed
in the ini file so if you define a constant as an ini value before
running parse_ini_file, it will be integrated into
the results. Only ini values are evaluated. For example:
]]>
&example.outputs.similar;
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
)
)
]]>
&reftitle.notes;
This function has nothing to do with the
&php.ini; file. It is already processed,
the time you run your script. This function can be used to
read in your own application's configuration files.
If a value in the ini file contains any non-alphanumeric
characters it needs to be enclosed in double-quotes (").
There are reserved words which must not be used as keys for
ini files. These include: null, yes, no, true, and false.
Values null, no and false results in "", yes and true results in "1".
Characters {}|&~![()" must not be used anywhere in
the key and have a special meaning in the value.