<commit_before><?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 15743 -->
<!-- Reviewed: no -->
<sect1 id="zend.loader.load">

    <title>Dynamisches Laden von Dateien und Klassen</title>

    <para>
        Die Zend_Loader Klasse enthält Methoden die helfen Dateien dynamisch zu laden.
    </para>

    <tip>
        <title>Zend_Loader vs. require_once()</title>
        <para>
            Die <classname>Zend_Loader</classname> Methoden werden am Besten verwendet wenn der
            Dateiname der Verwendet wird variabel ist. Wenn er zum Beispiel auf einem Parameter
            einer Benutzereinfabe oder eines Arguments einer Methode basiert. Wenn
            eine Datei oder eine Klasse geladen werden soll deren Name konstant ist,
            gibt es keinen Vorteil durch die Verwendung von <classname>Zend_Loader</classname>
            gegenüber traditionellen PHP Funktionen wie
            <ulink url="http://php.net/require_once"><code>require_once()</code></ulink>.
        </para>
    </tip>

    <sect2 id="zend.loader.load.file">

        <title>Dateien laden</title>

        <para>
            Die statische Methode <classname>Zend_Loader::loadFile()</classname> lädt eine
            PHP Datei. Die geladene Datei kann jeden PHP Code enthalten.
            Diese Methode ist ein Wrapper für die PHP Funktion
            <ulink url="http://php.net/include"><code>include()</code></ulink>.
            Diese Methode gibt bei einem Fehler ein boosches false zurück,
            zum Beispiel wenn die definierte Datei nicht existiert.
        </para>

        <example id="zend.loader.load.file.example">
            <title>Beispiel der loadFile() Methode</title>
            <programlisting language="php"><![CDATA[
Zend_Loader::loadFile($filename, $dirs=null, $once=false);
]]></programlisting>
    </example>

        <para>
            Das <code>$filename</code> Argument definert den Dateinamen der geladen
            werden soll, und der keine Verzeichnis Informationen enthalten darf.
            Eine Sicherheitsprüfung wird auf <code>$filename</code>
            durchgeführt. Das <code>$filename</code> Argument darf nur
            Alphanumerische Zeichen enthalten, Bindestriche ("-"), Unterstriche ("_")
            oder Punkte ("."). Das <code>$dirs</code> Argument hat keine dieser
            Einschränkungen.
        </para>

        <para>
            Das <code>$dirs</code> Argument definiert das Verzeichnis in welchem
            nach der Datei gesucht werden soll. Wenn der Wert <constant>NULL</constant> ist, wird
            nur anhand vom <code>include_path</code> gesucht. Wenn der Wert Zeichenkette
            oder ein Array ist, wird das definierte Verzeichnis oder
            die Verzeichnisse durchsucht, gefolgt vom <code>include_path</code>.
        </para>

        <para>
            Das <code>$once</code> Argument ist Boolean. Wenn es <constant>TRUE</constant>
            ist, verwendet <classname>Zend_Loader::loadFile()</classname> die PHP Funktion
            <ulink url="http://php.net/include"><code>include_once()</code></ulink>
            für das Laden der Datei, andernfalls wird die PHP Funktion
            <ulink url="http://php.net/include_once"><code>include()</code></ulink>
            verwendet.
        </para>

    </sect2>

    <sect2 id="zend.loader.load.class">

        <title>Klassen laden</title>

        <para>
            Die statische Methode <classname>Zend_Loader::loadClass($class, $dirs)</classname>
            lädt eine PHP Datei und prüft anschließend ob die Klasse existiert.
        </para>

        <example id="zend.loader.load.class.example">
            <title>Beispiel der loadClass() Methode</title>
            <programlisting language="php"><![CDATA[
Zend_Loader::loadClass('Container_Tree',
    array(
        '/home/production/mylib',
        '/home/production/myapp'
    )
);
]]></programlisting>
        </example>

        <para>
            Die Zeichenkette die die Klasse definiert, wird in einen relativen Pfad
            umgewandelt durch die Annahme das Verzeichnisse für das OS mit Unterstrichen
            getrennt werden und anfügen von '.php'. Im obigen Beispiel wird für Windows
            'Container_Tree' zu 'Container/Tree.php'.
        </para>

        <para>
            Wenn <code>$dirs</code> eine Zeichenkette oder ein Array ist, durchsucht
            <classname>Zend_Loader::loadClass()</classname> die Verzeichnisse in der
            angegebenen Reihenfolge. Die erste passende Datei wird geladen. Wenn die
            Datei in den definierten Verzeichnissen <code>$dirs</code> nicht existiert
            wird der <code>include_path</code> der PHP Umgebung durchsucht.
        </para>

        <para>
            Wenn die Datei nicht gefunden wird, oder die Klasse nach dem Laden nicht
            existiert, wirft <classname>Zend_Loader::loadClass()</classname> eine
            <classname>Zend_Exception</classname>.
        </para>

        <para>
            <classname>Zend_Loader::loadFile()</classname> wird für das Laden verwendet, deswegen
            darf der Klassenname nur Alphanumerische Zeichen, den Bindestrich ('-'),
            den Unterstrich ('_') und den Punkt ('.') enthalten.<commit_msg>[ZF-6138]Directory Separator of Windows<commit_after><?xml version="1.0" encoding="UTF-8"?>
<!-- EN-Revision: 16364 -->
<!-- Reviewed: no -->
<sect1 id="zend.loader.load">

    <title>Dynamisches Laden von Dateien und Klassen</title>

    <para>
        Die Zend_Loader Klasse enthält Methoden die helfen Dateien dynamisch zu laden.
    </para>

    <tip>
        <title>Zend_Loader vs. require_once()</title>
        <para>
            Die <classname>Zend_Loader</classname> Methoden werden am Besten verwendet wenn der
            Dateiname der Verwendet wird variabel ist. Wenn er zum Beispiel auf einem Parameter
            einer Benutzereinfabe oder eines Arguments einer Methode basiert. Wenn
            eine Datei oder eine Klasse geladen werden soll deren Name konstant ist,
            gibt es keinen Vorteil durch die Verwendung von <classname>Zend_Loader</classname>
            gegenüber traditionellen PHP Funktionen wie
            <ulink url="http://php.net/require_once"><code>require_once()</code></ulink>.
        </para>
    </tip>

    <sect2 id="zend.loader.load.file">

        <title>Dateien laden</title>

        <para>
            Die statische Methode <classname>Zend_Loader::loadFile()</classname> lädt eine
            PHP Datei. Die geladene Datei kann jeden PHP Code enthalten.
            Diese Methode ist ein Wrapper für die PHP Funktion
            <ulink url="http://php.net/include"><code>include()</code></ulink>.
            Diese Methode gibt bei einem Fehler ein boosches false zurück,
            zum Beispiel wenn die definierte Datei nicht existiert.
        </para>

        <example id="zend.loader.load.file.example">
            <title>Beispiel der loadFile() Methode</title>
            <programlisting language="php"><![CDATA[
Zend_Loader::loadFile($filename, $dirs=null, $once=false);
]]></programlisting>
    </example>

        <para>
            Das <code>$filename</code> Argument definert den Dateinamen der geladen
            werden soll, und der keine Verzeichnis Informationen enthalten darf.
            Eine Sicherheitsprüfung wird auf <code>$filename</code>
            durchgeführt. Das <code>$filename</code> Argument darf nur
            Alphanumerische Zeichen enthalten, Bindestriche ("-"), Unterstriche ("_")
            oder Punkte ("."). Das <code>$dirs</code> Argument hat keine dieser
            Einschränkungen.
        </para>

        <para>
            Das <code>$dirs</code> Argument definiert das Verzeichnis in welchem
            nach der Datei gesucht werden soll. Wenn der Wert <constant>NULL</constant> ist, wird
            nur anhand vom <code>include_path</code> gesucht. Wenn der Wert Zeichenkette
            oder ein Array ist, wird das definierte Verzeichnis oder
            die Verzeichnisse durchsucht, gefolgt vom <code>include_path</code>.
        </para>

        <para>
            Das <code>$once</code> Argument ist Boolean. Wenn es <constant>TRUE</constant>
            ist, verwendet <classname>Zend_Loader::loadFile()</classname> die PHP Funktion
            <ulink url="http://php.net/include"><code>include_once()</code></ulink>
            für das Laden der Datei, andernfalls wird die PHP Funktion
            <ulink url="http://php.net/include_once"><code>include()</code></ulink>
            verwendet.
        </para>

    </sect2>

    <sect2 id="zend.loader.load.class">

        <title>Klassen laden</title>

        <para>
            Die statische Methode <classname>Zend_Loader::loadClass($class, $dirs)</classname>
            lädt eine PHP Datei und prüft anschließend ob die Klasse existiert.
        </para>

        <example id="zend.loader.load.class.example">
            <title>Beispiel der loadClass() Methode</title>
            <programlisting language="php"><![CDATA[
Zend_Loader::loadClass('Container_Tree',
    array(
        '/home/production/mylib',
        '/home/production/myapp'
    )
);
]]></programlisting>
        </example>

        <para>
            Die Zeichenkette die die Klasse definiert, wird in einen relativen Pfad
            umgewandelt durch die Annahme das Verzeichnisse für das OS mit Unterstrichen
            getrennt werden und anfügen von '.php'. Im obigen Beispiel wird für Windows
            'Container_Tree' zu 'Container\\Tree.php'.
        </para>

        <para>
            Wenn <code>$dirs</code> eine Zeichenkette oder ein Array ist, durchsucht
            <classname>Zend_Loader::loadClass()</classname> die Verzeichnisse in der
            angegebenen Reihenfolge. Die erste passende Datei wird geladen. Wenn die
            Datei in den definierten Verzeichnissen <code>$dirs</code> nicht existiert
            wird der <code>include_path</code> der PHP Umgebung durchsucht.
        </para>

        <para>
            Wenn die Datei nicht gefunden wird, oder die Klasse nach dem Laden nicht
            existiert, wirft <classname>Zend_Loader::loadClass()</classname> eine
            <classname>Zend_Exception</classname>.
        </para>

        <para>
            <classname>Zend_Loader::loadFile()</classname> wird für das Laden verwendet, deswegen
            darf der Klassenname nur Alphanumerische Zeichen, den Bindestrich ('-'),
            den Unterstrich ('_') und den Punkt ('.') enthalten.
{'fraction_non_alphanumeric': 0.10352360148162218, 'fraction_numerical': 0.0026593218729224046, 'mean_word_length': 2.5170340681362724, 'pattern_counts': {'":': 0, '<': 227, '<?xml version=': 2, '>': 227, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '6340518', 'n_tokens_mistral': 3107, 'n_tokens_neox': 3090, 'n_words': 878}