1
0
mirror of https://github.com/php/doc-de.git synced 2026-03-23 23:02:13 +01:00
Files
archived-doc-de/reference/filesystem/functions/parse-ini-string.xml
Volker Dusch 880501f581 Sync reference/filesystem/functions with EN (#210)
- Fix build failure in fgetcsv.xml
- Sync all currently open reference/filesystem/functions changes
2026-02-02 17:56:39 +00:00

124 lines
4.4 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: bb54309eff8a7d75ead0fdf48cc6dae99dd00367 Maintainer: tihox Status: ready -->
<refentry xml:id="function.parse-ini-string" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>parse_ini_string</refname>
<refpurpose>Analysiert einen Konfigurations-String</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type class="union"><type>array</type><type>false</type></type><methodname>parse_ini_string</methodname>
<methodparam><type>string</type><parameter>ini_string</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>process_sections</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>int</type><parameter>scanner_mode</parameter><initializer><constant>INI_SCANNER_NORMAL</constant></initializer></methodparam>
</methodsynopsis>
<para>
<function>parse_ini_string</function> Gibt die Konfiguration aus dem String
<parameter>ini_string</parameter> in einem assoziativen Array zurück.
</para>
<para>
Die Struktur des ini-Strings ist die selbe wie die der &php.ini;
</para>
<warning>
<simpara>
Diese Funktion darf nicht mit unvertrauenswürdigen Eingaben verwendet werden,
es sei denn, <parameter>scanner_mode</parameter> ist <constant>INI_SCANNER_RAW</constant>,
da die geparste Ausgabe Werte von sensiblen Konstanten enthalten könnte,
wie beispielsweise Konstanten, die ein Datenbank-Passwort enthalten.
</simpara>
</warning>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>ini_string</parameter></term>
<listitem>
<para>
Der Inhalt der ini-Datei die analysiert wird.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>process_sections</parameter></term>
<listitem>
<para>
Ist der Parameter <parameter>process_sections</parameter>
als &true; gesetzt, werden Sie ein mehrdimensionales Array zurückbekommen, welches die Abschnitte und Einstellungen enthält.
Die Standardeinstellung <parameter>process_sections</parameter> ist &false;
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>scanner_mode</parameter></term>
<listitem>
<para>
Kann entweder <constant>INI_SCANNER_NORMAL</constant> (normal) oder
<constant>INI_SCANNER_RAW</constant> sein. Wenn <constant>INI_SCANNER_RAW</constant>
angegeben ist, werden optionale Inhalte nicht analysiert.
</para>
&ini.scanner.typed;
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Die Einstellungen werden als assoziatives <type>Array</type> bei Erfolg,
und &false; bei einem Fehler zurückgegeben..
</para>
</refsect1>
<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
Es gibt reservierte Wörter die nicht als Keys für die ini-Dateien benutzt
werden dürfen. Dies schließt <literal>null</literal>, <literal>yes</literal>, <literal>no</literal>, <literal>true</literal>, <literal>false</literal>, <literal>on</literal>, <literal>off</literal> und <literal>none</literal> ein.
Die Werte <literal>null</literal>, <literal>off</literal>, <literal>no</literal> und <literal>false</literal> geben <literal>""</literal> zurück, und die Werte <literal>on</literal>, <literal>yes</literal> und <literal>true</literal> <literal>"1"</literal>,
es sei denn der <constant>INI_SCANNER_TYPED</constant>-Modus wird verwendet.
Die Buchstaben <literal>?{}|&amp;~![()^"</literal> dürfen nirgendwo inm Key benutzt
werden und haben eine spezielle Bedeutung.
</simpara>
</note>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>parse_ini_file</function></member>
</simplelist>
</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:"~/.phpdoc/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
-->