<?xml version="1.0" encoding="utf-8"?>

<sect1 xml:id="function.include-once" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<title>include_once</title>

<?phpdoc print-version-for="include_once"?>

<para>

Der Ausdruck <literal>include_once</literal> bindet eine angegebene Datei ein

und führt sie als PHP-Skript aus.

Dieses Verhalten ähnelt dem des Ausdrucks <function>include</function>, mit

dem einzigen Unterschied, dass die Datei, wenn sie bereits eingebunden wurde,

nicht erneut eingebunden wird und include_once &true; zurückgibt. Wie der

Name schon sagt, wird die Datei nur einmal eingebunden.

</para>

<para>

<literal>include_once</literal> kann beispielsweise benutzt werden,

wenn die selbe Datei an mehreren Stellen eingebunden wird, um Problemen

durch erneute Definitionen von Funktionen, erneute Zuweisung

von Variablen oder ähnliches zu vermeiden.

</para>

<para>

Für die Funktionsweise der Funktion, siehe die Dokumentation zu

<function>include</function>.

</para>

</sect1>