language-snippets.ent

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 6b53a028fb43eb697c961c81053543fc51bc9028 Maintainer: simp Status: ready -->
<!-- CREDITS: sammywg, mk, betz -->

<!ENTITY installation.enabled.disable 'Diese Erweiterung ist standardmäßig aktiviert. Sie kann bei der Kompilierung mit der folgenden Option ausgeschaltet werden: '>

<!-- Not used in EN anymore -->
<!ENTITY changelog.randomseed '<row xmlns="http://docbook.org/ns/docbook"><entry>4.2.0</entry><entry>Der
Zufallszahlengenerator wird automatisch initialisiert.</entry></row>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
weiteren Verwendung wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-6-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
weiteren Verwendung wird dringend abgeraten.</simpara></warning>'>

<!-- Cautions -->
<!ENTITY caution.cryptographically-insecure '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Diese Funktion erzeugt keine kryptografisch sicheren Werte und
  <emphasis>darf nicht</emphasis> für kryptografische Zwecke verwendet werden
  oder für Zwecke, bei denen die zurückgegebenen Werte nicht abschätzbar sein
  dürfen.
 </para>
 <para>
  Falls kryptographisch sichere Zufallszahlen benötigt werden, kann der
  <classname>Random\Randomizer</classname> mit der
  <classname>Random\Engine\Secure</classname>-Engine verwendet werden. Für
  einfache Anwendungsfälle bieten die Funktionen <function>random_int</function>
  und <function>random_bytes</function> eine bequeme und sichere
  <acronym>API</acronym>, die den <acronym>CSPRNG</acronym> des
  Betriebssystems verwendet.
 </para>
</caution>'>

<!ENTITY caution.mt19937-tiny-seed '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Da die Mt19937- ("Mersenne Twister") Engine nur einen einzigen 32-Bit-Integer als Seed akzeptiert,
  ist die Anzahl der möglichen Zufallsfolgen trotz der riesigen Periode von 2<superscript>19937</superscript>-1
  auf nur 2<superscript>32</superscript> (&dh; 4.294.967.296) begrenzt.
 </para>
 <para>
  Wenn man sich auf implizites oder explizites zufälliges Seeding verlässt, treten
  Duplikate viel früher auf. Nach dem Geburtstagsproblem werden doppelte Seeds mit einer
  Wahrscheinlichkeit von 50&#37; nach weniger als 80.000 zufällig erzeugten Seeds
  erwartet. Nach etwa 30.000 zufällig erzeugten Seeds tritt ein doppeltes Seed mit
  einer Wahrscheinlichkeit von 10&#37; auf.
 </para>
 <para>
  Daher ist Mt19937 nicht für Anwendungen geeignet, bei denen doppelte Sequenzen nur mit vernachlässigbarer
  Wahrscheinlichkeit auftreten dürfen. Wenn reproduzierbares Seeding erforderlich ist,
  unterstützen sowohl <classname>Random\Engine\Xoshiro256StarStar</classname> als auch
  <classname>Random\Engine\PcgOneseq128XslRr64</classname> wesentlich größere Seeds, bei denen eine
  zufällige Kollision unwahrscheinlich ist. Wenn keine Reproduzierbarkeit erforderlich ist, bietet die
  Engine <classname>Random\Engine\Secure</classname> eine kryptografisch sichere Zufallsverteilung.
 </para>
</caution>'>

<!-- Notes -->

<!ENTITY note.bin-safe '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
binärsicher.</simpara></note>'>

<!ENTITY note.clearstatcache '<note xmlns="http://docbook.org/ns/docbook"><simpara>Die Ergebnisse dieser Funktion
werden zwischengespeichert. Weitere Details sind bei
<function>clearstatcache</function> zu finden.</simpara></note>'>

<!ENTITY note.context-support '<para xmlns="http://docbook.org/ns/docbook">Eine <link linkend="stream.contexts">Stream-Kontext</link>-<type>&resource;</type>.</para>'>

<!ENTITY note.exec-bg '<note xmlns="http://docbook.org/ns/docbook"><para>Wenn ein Programm mit dieser Funktion
gestartet wird und im Hintergrund weiterlaufen soll, muss die Ausgabe des Programms
in eine Datei oder einen anderen Ausgabestrom umgeleitet werden. Anderenfalls bleibt
PHP solange hängen, bis das Programm zu Ende ausgeführt wurde.</para></note>'>

<!ENTITY note.exec-bypass-shell '<note xmlns="http://docbook.org/ns/docbook"><para>Unter Windows startet <function>exec</function> zunächst
cmd.exe um das Kommande auszuführen. Um ein externes Programm auszuführen ohne zuvor cmd.exe zu starten, sollte
<function>proc_open</function> mit der Option <parameter>bypass_shell</parameter> verwendet werden.</para></note>'>

<!ENTITY note.extractto-windows '<note xmlns="http://docbook.org/ns/docbook"><para>Windows NTFS-Dateisysteme
unterstützen einige Zeichen in Dateinamen nicht, nämlich <literal>&lt;|&gt;*?":</literal>. Dateinamen mit einem Punkt am Ende
werden ebenfalls nicht unterstützt. Im Gegensatz zu einigen Extraktionswerkzeugen ersetzt diese Methode diese Zeichen nicht durch
einen Unterstrich, sondern extrahiert solche Dateien nicht.</para></note>'>

<!ENTITY note.func-callback '<note xmlns="http://docbook.org/ns/docbook"><simpara>Anstelle eines Funktionsnamens
kann auch ein Array mit einer Objekt-Referenz und dem Namen einer Methode
angegeben werden.</simpara></note>'>

<!ENTITY note.func-callback-exceptions '<note xmlns="http://docbook.org/ns/docbook"><para>Callbacks, die für
Funktionen wie <function>call_user_func</function> und <function>call_user_func_array</function> registriert
sind, werden nicht mehr ausgeführt, wenn in einem vorherigen Callback eine Exception geworfen und nicht gefangen
wurde.</para></note>'>

<!ENTITY note.funcbyref '<note xmlns="http://docbook.org/ns/docbook"><para>Wenn die Parameter
als Referenzen übergeben werden, so finden sich alle Änderungen an diesen Parametern in
den Rückgabewerten dieser Funktion wieder.</para></note>'>

<!ENTITY note.funcnoparam '<note xmlns="http://docbook.org/ns/docbook"><para>Da diese Funktion bei der Ermittlung der
Parameterdetails von dem aktuellen Ausführungskontext abhängt, kann sie in PHP-Versionen vor 5.3.0
selbst nicht als Funktionsparameter genutzt werden. Wenn Sie ihre Ergebnisse tatsächlich weitergeben
müssen, so müssen Sie diese zunächst einer Variablen zuweisen und dann diese Variable übergeben</para></note>'>

<!ENTITY note.func-named-params '<note xmlns="http://docbook.org/ns/docbook"><para>Seit PHP 8.0.0 sollte die func_*()-Familie von
Funktionen in Bezug auf benannte Parameter weitgehend transparent sein, indem
die Parameter so behandelt werden, als wären sie alle an der richtigen Stelle
übergeben worden und fehlende Parameter durch ihre Standardwerte ersetzt.
Diese Funktion ignoriert die Erfassung unbekannter benannter variadischer
Parameter. Auf unbekannte benannte Parameter, die erfasst werden, kann nur
über den variadischen Parameter zugegriffen werden.</para></note>'>

<!ENTITY note.line-endings '<note xmlns="http://docbook.org/ns/docbook"><simpara>Wenn PHP Zeilenendezeichen
nicht richtig erkennt, entweder beim Lesen von Dateien auf einem Macintosh oder
bei Dateien, die auf einem Macintosh erstellt wurden, kann die Option
<link xmlns="http://docbook.org/ns/docbook" linkend="ini.auto-detect-line-endings">auto_detect_line_endings</link>
aktiviert werden.</simpara></note>'>

<!ENTITY note.no-remote '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion kann nicht mit
<link linkend="features.remote-files">entfernten Dateien</link> arbeiten, da
der Zugriff auf die Datei, die bearbeitet werden soll, über das Dateisystem des
Servers möglich sein muss.</simpara></note>'>

<!ENTITY note.not-bin-safe '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist (bis jetzt)
nicht binärsicher!</simpara></warning>'>

<!ENTITY note.no-key-association '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion weist den
Elementen des Arrays <parameter>array</parameter> neue Schlüssel zu.
Bestehende Schlüssel, die bereits zugewiesen wurden, werden entfernt
statt einfach nur die Schlüssel neu anzuordnen</simpara></note>'>

<!ENTITY note.no-windows '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist auf
Windows-Plattformen nicht verfügbar.</simpara></note>'>

<!ENTITY note.no-windows.extension '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Erweiterung steht auf
Windows-Plattformen nicht zur Verfügung.</simpara></note>'>

<!ENTITY note.no-zts '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist in PHP-Interpretern,
die mit ZTS (Zend Thread Safety) kompiliert wurden, nicht verfügbar. Ob das verwendete PHP mit ZTS kompiliert wurde, kann durch Aufruf von
<command>php -i</command>, oder unter Verwendung der eingebauten Konstante <constant>PHP_ZTS</constant> geprüft werden.</simpara></note>'>

<!ENTITY note.randomseed '<note xmlns="http://docbook.org/ns/docbook"><simpara>Es besteht keine
Notwendigkeit, den Zufallsgenerator für Zahlen mit
<function>srand</function> oder <function>mt_srand</function> zu füttern, das
geschieht automatisch.</simpara></note>'>

<!ENTITY note.is-superglobal "<note xmlns='http://docbook.org/ns/docbook'><para>Dies ist eine 'Superglobale'
oder automatisch globale Variable. Dies bedeutet, dass sie innerhalb
des Skripts in jedem Geltungsbereich sichtbar ist. Es ist nicht
nötig, sie mit <command>global $variable</command> bekannt zu
machen, um aus Funktionen oder Methoden darauf zuzugreifen.</para>
</note>">

<!ENTITY note.uses-ob '<note xmlns="http://docbook.org/ns/docbook"><para>Wenn der Parameter <parameter>return</parameter>
verwendet wird, benutzt diese Funktion die interne Ausgabepufferung und kann daher
nicht in einer <function>ob_start</function>-Callbackfunktion eingesetzt werden.</para></note>'>

<!ENTITY note.uses-ob-php70 '<note xmlns="http://docbook.org/ns/docbook"><para>
Wenn der Parameter <parameter>return</parameter> verwendet wird, verwendet diese
Funktion vor PHP 7.1.0 die interne Ausgabepufferung und kann daher nicht innerhalb
einer <function>ob_start</function>-Callbackfunktion verwendet werden.
</para></note>'>

<!ENTITY note.filesystem-time-res '<note xmlns="http://docbook.org/ns/docbook"><para>Beachten Sie, dass die zeitliche
Auflösung bei verschiedenen Dateisystemen unterschiedlich sein kann.</para></note>'>

<!ENTITY note.uses-autoload '<note xmlns="http://docbook.org/ns/docbook">
<para>Ein Aufruf dieser Funktion verwendet alle registrierten
<link linkend="language.oop5.autoload">Autoloader</link>, falls die Klasse
nicht bereits bekannt ist.</para></note>'>

<!ENTITY note.network.header.sapi '<note xmlns="http://docbook.org/ns/docbook">
   <para>
    Header sind nur dann zugänglich und werden nur dann gesendet,
    wenn die genutzte SAPI sie unterstützt.
   </para>
  </note>
'>

<!ENTITY note.sigchild '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Falls PHP mit der Option --enable-sigchild kompiliert wurde, ist die Rückgabe dieser Funktion nicht definiert.
 </para>
</note>
'>

<!ENTITY note.sort-unstable '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Wenn zwei Mitglieder als identisch verglichen werden, behalten sie ihre
  ursprüngliche Reihenfolge bei.
  Vor PHP 8.0.0 war die relative Sortierung im sortierten Array nicht definiert.
 </para>
</note>
'>

<!ENTITY note.reset-index "<note xmlns='http://docbook.org/ns/docbook'>
 <para>
  Setzt den internen Zeiger des Arrays auf das erste Element zurück.
 </para>
</note>
">

<!ENTITY note.resource-migration-8.0-dead-function '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Diese Funktion hat keine Auswirkung. Vor PHP 8.0.0 wurde sie verwendet, um die Ressource zu schließen.
 </para>
</note>
'>

<!-- Tips -->

<!ENTITY tip.fopen-wrapper '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Wenn
<link linkend="ini.allow-url-fopen">fopen wrappers</link> aktiviert ist, kann
mit dieser Funktion eine URL als Dateiname verwendet werden. Mehr Details dazu,
wie der Dateiname angeben werden muss, sind bei <function>fopen</function> zu
finden. Eine Liste der unterstützten URL-Protokolle, die Fähigkeiten der
verschiedenen Wrapper, Hinweise zu deren Verwendung und Informationen zu den
eventuell vorhandenen vordefinierten Variablen sind unter
<xref linkend="wrappers"/> zu finden.</simpara></tip>'>

<!ENTITY tip.fopen-wrapper.stat '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Seit PHP 5.0.0 kann diese
Funktion mit <emphasis>einigen</emphasis> URL-Wrappern benutzt werden. Schauen
Sie in der Liste unter <xref linkend="wrappers"/> nach, welcher Wrapper die
Funktionalität von <function>stat</function> unterstützt.</simpara></tip>'>

<!ENTITY tip.ob-capture '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Bei allem, dessen Ergebnisausgabe direkt
im Browser angezeigt wird, können Sie die
<link linkend="book.outcontrol">Funktionen zur Ausgabesteuerung</link> verwenden.
Damit lässt sich die Ausgabe dieser Funktion erfassen, und - zum Beispiel -
in einem <type>string</type> speichern.</simpara></tip>'>

<!ENTITY tip.userlandnaming '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Siehe auch <xref linkend="userlandnaming"
/>.</simpara></tip>'>

<!-- Warnings -->

<!ENTITY warn.escapeshell '<warning xmlns="http://docbook.org/ns/docbook"><para>Falls Sie es erlauben, dass Daten von
Usereingaben an diese Funktion weitergereicht werden, sollten Sie
<function>escapeshellarg</function> oder <function>escapeshellcmd</function>
verwenden. Bei Verwendung dieser Funktionen stellen Sie sicher, dass kein
Benutzer Ihr System überlisten kann, beliebige Kommandos auszuführen</para></warning>'>

<!ENTITY warn.experimental '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Erweiterung ist
<emphasis>EXPERIMENTELL</emphasis>. Das Verhalten dieser Erweiterung,
einschließlich der Funktionsnamen, und alles Andere, was hier dokumentiert
ist, kann sich in zukünftigen PHP-Versionen ohne Ankündigung ändern. Seien
Sie gewarnt und verwenden Sie diese Erweiterung auf eigenes
Risiko.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 5.3.0 <emphasis>DEPRECATED</emphasis> (veraltet). Von der Verwendung
dieses Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature wurde
in PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 5.4.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-5-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde in
PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in
PHP 5.4.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieses Features wird dringend abgeraten</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
seit PHP 5.6.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung dieses Features
wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 7.0.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung dieses Features
wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 7.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung dieses Features
wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
seit PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung dieser Funktion
wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-0-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde in
PHP 7.0.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und ist seit
PHP 8.0.0 <emphasis>ENTFERNT</emphasis>. Von der Verwendung dieser Funktion
wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-1-0.removed-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde
in PHP 7.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.2.0 <emphasis>ENTFERNT</emphasis>. Von der Verwendung dieser
Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 7.2.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung dieses
Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 7.2.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0 <emphasis>ENTFERNT</emphasis>. Von der Verwendung dieses
Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.2.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.2.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>. Von der Verwendung dieser Funktion wird
dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 7.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieses Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-3-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>. Von der Verwendung dieser Funktion wird
dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 7.4.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieses Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.4.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 7.4.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>. Von der Verwendung dieser Funktion wird
dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.feature.removed-8-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Dieses Feature wurde in PHP 8.0.0 <emphasis>ENTFERNT</emphasis>.</simpara>
</warning>'>

<!ENTITY warn.deprecated.function-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 8.0.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-1-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 8.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-2-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 8.2.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist seit
PHP 8.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieses Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.function-8-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist seit
PHP 8.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY removed.php.future 'Dieses veraltete Feature <emphasis xmlns="http://docbook.org/ns/docbook">wird</emphasis> in der
Zukunft sicherlich <emphasis xmlns="http://docbook.org/ns/docbook">entfernt</emphasis>.'>

<!ENTITY warn.deprecated.function.removed-5-3-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion war als
<emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 5.3.0
<emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.function.removed-5-5-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion war als
<emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 5.5.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Dieser Alias wurde mit PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert.
Von der Verwendung dieses Aliases wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Dieses Feature ist
seit PHP 5.4.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der Verwendung
dieses Features wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-4-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Dieser Alias wurde mit PHP 5.4.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert.
Von der Verwendung dieses Aliases wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.func-5-5-0 '<warning xmlns="http://docbook.org/ns/docbook">
<simpara>Diese Funktion wurde mit PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Von der
Verwendung dieser Funktion wird dringend abgeraten.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-5-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
seit PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.function-4-1-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
seit PHP 4.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.function-5-3-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
seit PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-5-3-0.removed-7-0-0 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Dieser Alias ist
seit PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.feature-5-6-0.removed-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieses Feature ist
seit PHP 5.6.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und
wurde in PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.removed.function-7-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde in
PHP 7.0.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.removed.function-7-4-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde in
PHP 7.4.0 <emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-2-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieser Alias ist seit PHP 7.2.0
als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-7-4-0.removed-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieser Alias ist seit PHP 7.4.0
als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.deprecated.alias-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieser Alias ist seit PHP 8.0.0
als <emphasis>DEPRECATED</emphasis> (veraltet) markiert.</simpara></warning>'>

<!ENTITY warn.removed.alias-8-0-0 '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Dieser Alias wurde in PHP 8.0.0
<emphasis>ENTFERNT</emphasis>.</simpara></warning>'>

<!ENTITY warn.experimental.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist
<emphasis>EXPERIMENTELL</emphasis>. Das Verhalten, der Funktionsname und die
zugehörige Dokumentation können sich in zukünftigen PHP-Versionen ohne
Ankündigung ändern. Die Verwendung dieser Funktion erfolgt auf eigene Gefahr.
</simpara></warning>'>

<!ENTITY warn.imaprecodeyaz '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Die Erweiterungen
<link linkend="book.imap">IMAP</link>, <link xmlns="http://docbook.org/ns/docbook" linkend="book.recode">recode</link> und
<link xmlns="http://docbook.org/ns/docbook" linkend="book.yaz">YAZ</link>
können nicht zusammen verwendet werden. Diese Tatsache
liegt darin begründet, dass alle diese Erweiterungen die gleichen internen Symbole
benutzen. Hinweis: Yaz 2.0 und höher hat dieses Problem nicht.</simpara></warning>'>

<!ENTITY warn.install.cgi '<warning xmlns="http://docbook.org/ns/docbook"><para>Wenn Sie das CGI-Setup verwenden,
ist Ihr Server für einige mögliche Angriffe anfällig. Wie Sie sich vor diesen
Angriffen schützen können, entnehmen Sie bitte dem
<link linkend="security.cgi-bin">Kapitel über CGI-Sicherheit</link>.</para></warning>'>

<!ENTITY warn.passwordhashing '
<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  Es ist nicht empfohlen, diese Funktion zu verwenden um Passwörter zu hashen, da dieser
  Passwortalgorithmus relativ schnell ist. Die Seite <link linkend="faq.passwords.fasthash">Password Hashing FAQ</link> enthält weitere Informationen
  und Best Practices zum Hashen von Passwörtern.
 </para>
</warning>
'>

<!ENTITY warn.ssl-non-standard '<warning xmlns="http://docbook.org/ns/docbook"><para>Bei SSL-Verbindungen zusammen
mit Microsoft IIS hält sich dieser Webserver nicht an das Protokoll und
schließt die Verbindung ohne ein <literal>close_notify</literal> zu senden.
PHP quittiert dieses Fehlverhalten mit "SSL: Fatal Protocol Error", wenn das
Ende der Daten erreicht ist. Eine mögliche Lösung besteht darin, den Level von
<link linkend="ini.error-reporting">error_reporting</link> herabzusetzten und
Warnings auszuschließen. PHP kann fehlerhafte IIS-Serversoftware
erkennen, wenn Sie einen Stream mit dem <literal>https://</literal>-Wrapper öffnen,
und unterdrückt die Warnung für Sie. Falls Sie <function>fsockopen</function>
benutzen, um einen <literal>ssl://</literal>-Socket zu öffnen, müssen Sie selbst
dafür Sorge tragen, die Warnung zu erkennen und diese zu unterdrücken.</para>
</warning>'>

<!ENTITY warn.undocumented.class '
<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Diese Klasse ist bis jetzt nicht dokumentiert.
  Es steht nur die Liste der Eigenschaften und Methoden zur Verfügung.
 </simpara>
</warning>
'>

<!ENTITY warn.undocumented.func '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist bis jetzt
nicht dokumentiert. Es steht nur die Liste der Parameter zur
Verfügung.</simpara></warning>'>

<!-- Deprecation and removal warnings designed for use with a list of
     alternatives. See en/reference/regex/functions/ereg.xml and
     en/reference/regex/reference.xml for examples of these in action. -->

<!ENTITY warn.deprecated.function.4-1-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wurde in PHP 4.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.0.0
 <emphasis>REMOVED</emphasis> entfernt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Funktionen verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.feature.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Dieses Feature wurde in PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.0.0
 <emphasis>REMOVED</emphasis> entfernt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Features verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.function.5-3-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wurde in PHP 5.3.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.0.0
 <emphasis>REMOVED</emphasis> entfernt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Funktionen verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.function.5-5-0.removed.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wurde in PHP 5.5.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.0.0
 <emphasis>REMOVED</emphasis> entfernt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Funktionen verwendet werden:
</para>
'>

<!ENTITY warn.removed.feature.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Dieses Feature wurde in PHP 7.0.0 <emphasis>REMOVED</emphasis> (entfernt).
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können folgende Features verwendet werden:
</para>
'>

<!ENTITY warn.removed.function.7-0-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wurde in PHP 7.0.0 <emphasis>REMOVED</emphasis> (entfernt).
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können folgende Features verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.feature.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Dieses Feature wurde in PHP 7.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.2.0
 <emphasis>REMOVED</emphasis> (entfernt).
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Features verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.function.7-1-0.removed.7-2-0.alternatives '
<para xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wurde in PHP 7.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert und in PHP 7.2.0
 <emphasis>REMOVED</emphasis> (entfernt).
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Funktionen verwendet werden:
</para>
'>

<!ENTITY warn.deprecated.function-8-1-0.alternatives '<warning
xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion wurde
in PHP 8.1.0 als <emphasis>DEPRECATED</emphasis> (veraltet) markiert. Es wird dringend davon abgeraten,
sich auf diese Funktion zu verlassen.</simpara></warning>
<para xmlns="http://docbook.org/ns/docbook">
 Alternativ können die folgenden Funktionen verwendet werden:
</para>
'>

<!-- Misc -->

<!ENTITY version.exists.asof 'Dies existiert seit PHP '>

<!ENTITY version.trunk.changelog 'Zukünftig'>

<!ENTITY no.function.parameters '<para xmlns="http://docbook.org/ns/docbook">Diese Funktion besitzt keine Parameter.</para>'>

<!ENTITY example.outputs '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</para>'>

<!ENTITY example.outputs.5 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 5 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.53 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 5.3 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.54 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 5.4 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.55 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 5.5 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.56 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 5.6 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.7 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 7 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.70 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 7.0 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.71 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 7.1 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.72 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 7.2 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.73 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 7.3 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.8 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.8.similar '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8 eine ähnliche Ausgabe wie:</para>'>

<!ENTITY example.outputs.80 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.0 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.81 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.1 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.82 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.2 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.82.similar '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.2 eine ähnliche Ausgabe wie:</para>'>

<!ENTITY example.outputs.83 '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.3 folgende Ausgabe:</para>'>

<!ENTITY example.outputs.83.similar '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt mit PHP 8.3 eine ähnliche Ausgabe wie:</para>'>

<!ENTITY example.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt auf 32-Bit-Systemen folgende Ausgabe:</para>'>

<!ENTITY example.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt auf 64-Bit-Systemen folgende Ausgabe:</para>'>

<!ENTITY example.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Das oben gezeigte Beispiel erzeugt
eine ähnliche Ausgabe wie:</para>'>

<!ENTITY examples.outputs '<para xmlns="http://docbook.org/ns/docbook">Die obigen Bespiele erzeugen folgende Ausgabe:</para>'>

<!ENTITY examples.outputs.32bit '<para xmlns="http://docbook.org/ns/docbook">Oben gezeigte Beispiele erzeugen auf 32-Bit-Systemen folgende Ausgabe:</para>'>

<!ENTITY examples.outputs.64bit '<para xmlns="http://docbook.org/ns/docbook">Oben gezeigte Beispiele erzeugen auf 64-Bit-Systemen folgende Ausgabe:</para>'>

<!ENTITY examples.outputs.similar '<para xmlns="http://docbook.org/ns/docbook">Oben gezeigte Beispiele erzeugen
eine ähnliche Ausgabe wie:</para>'>

<!ENTITY array.resetspointer '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion setzt
(<function>reset</function>) nach Verwendung den <type>array</type>-Zeiger
zurück.</simpara></note>'>

<!ENTITY array.changelog.by-ref '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Wenn <parameter>callback</parameter> einen per Referenz übergebenen
  Parameter erwartet, gibt diese Funktion nun einen Fehler der Stufe
  <constant>E_WARNING</constant> aus.
 </entry>
</row>'>

<!ENTITY array.changelog.require-only-one '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Diese Funktion kann jetzt mit nur einem Parameter aufgerufen werden.
  Zuvor waren mindestens zwei Parameter erforderlich.
 </entry>
</row>'>

<!ENTITY seealso.array.sorting 'Den <link xmlns="http://docbook.org/ns/docbook" linkend="array.sorting">Vergleich von Arraysortierungsfunktionen</link>'>

<!ENTITY sort.flags.parameter '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>flags</parameter></term>
 <listitem>
  <para>
   Der optionale zweite Parameter <parameter>flags</parameter> kann mit
   folgenden Werten genutzt werden, um das Sortierverhalten zu ändern:
  </para>
  <para>
   Flags für den Sortiertyp:
   <itemizedlist>
    <listitem>
     <simpara>
      <constant>SORT_REGULAR</constant> - vergleicht Elemente normal; die
      Details werden im Abschnitt
      <link linkend="language.operators.comparison">Vergleichsoperatoren</link>
      beschrieben.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_NUMERIC</constant> - vergleicht Elemente numerisch.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_STRING</constant> - vergleicht Elemente als Zeichenketten.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_LOCALE_STRING</constant> - vergleicht Elemente als
      Zeichenketten, basierend auf dem aktuellen Gebietsschema. Es wird das
      Gebietsschema verwendet, das mit <function>setlocale</function> geändert
      werden kann.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_NATURAL</constant> - vergleicht Elemente als Zeichenketten
      wie <function>natsort</function> mit "natürlicher Ordnung".
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      <constant>SORT_FLAG_CASE</constant> - kann kombiniert werden (bitweise
      ODER) mit <constant>SORT_STRING</constant> oder
      <constant>SORT_NATURAL</constant>, um Zeichenketten ohne
      Berücksichtigung der Groß- und Kleinschreibung zu sortieren.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY sort.callback.description '<para xmlns="http://docbook.org/ns/docbook">
 &return.callbacksort;
</para>
&callback.cmp;
<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Wenn die Vergleichsfunktion <emphasis>nicht-ganzzahlige</emphasis> Werte
  zurückgibt, &zb; vom Typ <type>float</type>, wird der Rückgabewert des
  Callbacks intern in den Typ <type>int</type> umgewandelt. Werte wie
  <literal>0.99</literal> und <literal>0.1</literal> werden also beide in
  einen Integer-Wert von <literal>0</literal> umgewandelt, wodurch diese Werte
  als gleichwertig eingestuft werden.
 </para>
</caution>'>

<!ENTITY sort.callback.description.presort '<caution xmlns="http://docbook.org/ns/docbook">
 <para>
  Das Sortier-Callback muss alle Werte aus allen Arrays in beliebiger
  Reihenfolge verarbeiten, unabhängig von der Reihenfolge, in der sie
  ursprünglich bereitgestellt wurden. Das liegt daran, dass jedes einzelne
  Array zuerst sortiert wird, bevor es mit anderen Arrays verglichen wird.

  Zum Beispiel:
  <programlisting role="php">
<![CDATA[
<?php
$arrayA = ["string", 1];
$arrayB = [["value" => 1]];
// $item1 und $item2 können "string", 1 oder ["value" => 1] sein.
$compareFunc = static function ($item1, $item2) {
    $value1 = is_string($item1) ? strlen($item1) : (is_array($item1) ? $item1["value"] : $item1);
    $value2 = is_string($item2) ? strlen($item2) : (is_array($item2) ? $item2["value"] : $item2);
    return $value1 <=> $value2;
};
?>
]]>
  </programlisting>
 </para>
</caution>'>

<!ENTITY ini.shorthandbytes  '<simpara xmlns="http://docbook.org/ns/docbook">Wird ein Wert vom Typ <type>int</type>
verwendet, wird dieser Wert in Bytes gemessen. Es kann auch die
Kurzschreibweise verwendet werden, wie in
<link linkend="faq.using.shorthandbytes">dieser FAQ</link> beschrieben.</simpara>'>

<!ENTITY info.deprecated.alias 'Für die Abwärtskompatibiliät kann der
folgende veraltete Alias verwendet werden: '>

<!ENTITY info.function.alias 'Diese Funktion ist ein Alias für: '>

<!ENTITY info.method.alias 'Diese Methode ist ein Alias für: '>

<!ENTITY info.function.alias.deprecated '<simpara xmlns="http://docbook.org/ns/docbook">Dieser Funktions-Alias
ist veraltet und existiert nur noch aus Gründen der Rückwärtskompatibilität.
Es wird nicht empfohlen, diese Funktion weiter zu nutzen, da sie eines
Tages aus PHP entfernt werden kann.</simpara>'>

<!ENTITY ext.windows.path.dll 'Diese Erweiterung benötigt <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-Dateien.
die für Windows verfügbar seien müssen. Der <acronym xmlns="http://docbook.org/ns/docbook">FAQ</acronym>-Eintrag
"<link xmlns="http://docbook.org/ns/docbook" linkend="faq.installation.addtopath"> Wie füge ich unter Windows PATH mein
PHP-Verzeichnis hinzu?</link>" gibt hierzu weitere Informationen. Obwohl ein
einfaches Kopieren der DLL-Dateien vom PHP-Verzeichnis in den Windows-Systemordner
auch funktioniert (weil der Systemordner immer im
<envar xmlns="http://docbook.org/ns/docbook">PATH</envar> enthalten ist), ist dieses Vorgehen nicht empfehlenswert.
<emphasis xmlns="http://docbook.org/ns/docbook">Diese Erweiterung benötigt die folgenden Dateien im <envar>PATH</envar>:
</emphasis>'>

<!ENTITY manual.migration.seealso 'Siehe auch die Migrationsleitfäden für PHP-Versionen'>

<!ENTITY style.oop 'Objektorientierter Stil'>
<!ENTITY style.procedural 'Prozeduraler Stil'>

<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">Ressource</link>'>

<!ENTITY foreach '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.foreach">foreach</link>'>

<!ENTITY match '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.match">match</link>'>

<!ENTITY yield '<link xmlns="http://docbook.org/ns/docbook" linkend="control-structures.yield">yield</link>'>

<!ENTITY parameter.context 'Eine Beschreibung von <literal xmlns="http://docbook.org/ns/docbook">contexts</literal>
finden Sie im Abschnitt <link xmlns="http://docbook.org/ns/docbook" linkend="context">Kontextoptionen und -parameter</link>
dieses Handbuchs.'>

<!ENTITY parameter.use_include_path 'Wenn dieser Parameter auf &true; gesetzt ist
wird auch im <link xmlns="http://docbook.org/ns/docbook" linkend="ini.include-path">include_path</link> nach dem
Dateinamen gesucht.'>

<!-- Returns -->

<!ENTITY return.type.true '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Der Rückgabewert ist nun &true; vorher war es <type>bool</type>.
 </entry>
</row>'>

<!ENTITY return.falseforfailure 'Bei einem Fehler wird &false; zurückgegeben.'>
<!ENTITY return.falseforfailure.style.procedural '&style.procedural; Im Fehlerfall wird &false; zurückgegeben.'>

<!ENTITY return.success 'Gibt bei Erfolg &true; zurück. &return.falseforfailure;'>

<!ENTITY return.nullorfalse 'Gibt bei Erfolg &null; zurück. &return.falseforfailure;'>

<!ENTITY return.void 'Es wird kein Wert zurückgegeben.'>

<!ENTITY return.true.always 'Gibt immer &true; zurück.'>

<!ENTITY return.callbacksort 'Die Vergleichsfunktion muss einen Integer kleiner als, gleich oder größer als Null zurückgeben, wenn das erste Argument respektive kleiner, gleich oder größer als das zweite ist.'>

<!ENTITY return.falseproblem '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion kann sowohl das
boolsche &false; zurückliefern, als auch einen nicht-boolschen Wert, welcher zu &false; ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
<link linkend="language.types.boolean"> boolschen Typen</link>. Benutzen Sie deshalb
<link linkend="language.operators.comparison">den === Operator</link>,
um den Rückgabewert dieser Funktion zu überprüfen.</simpara></warning>'>

<!-- Standard -->
<!ENTITY standard.changelog.calling-on-objects '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Bei &object;en ist die Verwendung dieser Funktion veraltet.
  Stattdessen sollte entweder das &object; vorher mit <function>get_mangled_object_vars</function> in ein &array; umgewandelt werden oder es sollten
  die Methoden einer Klasse verwendet werden, die <interfacename>Iterator</interfacename> implementiert, &zb; <classname>ArrayIterator</classname>.
 </entry>
</row>
<row xmlns="http://docbook.org/ns/docbook">
 <entry>7.4.0</entry>
 <entry>
  Instanzen von <link xmlns="http://docbook.org/ns/docbook" linkend="book.spl">SPL</link>-Klassen werden nun wie leere Objekte behandelt, die keine Eigenschaften haben, anstatt die <interfacename>Iterator</interfacename>-Methode aufzurufen, die den gleichen Namen wie diese Funktion hat.
 </entry>
</row>
'>

<!ENTITY standard.changelog.binary-safe-string-comparison '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.2.0</entry>
 <entry>
  Diese Funktion gibt nun <literal>-1</literal> oder <literal>1</literal>
  zurück, wo sie vorher eine negative oder positive Zahl zurückgab.
 </entry>
</row>
'>

<!-- FileInfo -->
<!ENTITY fileinfo.parameters.finfo '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>finfo</classname>-Instanz, die von <function>finfo_open</function> zurückgegeben wurde.</para>'>
<!ENTITY fileinfo.changelog.finfo-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>finfo</parameter> erwartet nun eine <classname>finfo</classname>-Instanz; vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!-- OpenSSL -->
<!ENTITY openssl.param.x509 '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>x509</parameter></term>
 <listitem>
  <para>
   Siehe <link linkend="openssl.certparams">Schlüssel-/Zertifikatsparameter</link> für eine Auflistung der
   gültigen Werte.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.csr '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>csr</parameter></term>
 <listitem>
  <para>
   Eine Liste der gültigen Werte ist unter <link linkend="openssl.certparams">CSR-Parameter</link> zu finden.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY openssl.param.key '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>key</parameter></term>
 <listitem>
  <para>
   Eine Liste der gültigen Werte ist unter <link linkend="openssl.certparams">Public/Private Key parameters</link> zu finden.
  </para>
 </listitem>
</varlistentry>'>

<!-- Image (GD) Notes -->
<!ENTITY note.config.t1lib '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion steht nur
zur Verfügung, wenn PHP mit der Option
<option role="configure">--with-t1lib[=DIR]</option> übersetzt wurde.
</simpara></note>'>

<!ENTITY note.freetype '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist nur verfügbar
wenn PHP mit Freetype unterstützung (<option role="configure">--with-freetype-dir=DIR</option>)
kompiliert wurde</simpara></note>'>

<!ENTITY note.gd.notrequired '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion benötigt die GD-Bibliothek nicht.</para></note>'>

<!ENTITY note.gd.interpolation '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion wird von der mittels <function>imagesetinterpolation</function> eingestellten Interpolationsmethode beeinflusst.</para></note>'>

<!ENTITY gd.image.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>image</parameter></term><listitem><para>Ein <classname>GdImage</classname>-Objekt, das von einer der Funktionen zur Bilderzeugung, &zb;
<function>imagecreatetruecolor</function>, zurückgegeben wurde.</para></listitem></varlistentry>'>

<!ENTITY gd.font.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>font</parameter></term><listitem><para>Kann bei eingebauten Schriftarten
in Latin2-Kodierung 1, 2, 3, 4 oder 5 sein (wobei größere Zahlen größeren Schriftarten entsprechen) oder eine <classname>GdFont</classname>-Instanz,
die von <function>imageloadfont</function> zurückgegeben wurde.</para></listitem></varlistentry>'>

<!ENTITY gd.changelog.gdfont-instance '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.1.0</entry>
  <entry>
   Der Parameter <parameter>font</parameter> akzeptiert jetzt sowohl eine <classname>GdFont</classname>-Instanz
   als auch ein &integer;; vorher wurde nur &integer; akzeptiert.
  </entry>
</row>'>

<!ENTITY gd.ttf.fontfile "
    <varlistentry xmlns='http://docbook.org/ns/docbook'>
     <term><parameter>fontfile</parameter></term>
     <listitem>
      <para>
       Der Pfad zu der TrueType-Schriftart, die verwendet werden soll.
      </para>
      <para>
       Der Pfad zu der TrueType-Schriftart, die verwendet werden soll.
       Abhängig davon, welche Version der GD-Bibliothek PHP verwendet, wird,
       <emphasis>wenn <parameter>fontfile</parameter> nicht mit einem
       vorangestellten <literal>/</literal> beginnt, <literal>.ttf</literal>
       an den Dateinamen angehängt</emphasis> und die Bibliothek versucht,
       diesen Dateinamen entlang eines von der Bibliothek definierten
       Schriftarten-Pfades zu suchen.
      </para>
      <para>
       Bei der Verwendung von Versionen der GD-Bibliothek, die älter als
       2.0.18 sind, wurde ein <literal>space</literal>-Zeichen, anstelle eines
       Semikolons als Pfad-Trennzeichen für verschiedene Schriftdateien
       verwendet. Die unbeabsichtigte Verwendung dieser Eigenschaft führt zu
       einer Warnmeldung: <literal>Warnung: Schriftart konnte nicht
       gefunden/geöffnet werden</literal>. Für diese betroffenen Versionen
       besteht die einzige Lösung darin, die Schriftart in einen Pfad zu
       verschieben, der keine Leerzeichen enthält.
      </para>
      <para>
       In vielen Fällen, in denen sich eine Schriftart im selben Verzeichnis
       befindet wie das Skript, das sie verwendet, kann der folgende Trick die
       Probleme beim Einbinden lösen.
       <programlisting role='php'>
<![CDATA[
<?php
// Setzten der Umgebungsvariablen für GD
putenv('GDFONTPATH=' . realpath('.'));

// Benennen der zu verwendenden Schriftart
// (zu beachten ist das Fehlen der Erweiterung .ttf)
$font = 'IrgendeineSchriftart';
?>
]]>
       </programlisting>
      </para>
      <note>
       <para>
        Zu beachten ist, dass
        <link linkend='ini.open-basedir'>open_basedir</link>
        <emphasis>nicht</emphasis> für <parameter>fontfile</parameter> gilt.
       </para>
      </note>
     </listitem>
    </varlistentry>
">

<!ENTITY gd.return.identifier 'Gibt im Erfolgsfall eine Bildobjekt zurück, im Fehlerfall &false;.'>

<!ENTITY gd.return.trueonerror '<caution xmlns="http://docbook.org/ns/docbook"><simpara>Wenn libgd das Bild nicht ausgeben kann, gibt diese Funktion &true; zurück.</simpara></caution>'>

<!ENTITY gd.identifier.color "Eine Farbkennung, die mit <function xmlns='http://docbook.org/ns/docbook'>imagecolorallocate</function> erzeugt wurde.">

<!ENTITY gd.value.red 'Wert der Rotkomponente.'>

<!ENTITY gd.value.green 'Wert der Grünkomponente.'>

<!ENTITY gd.value.blue 'Wert der Blaukomponente.'>

<!ENTITY gd.source.height 'Höhe der Quelle.'>

<!ENTITY gd.source.width 'Breite der Quelle.'>

<!ENTITY gd.image.path 'Der Pfad oder eine offene Stream-Ressource (die nach der Beendigung dieser Funktion automatisch geschlossen wird), in dem bzw. der die Datei gespeichert werden soll. Falls nicht gesetzt oder &null;, wird der rohe Bilddatenstrom direkt ausgegeben.'>

<!ENTITY gd.image.new 'Erzeugt ein neues Bild aus einer Datei oder URL'>

<!ENTITY gd.image.source 'Ressource des Quellbildes.'>

<!ENTITY gd.image.destination 'Ressource des Zielbildes.'>

<!ENTITY gd.image.output 'Gibt das Bild im Browser oder einer Datei aus.'>

<!ENTITY gd.image.colors 'Wenn das Bild aus einer Datei erzeugt wurde, so werden nur die Farben aufgelöst, die im Bild verwendet werden. Farben, die nur in der Farbpalette enthalten sind, werden nicht aufgelöst.'>

<!ENTITY gd.font.size 'Die Schriftgröße in Punkten.'>

<!ENTITY gd.constants.types '<simpara xmlns="http://docbook.org/ns/docbook">
    Wird als Rückgabewert von <function>imagetypes</function> verwendet
</simpara>'>

<!ENTITY gd.constants.color '<simpara xmlns="http://docbook.org/ns/docbook">
    Eine spezielle Farboption, die anstelle einer Farbe verwendet werden kann,
    die mit <function>imagecolorallocate</function> oder
    <function>imagecolorallocatealpha</function> zugewiesen wird.
</simpara>'>

<!ENTITY gd.constants.affine '<simpara xmlns="http://docbook.org/ns/docbook">
    Eine Konstante vom Typ affine Transformation, die von der Funktion
    <function>imageaffinematrixget</function> verwendet wird.
</simpara>'>

<!ENTITY gd.constants.arc '<simpara xmlns="http://docbook.org/ns/docbook">
    Eine Stilkonstante, die von der Funktion <function>imagefilledarc</function>
    verwendet wird.
</simpara>'>

<!ENTITY gd.constants.gd2 '<simpara xmlns="http://docbook.org/ns/docbook">
    Eine Typkonstante, die von der Funktion <function>imagegd2</function>
    verwendet wird.
</simpara>'>

<!ENTITY gd.constants.effect '<simpara xmlns="http://docbook.org/ns/docbook">
    Ein Alpha-Blending-Effekt, der von der Funktion
    <function>imagelayereffect</function> verwendet wird.
</simpara>'>

<!ENTITY gd.constants.filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Ein spezieller GD-Filter, der von der Funktion
    <function>imagefilter</function> verwendet wird.
</simpara>'>

<!ENTITY gd.constants.type '<simpara xmlns="http://docbook.org/ns/docbook">
    Eine Bildtyp-Konstante, die von den Funktionen
    <function>image_type_to_mime_type</function> und
    <function>image_type_to_extension</function> verwendet wird.
</simpara>'>

<!ENTITY gd.constants.png-filter '<simpara xmlns="http://docbook.org/ns/docbook">
    Ein spezieller PNG-Filter, der von der Funktion <function>imagepng</function>
    verwendet wird.
</simpara>'>

<!ENTITY gd.constants.flip '<simpara xmlns="http://docbook.org/ns/docbook">
    Wird zusammen mit <function>imageflip</function> verwendet.
</simpara>'>

<!ENTITY gd.constants.interpolation '<simpara xmlns="http://docbook.org/ns/docbook">
    Wird zusammen mit <function>imagesetinterpolation</function> verwendet.
</simpara>'>

<!ENTITY gd.changlog.t1lib '<row xmlns="http://docbook.org/ns/docbook">
    <entry>7.0.0</entry><entry>Die T1Lib-Unterstützung wurde aus PHP entfernt, weshalb auch diese Funktion entfernt wurde.</entry>
</row>'>

<!ENTITY gd.deprecated.gd-formats '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Die Bildformate
GD und GD2 sind proprietäre Bildformate von libgd. Sie sind als <emphasis>veraltet</emphasis>
anzusehen, und sollten nur zu Entwicklungs- und Testzwecken verwendet werden.</simpara></warning>'>

<!ENTITY gd.changelog.image-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>image</parameter> erwartet nun eine
  <classname>GdImage</classname>-Instanz; vorher wurde eine gültige
  <literal>gd</literal>-<type>Ressource</type> erwartet.
 </entry>
</row>'>

<!-- CSV -->
<!ENTITY warning.csv.escape-parameter '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"><simpara>
 Wenn <parameter>escape</parameter> auf etwas anderes als eine leere Zeichenkette
 (<literal>""</literal>) gesetzt wird, kann dies zu einer CSV-Datei führen, die
 nicht mit <link xlink:href="&url.rfc;4180">RFC 4180</link> konform ist oder die
 den Umlauf durch die PHP-CSV-Funktionen nicht übersteht. Der Standardwert für
 <parameter>escape</parameter> ist <literal>"\\"</literal>, weshalb empfohlen
 wird, diesen Parameter explizit auf eine leere Zeichenkette zu setzen.
 Der Standardwert wird sich in einer zukünftigen Version von PHP ändern, jedoch
 nicht vor PHP 9.0.
</simpara></warning>'>

<!-- DBM notes -->

<!ENTITY dbm.dbm-identifier.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>dbm_identifier</parameter></term><listitem><para>Ein von <function>dbmopen</function>
zurückgegebenes DBM-Verbindungshandle.</para></listitem></varlistentry>'>

<!-- JSON notes -->

<!ENTITY json.implementation.superset '
 <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <para>
   PHP implementiert eine Obermenge von JSON wie im Original
   <link xlink:href="&url.rfc;7159">RFC 7159</link> beschrieben.
  </para>
 </note>
'>

<!-- cURL notes -->

<!ENTITY curl.ch.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>handle</parameter>
</term><listitem><para>Ein von <function>curl_init</function> zurückgegebenes
cURL-Handle.</para></listitem></varlistentry>'>

<!ENTITY curl.mh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>multi_handle</parameter>
</term><listitem><para>Ein von <function>curl_multi_init</function> zurückgegebenes
cURL-Multihandle.</para></listitem></varlistentry>'>

<!ENTITY curl.sh.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>share_handle</parameter>
</term><listitem><para>Ein gemeinsames cURL-Handle, das von
<function>curl_share_init</function> zurückgegeben wird.</para></listitem></varlistentry>'>

<!ENTITY curl.changelog.handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>handle</parameter> erwartet nun eine
  <classname>CurlHandle</classname>-Instanz; vorher wurde eine
  <type>&resource;</type> erwartet.
 </entry>
</row>'>

<!ENTITY curl.changelog.multi-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>multi_handle</parameter> erwartet nun eine
  <classname>CurlMultiHandle</classname>-Instanz; vorher wurde eine
  <type>&resource;</type> erwartet.
 </entry>
</row>'>

<!ENTITY curl.changelog.share-handle-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>share_handle</parameter> erwartet nun eine
  <classname>CurlShareHandle</classname>-Instanz; vorher wurde eine
  <type>&resource;</type> erwartet.
 </entry>
</row>'>

<!-- dbase notes -->

<!ENTITY dbase.type-conversion '<para xmlns="http://docbook.org/ns/docbook">
   Jedes Feld wird in den entsprechenden PHP-Typ umgewandelt, ausgenommen:
   <itemizedlist>
    <listitem>
     <simpara>
      Datumsfelder werden als Zeichenkette zurückgegeben.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Zeitstempelwerte werden in Zeichenketten umgewandelt.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Ganzzahlen außerhalb des Bereiches
      <constant>PHP_INT_MIN</constant>..<constant>PHP_INT_MAX</constant> werden
      als Zeichenkette zurückgegeben.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      Boolesche Werte (<literal>L</literal>) werden zu <literal>1</literal> oder
      <literal>0</literal> umgewandelt.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>'>

<!-- enchant entities -->

<!ENTITY enchant.param.broker '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>broker</parameter></term>
     <listitem>
      <para>
       Ein Enchant-Broker, der von <function>enchant_broker_init</function> zurückgegeben wird.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.param.dictionary '<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>dictionary</parameter></term>
     <listitem>
      <para>
       Ein Enchant-Wörterbuch, das von <function>enchant_broker_request_dict</function>
       oder <function>enchant_broker_request_pwl_dict</function> zurückgegeben wird.
      </para>
     </listitem>
    </varlistentry>'>

<!ENTITY enchant.changelog.broker-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Der Parameter <parameter>broker</parameter> erwartet nun eine
  <classname>EnchantBroker</classname>-Instanz; vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!ENTITY enchant.changelog.dictionary-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  Der Parameter <parameter>dictionary</parameter> erwartet nun eine
  <classname>EnchantDictionary</classname>-Instanz; vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!-- IMAP notes -->

<!ENTITY imap.changelog.imap-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>imap</parameter> erwartet nun eine
  <classname>IMAP\Connection</classname>-Instanz; vorher wurde eine gültige
  <literal>imap</literal>-&resource; erwartet.
 </entry>
</row>'>

<!ENTITY imap.imap-parameter.imap '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Eine <classname>IMAP\Connection</classname>-Instanz.</para></listitem></varlistentry>'>

<!-- Deprecated -->
<!ENTITY imap.imap-stream.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>imap</parameter></term><listitem><para>Eine von <function>imap_open</function>
zurückgegebene IMAP-Verbindung.</para></listitem></varlistentry>'>

<!ENTITY imap.pattern '<para xmlns="http://docbook.org/ns/docbook">Gibt an, wo in der Postfach-Hierarchie
mit der Suche begonnen werden soll.</para>
<para xmlns="http://docbook.org/ns/docbook">Es gibt zwei Sonderzeichen, die
man als Teil von <parameter>pattern</parameter> verwenden kann:
&apos;<literal>*</literal>&apos; und &apos;<literal>&#37;</literal>&apos;.
&apos;<literal>*</literal>&apos; heißt, dass alle Postfächer zurückgegeben
werden sollen. Wenn man <parameter>pattern</parameter> als
&apos;<literal>*</literal>&apos; übergibt, so erhält man eine Liste der
vollständigen Postfach-Hierarchie. &apos;<literal>&#37;</literal>&apos; heißt,
dass nur die aktuelle Stufe zurückgegeben wird.
&apos;<literal>&#37;</literal>&apos; als Wert des Parameters <parameter>pattern</parameter> gibt nur die Postfächer der obersten Ebene zurück.
&apos;<literal>~/mail/&#37;</literal>&apos; unter <literal>UW_IMAPD</literal> gibt alle Postfächer des
Verzeichnisses <filename>~/mail</filename> zurück, aber keine aus dessen Unterverzeichnissen.</para>'>

<!ENTITY imap.mailboxname.insecure '<warning xmlns="http://docbook.org/ns/docbook"><simpara>
Die Übergabe von nicht vertrauenswürdigen Daten an diesen Parameter ist <emphasis>unsicher</emphasis>,falls
<link linkend="ini.imap.enable-insecure-rsh">imap.enable_insecure_rsh</link> nicht deaktiviert ist.
</simpara></warning>'>

<!-- intl notes -->

<!ENTITY intl.parameter.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>IntlCalendar</classname>-Instanz.</para>'>

<!ENTITY intl.error.intl-calendar '<para xmlns="http://docbook.org/ns/docbook">Bei einem Fehler wird auch &false; zurückgegeben. Um Fehlerzustände zu erkennen, kann die Funktion <function>intl_get_error_code</function> verwendet werden oder Intl so konfiguriert werden, dass es <link linkend="ini.intl.use-exceptions" >Exceptions</link> auslöst.</para>'>

<!ENTITY intl.codepoint.parameter '<para xmlns="http://docbook.org/ns/docbook">Ein Wert vom Typ <type>int</type>, der einen Codepoint darstellt (&zb; <literal>0x2603</literal> für <emphasis>U+2603 SNOWMAN</emphasis>) oder ein als UTF-8-<type>String</type> kodiertes Zeichen (&zb; <literal>"\u{2603}"</literal>)</para>'>

<!ENTITY intl.codepoint.return '<para xmlns="http://docbook.org/ns/docbook">Der Rückgabetyp ist <type>int</type>, außer der Codepoint wurde als UTF-8-<type>String</type> übergeben, in welchem Fall ein <type>String</type> zurückgegeben wird. Bei einem Fehler wird &null; zurückgegeben.</para>'>

<!ENTITY intl.codepoint.example 'Testen unterschiedlicher Codepoints'>

<!ENTITY intl.locale-len.return '<para xmlns="http://docbook.org/ns/docbook">Gibt &null; zurück, wenn die Länge von <parameter>locale</parameter> <constant>INTL_MAX_LOCALE_LEN</constant> überschreitet.</para>'>

<!ENTITY intl.property.parameter '<para xmlns="http://docbook.org/ns/docbook">Die Unicode-Eigenschaft, die gesucht werden soll (siehe die <literal>IntlChar::PROPERTY_*</literal>-Konstanten).</para>'>

<!ENTITY intl.property.example 'Testen unterschiedlicher Eigenschaften'>

<!-- LDAP notes -->

<!ENTITY ldap.parameter.ldap 'Eine <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>Instanz, die von  <function xmlns="http://docbook.org/ns/docbook">ldap_connect</function> zurückgegeben wurde.'>

<!ENTITY ldap.parameter.result 'Eine <classname xmlns="http://docbook.org/ns/docbook">LDAP\Connection</classname>Instanz, die von <function xmlns="http://docbook.org/ns/docbook">ldap_list</function> oder <function xmlns="http://docbook.org/ns/docbook">ldap_search</function> zurückgegeben wurde.'>

<!ENTITY ldap.parameter.entry 'Eine <classname xmlns="http://docbook.org/ns/docbook">LDAP\ResultEntry</classname>-Instanz'>

<!ENTITY ldap.warn.control-paged '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Diese Funktion ist seit PHP 7.4.0 <emphasis>VERALTET</emphasis> und seit
  PHP 8.0.0 <emphasis>ENTFERNT</emphasis>. Stattdessen sollte der Parameter
  <parameter>controls</parameter> von <function>ldap_search</function>
  verwendet werden. Siehe auch
  <link linkend="ldap.controls">LDAP-Steuerungselemente</link> für weitere Details.
 </simpara>
</warning>'>

<!ENTITY ldap.changelog.controls-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>controls</parameter> ist nun nullable (akzeptiert den &null;-Wert); vorher war der Standardwert <literal>[]</literal>.
 </entry>
</row>'>

<!ENTITY ldap.changelog.ldap-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>ldap</parameter> erwartet nun eine <classname>LDAP\Connection</classname>-Instanz;
  vorher wurde eine gültige <literal>ldap link</literal>-&resource; erwartet.
 </entry>
</row>'>

<!ENTITY ldap.changelog.entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>entry</parameter> erwartet nun eine
  <classname>LDAP\ResultEntry</classname>-Instanz; vorher wurde eine gültige
  <literal>ldap result entry</literal>-&resource; erwartet.
 </entry>
</row>'>

<!ENTITY ldap.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>result</parameter> erwartet nun eine
  <classname>LDAP\Result</classname>-Instanz; vorher wurde eine gültige
  <literal>ldap result</literal>-&resource; erwartet.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Gibt nun eine <classname>LDAP\Result</classname>-Instanz zurück; vorher
  wurde eine &resource; zurückgegeben.
 </entry>
</row>'>

<!ENTITY ldap.changelog.return-result-entry-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Gibt nun eine <classname>LDAP\ResultEntry</classname>-Instanz zurück; vorher
  wurde eine &resource; zurückgegeben.
 </entry>
</row>'>

<!ENTITY ldap.return-result 'Gibt eine <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>-Instanz zurück. &return.falseforfailure;'>
<!ENTITY ldap.return-result-array 'Gibt eine <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>-Instanz oder ein Array von <classname xmlns="http://docbook.org/ns/docbook">LDAP\Result</classname>-Instanzen zurück. &return.falseforfailure;'>

<!ENTITY ldap.return-result-array-info '<para xmlns="http://docbook.org/ns/docbook">Es ist auch möglich, parallele Suchen durchzuführen. In diesem Fall muss der erste Parameter ein Array von
<classname>LDAP\Connection</classname>-Instanzen sein, anstatt einer einzelnen.
Wenn die Suchen nicht alle den gleichen Basis-DN und Filter verwenden sollen, kann stattdessen ein Array von Basis-DNs und/oder ein Array von Filtern als Parameter übergeben werden.
Diese Arrays müssen die gleiche Größe haben wie das Array von <classname>LDAP\Connection</classname>-Instanzen,
da die ersten Einträge der Arrays für eine Suche verwendet werden, die zweiten Einträge für eine andere und so weiter.
Bei parallelen Suchen wird ein Array von <classname>LDAP\Result</classname>-Instanzen zurückgegeben, außer im Fall eines Fehlers, dann ist der Rückgabewert &false;.</para>'>

<!-- mbstring notes -->

<!ENTITY note.mbstring.encoding.internal '<note xmlns="http://docbook.org/ns/docbook"><para>Die interne
Kodierung oder die mit <function>mb_regex_encoding</function> festgelegte
Zeichenkodierung wird als Zeichenkodierung für diese Funktion genutzt.</para></note>'>

<!ENTITY note.mbstring.encoding.current '<note xmlns="http://docbook.org/ns/docbook"><para>Die durch
<function>mb_regex_encoding</function> angegebene Zeichenkodierung wird von dieser Funktion als die
Standardkodierung verwendet.</para></note>'>

<!ENTITY mbstring.encoding.parameter '<para xmlns="http://docbook.org/ns/docbook">Der Parameter <parameter>encoding</parameter>
legt die Zeichenkodierung fest. Wird er nicht übergeben, so wird die interne
Zeichenkodierung genutzt.</para>'>

<!ENTITY mbstring.warning.e-modifier '<warning xmlns="http://docbook.org/ns/docbook"><para>Der Modifikator <literal>e</literal> sollte niemals verwendet werden, wenn mit Eingaben gearbeitet wird, die als nicht vertrauenswürdig gelten. Es erfolgt keine automatische Maskierung wie sie von der Funktion <function>preg_replace</function> bekannt ist. Wenn dies nicht beachtet wird, führt es in der Anwendung höchstwahrscheinlich zu Sicherheitslücken bezüglich der Ausführung von entferntem Code.</para></warning>'>

<!ENTITY mbstring.changelog.encoding-nullable '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>encoding</parameter> ist nun nullable (akzeptiert den
  &null;-Wert).
 </entry>
</row>'>

<!ENTITY mbstring.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> akzeptiert nun eine leere Zeichenkette.
 </entry>
</row>'>

<!-- mcrypt notes -->

<!ENTITY mcrypt.parameter.cipher '<para xmlns="http://docbook.org/ns/docbook">Eine der Konstanten von <constant>MCRYPT_ciphername</constant> oder der Name eines Algorithmus als Zeichenkette.</para>'>

<!ENTITY mcrypt.parameter.iv '<para xmlns="http://docbook.org/ns/docbook">Wird für die Initialisierung in den Modi CFC, CFB oder OFB und von einigen Algorithmen im STREAM-Modus verwendet. Wird kein IV angegeben wenn dieser für einen Algorithmus notwendig ist wird diese Funktion eine Warnung ausgeben und einen IV nehmen bei dem alle Bytes auf "<literal>\0</literal>" gesetzt sind.</para>'>

<!ENTITY mcrypt.parameter.iv.strict '<para xmlns="http://docbook.org/ns/docbook">Wird für die Initialisierung in den Modi CBC, CFB oder OFB und von einigen Algorithmen im STREAM-Modus verwendet. Wird die Länge des angegebenen IV vom Betriebsmodus nicht unterstützt, oder wurde kein IV angegeben aber der Betriebsmodus benötigt einen, so wird diese Funktion eine Warnung ausgeben und &false; zurückgeben.</para>'>

<!ENTITY mcrypt.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">Eine der <constant>MCRYPT_MODE_modename</constant>-Konstanten oder eine der folgenden Zeichenketten: "ecb", "cbc", "cfb", "ofb", "nofb" oder "stream".</para>'>

<!-- MCVE notes -->

<!ENTITY mcve.conn.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>conn</parameter></term>
<listitem><para>Eine von <function>m_initengine</function> zurückgegebene
MCVE_CONN-Ressource.</para></listitem></varlistentry>'>

<!-- memcached notes -->

<!ENTITY memcached.note.delete-time '<note xmlns="http://docbook.org/ns/docbook"><simpara>
       Seit memcached 1.3.0 (veröffentlicht 2009) wird diese Funktion nicht
       mehr unterstützt. Wenn für <parameter>time</parameter> ein Wert
       ungleich Null angegeben wird, schlägt der Löschvorgang fehl und
       <methodname>Memcached::getResultCode</methodname> gibt
       <constant>MEMCACHED_INVALID_ARGUMENTS</constant> zurück.
      </simpara></note>
'>

<!ENTITY memcached.parameter.expiration 'Die Verfallszeit, Vorgabewert ist 0. Siehe
<link linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Verfallszeiten</link> für weiterführende Informationen.'>

<!ENTITY memcached.parameter.server_key 'Ein Schlüssel, der den Server bestimmt, auf dem die Daten abgelegt oder von dem Daten abgerufen werden sollen. Anstatt den tatsächlichen Schlüssel des Wertes zu hashen, wird der Server-Key gehasht, um den Memcached-Server ausfindig zu machen, mit dem gesprochen werden soll. Dies erlaubt es, alle zusammengehörigen Daten auf einem einzigen Server abzulegen, um multiple Operationen effizienter zu gestalten.'>

<!ENTITY memcached.parameter.items 'Ein Array von Schlüssel-/Wert-Paaren, die auf dem
Server gespeichert werden sollen.'>

<!ENTITY memcached.parameter.key 'Der Schlüssel, unter dem der Wert abgelegt werden soll.'>

<!ENTITY memcached.parameter.value 'Der zu speichernde Wert.'>

<!ENTITY memcached.result.getresultcode 'Benutzen Sie wenn nötig
<methodname xmlns="http://docbook.org/ns/docbook">Memcached::getResultCode</methodname>.'>

<!ENTITY memcached.result.delete-multi '<para xmlns="http://docbook.org/ns/docbook">
   Gibt ein Array mit <parameter>keys</parameter> als Indizes zurück. Dabei
   sind die jeweiligen Werte &true;, wenn der entsprechende Schlüssel gelöscht
   wurde, oder eine der <constant>Memcached::RES_*</constant>-Konstanten, wenn
   der entsprechende Löschvorgang fehlgeschlagen ist.
   </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Die Methode <methodname>Memcached::getResultCode</methodname> gibt den
   Ergebniscode für den zuletzt ausgeführten Löschvorgang zurück, also den
   Löschvorgang für das letzte Element von <parameter>keys</parameter>.
  </para>
'>

<!-- password notes -->

<!ENTITY password.parameter.algo 'Eine Konstante für den <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Passwort-Algorithmus</link>, die den Algorithmus zum hashen des Passwortes angibt.'>

<!ENTITY password.parameter.hash 'Ein Hash, der durch <function xmlns="http://docbook.org/ns/docbook">password_hash</function> erzeugt wurde.'>

<!ENTITY password.parameter.options 'Ein assoziatives Array mit Optionen. Siehe auch <link xmlns="http://docbook.org/ns/docbook" linkend="password.constants">Konstanten für Passwort-Algorithmen</link> für Informationen zu den von den jeweiligen Algorithmen unterstützten Optionen.'>

<!ENTITY password.parameter.password 'Das Passwort des Benutzers.'>

<!-- pspell notes -->

<!ENTITY pspell.changelog.pspell-dictionary '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>dictionary</parameter> erwartet nun eine
  <classname>PSpell\Dictionary</classname>-Instanz; vorher wurde eine
  &resource; erwartet.
 </entry>
</row>'>

<!ENTITY pspell.changelog.pspell-config '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>config</parameter> erwartet nun eine
  <classname>PSpell\Config</classname>-Instanz; vorher wurde eine &resource;
  erwartet.
 </entry>
</row>'>

<!ENTITY pspell.parameter.pspell-dictionary '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PSpell\Dictionary</classname>-Instanz.</para>'>

<!ENTITY pspell.parameter.pspell-config '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PSpell\Config</classname>-Instanz.</para>'>

<!-- RNP -->

<!ENTITY rnp.parameter.ffi-description 'Das von rnp_ffi_create zurückgegebene FFI-Objekt.'>

<!ENTITY rnp.parameter.key-format 'Das Schlüsselformat der Daten (GPG, KBX, G10).'>

<!ENTITY rnp.parameter.loadsave-flags 'Siehe die Beschreibung der RNP_LOAD_SAVE_*-Flags.'>

<!-- socket entities -->

<!ENTITY sockets.changelog.socket-param '<row xmlns="http://docbook.org/ns/docbook">
  <entry>8.0.0</entry>
  <entry>
   <parameter>socket</parameter> ist nun eine
   <classname>Socket</classname>-Instanz; vorher war es eine
   <type>resource</type>.
  </entry>
 </row>'>

<!ENTITY sockets.changelog.address-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>address</parameter> ist nun eine
  <classname>AddressInfo</classname>-Instanz; vorher war es eine
  <type>resource</type>.
 </entry>
</row>'>

<!-- geaman notes -->

<!ENTITY gearman.parameter.host 'Der Hostname des Jobservers.'>

<!ENTITY gearman.parameter.port 'Der Port des Jobservers.'>

<!ENTITY gearman.parameter.functionname 'Die registrierte Funktion, die der Worker ausführen soll'>

<!ENTITY gearman.parameter.workload 'Serialisierte Daten, die verarbeitet werden sollen'>

<!ENTITY gearman.parameter.data 'Zusätzliche Daten, die für die Ausführung benötigt werden könnten'>

<!ENTITY gearman.parameter.context 'Der Anwendungskontext der mit einem Task verknüpft werden soll'>

<!ENTITY gearman.parameter.unique 'Eine eindeutige ID, die einen bestimmten Task identifiziert'>

<!ENTITY gearman.parameter.jobhandle 'Das vom Gearman-Server zugewiesene Job-Handle'>

<!ENTITY gearman.parameter.callback '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>callback</parameter></term>
 <listitem>
  <para>
   Die aufzurufende Funktion oder Methode.
   Sie sollte einen gültigen <link linkend="gearman.constants">Gearman-Rückgabewert</link> zurückgeben.
  </para>
  <para>
   Wenn es keine Rückgabeanweisung gibt, ist der Standardwert <constant>GEARMAN_SUCCESS</constant>.
  </para>
  <methodsynopsis>
   <type>int</type><methodname><replaceable>callback</replaceable></methodname>
   <methodparam><type>GearmanTask</type><parameter>task</parameter></methodparam>
   <methodparam><type>mixed</type><parameter>context</parameter></methodparam>
  </methodsynopsis>
  <variablelist>
   <varlistentry>
    <term><parameter>task</parameter></term>
    <listitem>
     <para>
      Die Aufgabe, für die dieser Callback aufgerufen wird.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry>
    <term><parameter>context</parameter></term>
    <listitem>
     <para>
      Alles, was an <methodname>GearmanClient::addTask</methodname> (oder eine entsprechende Methode) als <parameter>context</parameter> übergeben wurde.
     </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </listitem>
</varlistentry>'>

<!ENTITY gearman.note.callback '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Der Callback wird nur für Aufgaben ausgelöst, die nach dem Aufruf dieser Methode hinzugefügt werden (&zb; durch den Aufruf von
  <methodname>GearmanClient::addTask</methodname>).
 </para>
</note>'>

<!-- Date and time entities -->
<!ENTITY date.timezone.intro.title '<title xmlns="http://docbook.org/ns/docbook">Liste unterstützter Zeitzonen</title>'>

<!ENTITY date.timezone.intro "<para xmlns='http://docbook.org/ns/docbook'>
Hier finden Sie die vollständige Liste aller von PHP unterstützen Zeitzonen,
wie sie z.b mit <function>date_default_timezone_set</function> genutzt
werden können.</para><note xmlns='http://docbook.org/ns/docbook'><simpara>Die jeweils aktuellste Version der
Zeitzonendatenbank kann über das <link xlink:href='&url.pecl.package.get;timezonedb'
xmlns:xlink='http://www.w3.org/1999/xlink'>timezonedb</link>-Paket in
PECL installiert werden. Für Windows existiert eine vorkompilierte
DLL auf der PECL4Win-Seite: php_timezonedb.dll.</simpara></note>"> <!-- Removed link to fix the build ~sobak 12/06/2016 -->

<!ENTITY date.timezone.bc '<simpara xmlns="http://docbook.org/ns/docbook">Die folgenden Zeitzonen (mit Ausnahme von UTC)
existieren nur aus Gründen der Rückwärtskompatibilität und sollten nicht mehr
benutzt werden, da sie sich fehlerhaft verhalten können.
Außerdem können diese Zeitzonen jederzeit aus der IANA-Zeitzonendatenbank entfernt werden.
</simpara>'>

<!ENTITY date.timezone.posix-signs '<simpara xmlns="http://docbook.org/ns/docbook">
 Falls Sie die obige Warnung außer Acht lassen beachten Sie bitte, dass die IANA-Datenbank, die
 die Unterstützung für Zeitzonen für PHP bereitstellt, die Vorzeichen in POSIX-Stil verwendet.
 Dies kann dazu führen, dass die Angaben von Zeitzonen als <literal>Etc/GMT+n</literal> und
 <literal>Etc/GMT-n</literal> umgekehrt zur geläufigen Angabe ist.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Die Zeitzone 8 Stunden vor GMT, welche unter anderem in China und Westaustralien
 verwendet wird, ist beispielsweise <literal>Etc/GMT-8</literal> in dieser Datenbank
 statt <literal>Etc/GMT+8</literal> die man üblicherweise erwarten würde.
</simpara>
<simpara xmlns="http://docbook.org/ns/docbook">
 Es wird daher nochmals empfohlen die für den jeweiligen Standort korrekte
 Zeitzone zu verwenden, beispielsweise <literal>Asia/Shanghai</literal> oder
 <literal>Australia/Perth</literal> für das obige Beispiel.
</simpara>'>

<!ENTITY date.timezone.abbrev-volatile '<simpara xmlns="http://docbook.org/ns/docbook">
 Diese Zeitzonenabkürzungen sind als sehr unbeständig zu betrachten, &dh; sie
 können bei jeder timezonedb-Version anders sein und sollten nicht als
 verlässlich angesehen werden. Es wird dringend empfohlen,
 Zeitzonenabkürzungen zu vermeiden.
</simpara>'>

<!ENTITY date.timezone.errors.description '<para xmlns="http://docbook.org/ns/docbook">
Wenn die Zeitzone ungültig ist, wird bei jedem Aufruf einer Datums/Zeit-Funktion
ein Fehler der Stufe <constant>E_WARNING</constant> erzeugt. Siehe auch
<function>date_default_timezone_set</function></para>'>

<!ENTITY date.timezone.errors.changelog '<row xmlns="http://docbook.org/ns/docbook"><entry>5.1.0</entry><entry><para>
Erzeugt nun <constant>E_STRICT</constant>- und
<constant>E_NOTICE</constant>-Zeitzonenfehler.</para></entry></row>'>

<!ENTITY date.timestamp.description '
<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>timestamp</parameter></term><listitem><para>
Der optionale Parameter <parameter>timestamp</parameter> ist ein Unix-Zeitstempel
vom Typ <type>int</type>. Falls <parameter>timestamp</parameter> nicht übergeben
wird oder &null; ist, wird die aktuelle lokale Zeit als Standardwert verwendet.
Er entspricht dann also dem Ergebnis der Funktion <function>time</function>.
</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Nur bei prozeduralem Aufruf: Ein von
<function>date_create</function> zurückgegebenes
<classname>DateTime</classname>-Objekt.</para></listitem></varlistentry>'>

<!ENTITY date.datetime.description.modified '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>object</parameter></term>
<listitem><para>Nur bei prozeduralem Aufruf: Ein von
<function>date_create</function> zurückgegebenes
<classname>DateTime</classname>-Objekt.
Diese Funktion verändert dieses Objekt.</para></listitem></varlistentry>'>

<!ENTITY date.datetimezone.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>object</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>date_create</function>
zurückgegebenes <classname>DateTimeZone</classname>-Objekt.</para></listitem></varlistentry>'>

<!ENTITY date.datetime.return.modifiedobjectorfalseforfailure 'Gibt das geänderte <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>-Objekt für die Methodenverkettung zurück. &return.falseforfailure;'>
<!ENTITY date.datetime.return.modifiedobject 'Gibt das geänderte <classname xmlns="http://docbook.org/ns/docbook">DateTime</classname>-Objekt für die Methodenverkettung zurück.'>
<!ENTITY date.datetimeimmutable.return.modifiedobjectorfalseforfailure 'Gibt ein neues <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname>-Objekt mit den geänderten Daten zurück. &return.falseforfailure;'>
<!ENTITY date.datetimeimmutable.return.modifiedobject 'Gibt ein neues <classname xmlns="http://docbook.org/ns/docbook">DateTimeImmutable</classname>-Objekt mit den geänderten Daten zurück.'>

<!ENTITY date.timezone.dbversion 'Diese Liste basiert auf der Version der Zeitzonen-Datenbank'>

<!ENTITY date.timezone.africa 'Afrika'>
<!ENTITY date.timezone.america 'Amerika'>
<!ENTITY date.timezone.antarctica 'Antarktis'>
<!ENTITY date.timezone.arctic 'Arktis'>
<!ENTITY date.timezone.asia 'Asien'>
<!ENTITY date.timezone.atlantic 'Atlantisch'>
<!ENTITY date.timezone.australia 'Australien'>
<!ENTITY date.timezone.europe 'Europa'>
<!ENTITY date.timezone.indian 'Indisch'>
<!ENTITY date.timezone.pacific 'Pazifisch'>
<!ENTITY date.timezone.others 'Andere'>
<!ENTITY date.timezone.abbreviations 'Abkürzungen'>

<!ENTITY date.formats '
Gültige Formate werden unter <link xmlns="http://docbook.org/ns/docbook" linkend="datetime.formats">Datums- und Zeitformate</link> erläutert.'>
<!ENTITY date.formats.parameter 'Ein Datums/Zeit Zeichenkette. &date.formats;'>

<!-- DomXml Notes -->
<!ENTITY node.inserted 'Dieser Knoten wird im Dokument erst dann angezeigt, wenn er mit (&zb;)
<function xmlns="http://docbook.org/ns/docbook">domnode_append_child</function> eingefügt wird.'>

<!-- Dom Notes -->
<!ENTITY dom.node.inserted 'Dieser Knoten wird im Dokument erst dann angezeigt, wenn er mit (&zb;)
<function xmlns="http://docbook.org/ns/docbook">DOMNode::appendChild</function> eingefügt wird.'>

<!ENTITY dom.malformederror '<para xmlns="http://docbook.org/ns/docbook">Auch wenn fehlerhaftes HTML erfolgreich laden sollte, kann diese Funktion dennoch Fehler der Stufe <constant>E_WARNING</constant> generieren, wenn sie auf falsches Markup stößt. Die <link linkend="function.libxml-use-internal-errors">Fehlerbehandlungsfunktionen von libxml</link> können genutzt werden, um diese Fehler zu behandeln.</para>'>
<!ENTITY dom.note.utf8 '<note xmlns="http://docbook.org/ns/docbook"><para>Die Erweiterung DOM verwendet die UTF-8 Kodierung. Es kann <function>mb_convert_encoding</function>, <methodname>UConverter::transcode</methodname> oder <function>iconv</function> verwendet werden, um mit anderen Zeichenkodierungen zu arbeiten.</para></note>'>
<!ENTITY dom.note.json '<note xmlns="http://docbook.org/ns/docbook"><para>Wird <function>json_encode</function> auf ein <classname>DOMDocument</classname>-Objekt angewendet, entspricht das dem Kodieren eines leeren Objekts.</para></note>'>
<!ENTITY dom.domdocument.html5 '<warning xmlns="http://docbook.org/ns/docbook">
 <para>
  Diese Funktion analysiert die Eingabe mit einem HTML 4-Parser. HTML 5, das
  von modernen Webbrowsern verwendet wird, hat andere Parsing-Regeln. Je nach
  Eingabe kann dies zu einer anderen DOM-Struktur führen, weshalb diese
  Funktion nicht bedenkenlos zur Bereinigung von HTML verwendet werden kann.
 </para>
 <para>
  Das Verhalten beim Analysieren von HTML kann von der verwendeten Version von
  <literal>libxml</literal> abhängen, insbesondere in Bezug auf die
  Randbedingungen und die Fehlerbehandlung.
  Für Analysen, die der HTML5-Spezifikation entsprechen, sollte eine der in
  PHP 8.4 eingeführten Methoden
  <methodname>Dom\HTMLDocument::createFromString</methodname> oder
  <methodname>Dom\HTMLDocument::createFromFile</methodname> verwendet werden.
 </para>
 <para>
  Beispielsweise schließen einige HTML-Elemente implizit ein übergeordnetes
  Element, wenn sie darauf treffen. Die Regeln für das automatische Schließen
  übergeordneter Elemente unterscheiden sich zwischen HTML 4 und HTML 5, sodass
  die resultierende DOM-Struktur, die <classname>DOMDocument</classname> sieht,
  sich von der DOM-Struktur unterscheiden kann, die ein Webbrowser sieht.
 </para>
</warning>'>

<!-- Dom Examples -->
<!ENTITY dom.book.example '<para xmlns="http://docbook.org/ns/docbook">Die folgenden Beispiele verwenden <filename>book.xml</filename> mit dem folgenden Inhalt:</para>
<programlisting role="xml" xmlns="http://docbook.org/ns/docbook">
<!-- Achtung: Das CDATA-Markup hier ist ein wenig kompliziert. Bitte stellen Sie sicher, dass Sie es nicht zerstören. -->
<![CDATA[
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE books [
  <!ELEMENT books   (book+)>
  <!ELEMENT book    (title, author+, xhtml:blurb?)>
  <!ELEMENT title   (#PCDATA)>
  <!ELEMENT blurb   (#PCDATA)>
  <!ELEMENT author  (#PCDATA)>
  <!ATTLIST books   xmlns        CDATA  #IMPLIED>
  <!ATTLIST books   xmlns:xhtml  CDATA  #IMPLIED>
  <!ATTLIST book    id           ID     #IMPLIED>
  <!ATTLIST author  email        CDATA  #IMPLIED>
]>
<?xml-stylesheet type="text/xsl" href="style.xsl"?>
<books xmlns="http://books.php/" xmlns:xhtml="http://www.w3.org/1999/xhtml">
  <book id="php-basics">
    <title>PHP Basics</title>
    <author email="jim.smith@basics.php">Jim Smith</author>
    <author email="jane.smith@basics.php">Jane Smith</author>
    <xhtml:blurb><![CDATA[
<p><em>PHP Basics</em> provides an introduction to PHP.</p>
]]]]><![CDATA[></xhtml:blurb>
  </book>
  <book id="php-advanced">
    <title>PHP Advanced Programming</title>
    <author email="jon.doe@advanced.php">Jon Doe</author>
  </book>
</books>
]]></programlisting>'>

<!-- Dom entities -->
<!ENTITY dom.parameter.options '<para xmlns="http://docbook.org/ns/docbook">
  <link linkend="language.operators.bitwise">Bitweises <literal>OR</literal></link>
  von <link linkend="libxml.constants">libxml-Konstanten</link> für weitere Optionen.
</para>'>

<!ENTITY dom.parameters.register_node_ns '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>registerNodeNS</parameter></term>
 <listitem>
  <para>
   Legt fest, ob die Namensraum-Präfixe innerhalb des Geltungsbereichs des Kontextknotens automatisch im <classname>DOMXPath</classname>-Objekt registriert werden sollen.
   Dies kann verwendet werden, damit <methodname>DOMXPath::registerNamespace</methodname> nicht manuell für jeden Namensraum innerhalb des Geltungsbereichs aufgerufen werden muss.
Wenn es einen Konflikt zwischen Namensraum-Präfixen gibt, wird nur das in der Reihenfolge nächste Namensraum-Präfix registriert.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.parent '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   Wird ausgelöst, wenn der Elternteil von einem Typ ist, der keine Kinder vom
   Typ eines der übergebenen <parameter>nodes</parameter> zulässt, oder wenn
   der einzufügende Knoten einer der Vorfahren dieses Knotens oder dieser
   Knoten selbst ist.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.hierarchy.self '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_HIERARCHY_REQUEST_ERR</constant></term>
  <listitem>
  <para>
   Wird ausgelöst, wenn dieser Knoten von einem Typ ist, der keine Kinder vom
   Typ eines der übergebenen <parameter>nodes</parameter> zulässt, oder wenn
   der einzufügende Knoten einer der Vorfahren dieses Knotens oder dieser
   Knoten selbst ist.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.errors.wrong_document '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><constant>DOM_WRONG_DOCUMENT_ERR</constant></term>
  <listitem>
  <para>
   Wird ausgelöst, wenn einer der übergebenen <parameter>nodes</parameter> aus
   einem anderen Dokument erstellt wurde als dem, das diesen Knoten erstellt hat.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY dom.changelog.previous_hierarchy_exception 'Zuvor führte dies zu einer
 <classname xmlns="http://docbook.org/ns/docbook">DOMException</classname> mit dem
 Code <constant xmlns="http://docbook.org/ns/docbook">DOM_HIERARCHY_REQUEST_ERR</constant>.'>

<!ENTITY dom.c14n.xpath_array '<listitem xmlns="http://docbook.org/ns/docbook">
  <para>
   Ein Array von XPath-Ausdrücken, nach denen die Knoten gefiltert werden.
   Jeder Eintrag in diesem Array ist ein assoziatives Array mit
   <itemizedlist>
    <listitem>
     <simpara>
      dem erforderlichen Schlüssel <literal>query</literal>, der den XPath-Ausdruck als Zeichenkette enthält.
     </simpara>
    </listitem>
    <listitem>
     <simpara>
      dem optionalen Schlüssel namespaces, der ein Array enthält, das Namensraum-Präfixe (Schlüssel) auf Namensraum-URIs (Werte) abbildet.
     </simpara>
    </listitem>
   </itemizedlist>
  </para>
 </listitem>'>

<!-- FileSystem entities -->
<!ENTITY fs.emits.warning.on.failure '<para xmlns="http://docbook.org/ns/docbook">
Im Fehlerfall wird eine <constant>E_WARNING</constant> ausgegeben.
</para>'>

<!ENTITY fs.validfp.all '<para xmlns="http://docbook.org/ns/docbook">Der Zeiger auf eine Datei muss gültig sein und
auf eine Datei verweisen, die vorher erfolgreich mit <function>fopen</function>
oder <function>fsockopen</function> geöffnet (und nicht bereits von
<function>fclose</function> geschlossen) wurde.</para>'>

<!ENTITY fs.file.pointer '<para xmlns="http://docbook.org/ns/docbook">Eine Dateisystemressource (<type>resource</type>),
wie sie in der Regel von <function>fopen</function> zurückgegeben
wird.</para>'>

<!ENTITY fs.file.32bit '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Weil PHPs Integer Typ vorzeichenbehaftet ist und viele Platformen 32bit Integer
verwenden, können einige Dateisystem-Funktionen für Dateien größer als 2GB unerwartete
Ergebnisse liefern.
</simpara></note>'>

<!ENTITY ini.scanner.typed '<para xmlns="http://docbook.org/ns/docbook">
    Seit PHP 5.6.1 kann auch <constant>INI_SCANNER_TYPED</constant> angegeben werden.
    In diesem Modus werden soweit möglich die Typen von Boolean-, Null- oder Integer-Werten
    beibehalten. Die Zeichenketten <literal>"true"</literal>, <literal>"on"</literal> und
    <literal>"yes"</literal> werden zu &true; konvertiert. <literal>"false"</literal>,
    <literal>"off"</literal>, <literal>"no"</literal> und <literal>"none"</literal> werden
    als &false; angesehen. <literal>"null"</literal> wird in diesem Modus zu &null;.
    Soweit möglich werden alle numerischen Zeichenketten zu Integertypen umgewandelt.
   </para>'>


<!-- GNUPG -->
<!ENTITY gnupg.identifier '<para xmlns="http://docbook.org/ns/docbook">Eine von <function>gnupg_init</function>
oder der Klasse <classname>gnupg</classname> zurückgegebene
GnuPG-Ressource.</para>'>

<!ENTITY gnupg.fingerprint "<para xmlns='http://docbook.org/ns/docbook'>Der 'Fingerprint'-Schlüssel.</para>">

<!-- HaruDoc -->
<!ENTITY haru.error '<para xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>HaruException</classname> bei Fehlern.</para>'>

<!-- ODBC -->
<!ENTITY odbc.connection.id '<para xmlns="http://docbook.org/ns/docbook">Eine ODBC-Verbindungsressource,
siehe <function>odbc_connect</function> für Details.</para>'>

<!ENTITY odbc.parameter.catalog 'Der Katalog (&apos;Kennzeichner&apos; in ODBC 2 Terminologie).'>

<!ENTITY odbc.parameter.schema 'Das Schema (&apos;Besitzer&apos; in ODBC 2 Terminologie).'>

<!ENTITY odbc.parameter.search 'Dieser Parameter akzeptiert die
folgenden Suchmuster: <literal xmlns="http://docbook.org/ns/docbook">&#x25;</literal> für 0 oder mehr Zeichen und <literal xmlns="http://docbook.org/ns/docbook">_</literal>
für genau ein beliebiges Zeichen.'>

<!ENTITY odbc.result.driver-specific 'Treiber können zusätzliche Spalten melden.'>

<!-- OAUTH -->
<!ENTITY oauth.callback.error 'Gibt einen Fehler der Stufe <constant xmlns="http://docbook.org/ns/docbook">E_ERROR</constant>
aus, wenn die Callback-Funktion nicht aufgerufen werden kann oder nicht angegeben wurde.'>

<!ENTITY oauth.changelog.error.null 'Gab früher bei einem Fehler &null; anstelle von &false; zurück.'>

<!-- Oracle -->
<!ENTITY oci.db '<para xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 Beinhaltet die <literal>Oracle-Instanz</literal>, mit der verbunden werden
 soll. Dies kann eine <link
 xlink:href="&url.oracle.oic.connect;">Easy-Connect-Zeichenkette</link>, ein
 Connect-Name aus der Datei <filename>tnsnames.ora</filename> oder der Name
 einer lokalen Oracle-Instanz sein.
</para>
<para xmlns="http://docbook.org/ns/docbook">Wenn dies nicht angegebe wird oder
 &null; ist, verwendet PHP Umgebungsvariablen wie <constant>TWO_TASK</constant>
 (unter Linux), <constant>LOCAL</constant> (unter Windows) oder
 <constant>ORACLE_SID</constant> um die <literal>Oracle-Instanz</literal> zu
 ermitteln, mit der verbunden werden soll.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Um die benannte Easy Connect Methode zu verwenden, muss PHP gegen die
 Clientbibliotheken von Oracle 10<emphasis>g</emphasis> oder höher gelinkt
 sein. Die Easy-Connect-Zeichenkette für Oracle 10<emphasis>g</emphasis> hat
 den Aufbau: <emphasis>[//]host_name[:port][/service_name]</emphasis>. Für
 Oracle 11<emphasis>g</emphasis> ist die Syntax:
 <emphasis>[//]host_name[:port][/service_name][:server_type][/instance_name]</emphasis>.
 Weitere Optionen wurden mit Oracle 19c eingeführt, darunter die timeout- und
 die keep-alive-Einstellungen. Siehe dazu die Oracle-Dokumentation. Die
 Servicenamen können ermittelt werden, indem man das Oracle-Hilfswerkzeug
 <literal>lsnrctl status</literal> auf dem Datenbankserver ausführt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Die Datei <filename>tnsnames.ora</filename> kann sich im Oracle Net Suchpfad
 befinden, welcher
 <filename>/der/pfad/zu/instantclient/network/admin</filename>,
 <filename>$ORACLE_HOME/network/admin</filename> sowie
 <filename>/etc</filename> beinhaltet. Alternativ kann
 <literal>TNS_ADMIN</literal> so gesetzt werden, dass
 <filename>$TNS_ADMIN/tnsnames.ora</filename> gelesen wird. Es muss
 sichergestellt sein, dass der Webserver eine Leseberechtigung für die Datei
 besitzt.
</para>'>

<!ENTITY oci.charset '<para xmlns="http://docbook.org/ns/docbook">
Bestimmt den Zeichensatz, der von den Oracle Client Bibliotheken verwendet
wird. Dieser Zeichensatz muss nicht dem von der Datenbank verwendeten
Zeichensatz entsprechen. Wenn diese nicht übereinstimmen, wird Oracle
bestmöglich versuchen, die Daten in den Datenbankzeichensatz zu
übersetzen. Abhängig von den Zeichensätzen kann dies zu unbrauchbaren
Ergebnissen führen. Diese Konvertierung führt auch zu einem erhöhten
Zeitbedarf.
</para>
<para xmlns="http://docbook.org/ns/docbook">Falls nicht angegeben, werden
die Oracle Client Bibliotheken versuchen, den Zeichensatz aus der
Umgebungsvariablen <constant>NLS_LANG</constant> auszulesen.
</para>
<para xmlns="http://docbook.org/ns/docbook">Die Übergabe dieses Parameters
verringert die Zeit für den Verbindungsaufbau.
</para>'>

<!ENTITY oci.sessionmode '<para xmlns="http://docbook.org/ns/docbook">Dieser
Parameter ist seit PHP 5 (PECL OCI8 1.1) verfügbar und akzeptiert
die folgenden Werte: <constant>OCI_DEFAULT</constant>,
<constant>OCI_SYSOPER</constant> und <constant>OCI_SYSDBA</constant>.
Falls entweder <constant>OCI_SYSOPER</constant> oder
<constant>OCI_SYSDBA</constant> angegeben wurden wird diese Funktion
versuchen die priviligierte Verbindung mit externen Credentials aufzubauen.
Um diese einzuschalten muss man
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
auf <literal>On</literal> setzen.
</para>
<para xmlns="http://docbook.org/ns/docbook">
PHP 5.3 (PECL OCI8 1.3.4) hat den Wert <constant>OCI_CRED_EXT</constant>
eingeführt. Dies konfiguriert Oracle dazu eine externe oder
Os-Authentifizierung vorzunehmen, welche in der Datenbank konfiguriert
werden muss. Der Schalter <constant>OCI_CRED_EXT</constant> kann nur mit
dem Benutzernamen &quot;/&quot; und einem leeren Passwort verwendet werden.
<link linkend="ini.oci8.privileged-connect">oci8.privileged_connect</link>
kann entweder <literal>On</literal> oder <literal>Off</literal> sein.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> kann mit
<constant>OCI_SYSOPER</constant> oder
<constant>OCI_SYSDBA</constant> kombiniert werden.
</para>
<para xmlns="http://docbook.org/ns/docbook">
<constant>OCI_CRED_EXT</constant> ist auf Windows-Systemen aus
sicherheitsgründen nicht unterstützt.
</para>'>

<!ENTITY oci.datatypes '<para xmlns="http://docbook.org/ns/docbook">Für Details zur vom OCI8-Treiber durchgeführten
Umsetzung von Datentypen siehe die
<link linkend="oci8.datatypes">vom Treiber unterstützen Datentypen</link>.</para>'>

<!ENTITY oci.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">
Ein Oracle-Verbindungs-Identifiierer, der von <function>oci_connect</function>,
<function>oci_pconnect</function>, oder <function>oci_new_connect</function>
zurückgegeben wurde.</para>'>

<!ENTITY oci.availability.note.10g '<note xmlns="http://docbook.org/ns/docbook"><title>Oracle Versionsanforderungen</title>
<para>Diese Funktion ist verfügbar, wenn PHP gegen die Bibliotheken der
Oracle-Datenbank in Version 10<emphasis>g</emphasis> und höher gelinkt ist.</para></note>'>

<!ENTITY oci.clientinfo.tip '<tip xmlns="http://docbook.org/ns/docbook"><title>Performance</title>
<para>Bei älteren Versionen von OCI8 oder der Oracle-Datenbank können die Client-
Informationen mit einem <literal>DBMS_APPLICATION_INFO</literal>-Paket gesetzt werden.
Dies ist weniger effizient als die Verwendung von <function>oci_set_client_info</function>.</para></tip>'>

<!ENTITY oci.roundtrip.caution '<caution xmlns="http://docbook.org/ns/docbook"><title>Roundtrip Hinweis</title>
<para>Einige, aber nicht alle OCI8-Funktionen verursachen Roundtrips. Roundtrips zur
Datenbank dürfen nicht für Queries auftreten, wenn der Ergebniscache aktiviert ist.</para></caution>'>

<!ENTITY oci.use.setprefetch '<para xmlns="http://docbook.org/ns/docbook">Bei
Queries, die eine große Anzahl an Zeilen zurückgeben, kann die Laufzeit beträchtlich
verbessert werden, indem man
<link linkend="ini.oci8.default-prefetch">oci8.default_prefetch</link> erhöht oder
<function>oci_set_prefetch</function> verwendet.
</para>'>


<!ENTITY oci.arg.statement.id
"<para xmlns='http://docbook.org/ns/docbook'>Der Identifizierer eines
gültigen OCI8-Ausdrucks, der von <function>oci_parse</function> erzeugt
und von <function>oci_execute</function> oder einem <literal>REF
CURSOR</literal>-Ausdruck verwendet wird.</para>">

<!-- PCNTL Notes -->
<!ENTITY pcntl.parameter.status '<para xmlns="http://docbook.org/ns/docbook">Der <parameter>status</parameter>-Parameter
entspricht dem Statusparameter, der für einen erfolgreichen Aufruf
von <function>pcntl_waitpid</function> verwendet wird.</para>'>

<!-- PS Notes -->
<!ENTITY ps.note.visible '<para xmlns="http://docbook.org/ns/docbook">Diese Notiz
wird nicht sichtbar sein, wenn das Dokument gedruckt oder betrachtet wird. Sie
wird aber sichtbar sein, wenn das Dokument entweder mit Acrobat Distiller™
oder Ghostview zu PDF konvertiert wird.</para>'>

<!-- Notes for safe-mode limited functions: -->

<!-- Not used in EN anymore -->
<!ENTITY note.sm.disabled '<note xmlns="http://docbook.org/ns/docbook"><simpara>&sm.disabled;</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck '<note xmlns="http://docbook.org/ns/docbook"><simpara>Wenn <link
linkend="features.safe-mode">Safe Mode</link> aktiviert ist, überprüft PHP,
ob die Dateien/Verzeichnisse, die mit dem Skript bearbeitet werden sollen,
die gleiche UID (Eigentümer) haben wie das Skript selbst.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY note.sm.uidcheck.dir '<note xmlns="http://docbook.org/ns/docbook"><simpara>Wenn
<link linkend="features.safe-mode">Safe Mode</link> aktiviert ist überprüft PHP,
ob das Arbeitsverzeichnis, die gleiche UID (Eigentümer) hat wie das Skript
selbst.</simpara></note>'>

<!ENTITY note.open-basedir.func '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion wird von
<link linkend="ini.open-basedir">open_basedir</link> beeinflusst.</para></note>'>


<!ENTITY note.language-construct '<note xmlns="http://docbook.org/ns/docbook"><simpara>Da dies ein Sprachkonstrukt
und keine Funktion ist, können Sie dieses nicht mit
<link linkend="functions.variable-functions">Variablenfunktionen</link> oder
<link linkend="functions.named-arguments">benannten Parametern</link> verwenden.
</simpara></note>'>

<!-- Common pieces in features/safe-mode.xml
     Jade doesn't allow in-line entities, so I put them here... Though they
     should have been inline in safe-mode.xml -->

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck 'Überprüft ob die Dateien/Verzeichnisse, die mit dem Skript
bearbeitet werden sollen, die gleiche UID (Eigentümer) haben wie das Skript
selbst.'>

<!-- Not used in EN anymore -->
<!ENTITY warn.sm.exec '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Mit aktiviertem
<link linkend="features.safe-mode">Safe Mode</link> wird der Kommandostring
mit <function>escapeshellcmd</function> kodiert. Deshalb wird
<literal>echo y | echo x</literal> zu <literal>echo y \| echo x</literal>.</simpara></warning>'>

<!-- Not used in EN anymore -->
<!ENTITY note.exec-path '<note xmlns="http://docbook.org/ns/docbook"><simpara>Mit aktiviertem
<link linkend="features.safe-mode">Safe Mode</link> können Sie nur Programme
ausführen, die im Verzeichnis liegen, das mit
<link linkend="ini.safe-mode-exec-dir">safe_mode_exec_dir</link> angegeben wurde.
Aus praktischen Gründen ist es gegenwärtig nicht erlaubt, dass der Pfad zu einem
Programm <literal>..</literal> enthält.</simpara></note>'>

<!-- Not used in EN anymore -->
<!ENTITY sm.uidcheck.dir 'Überprüft, ob das Verzeichnis, in dem das Skript
ausgeführt werden soll, die gleiche UID (Eigentümer) hat wie das Skript selbst.'>

<!-- Not used in EN anymore -->
<!ENTITY sm.disabled 'Diese Funktion steht im <link xmlns="http://docbook.org/ns/docbook"
linkend="features.safe-mode">Safe Mode</link> nicht zur Verfügung.'>

<!-- Common pieces in partintro-sections -->
<!ENTITY no.config '<para xmlns="http://docbook.org/ns/docbook">Diese Erweiterung definiert keine Konfigurationseinstellungen in der &php.ini;.</para>'>
<!ENTITY no.resource '<para xmlns="http://docbook.org/ns/docbook">Diese Erweiterung definiert keine Ressource-Typen.</para>'>
<!ENTITY no.constants '<para xmlns="http://docbook.org/ns/docbook">Diese Erweiterung definiert keine Konstanten.</para>'>
<!ENTITY no.requirement '<para xmlns="http://docbook.org/ns/docbook">Diese Erweiterung benötigt für die Kompilierung keine externen Bibliotheken.</para>'>
<!ENTITY no.install '<para xmlns="http://docbook.org/ns/docbook">Für diese Funktionen ist keine Installation erforderlich,
diese gehören zum Grundbestand von PHP.</para>'>

<!-- Used in every chapter that has directive descriptions -->
<!ENTITY ini.descriptions.title '<para xmlns="http://docbook.org/ns/docbook">Hier eine kurze Erklärung der
Konfigurationsoptionen:</para>'>

<!-- Common pieces for reference part BEGIN-->

<!-- Used in reference/$extname/ini.xml -->
<!ENTITY extension.runtime '<simpara xmlns="http://docbook.org/ns/docbook">Das Verhalten dieser Funktionen wird
durch Einstellungen in der &php.ini; beeinflusst.</simpara>'>

<!ENTITY ini.php.constants 'Weitere Details und die Definitionen der
INI_*-Konstanten sind unter <xref xmlns="http://docbook.org/ns/docbook" linkend="configuration.changes.modes"/> zu finden.'>

<!-- Used in reference/$extname/constants.xml -->
<!ENTITY extension.constants '<simpara xmlns="http://docbook.org/ns/docbook">Folgende Konstanten werden von dieser
Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung entweder
statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen
wurde.</simpara>'>

<!-- For STANDARD Constants used in reference/$extname/constants.xml -->
<!ENTITY extension.constants.core '<simpara xmlns="http://docbook.org/ns/docbook">Die aufgelisteten Konstanten
stehen immer zur Verfügung, da sie zum Grundbestand von PHP gehören.</simpara>'>

<!-- Used in reference/$extname/classes.xml -->
<!ENTITY extension.classes '<simpara xmlns="http://docbook.org/ns/docbook">Folgende Klassen werden von dieser
Erweiterung definiert und stehen nur zur Verfügung, wenn die Erweiterung
entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen
wurde.</simpara>'>

<!ENTITY note.extension.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Diese Erweiterung benötigt PHP 5.</simpara></note>'>

<!-- PDO entities -->
<!ENTITY pdo.driver-constants '<simpara xmlns="http://docbook.org/ns/docbook">Die folgenden Konstanten werden von
diesem Treiber definiert und sind nur verfügbar, wenn die Erweiterung entweder
in PHP einkompiliert oder dynamisch zur Laufzeit geladen wurde. Darüber hinaus
sind diese Konstanten treiberspezifisch und sollten nur mit diesem Treiber
benutzt werden. Treiberspezifische Attribute mit einem anderen Treiber zu
nutzen, kann zu unerwarteten Ergebnissen führen. Wenn der Code mit
verschiedenen Treibern funktioniert, kann
<function>PDO::getAttribute</function> verwendet werden, um mit
<constant>PDO::ATTR_DRIVER_NAME</constant> den aktuellen Treiber zu
ermitteln.</simpara>'>

<!ENTITY pdo.errors.exception-not-errmode '<note xmlns="http://docbook.org/ns/docbook"><simpara>Eine Exception wird auch dann ausgelöst, wenn das Attribut <constant>PDO::ATTR_ERRMODE</constant> nicht <constant>PDO::ERRMODE_EXCEPTION</constant> ist.</simpara></note>'>

<!-- PDO errors -->

<!ENTITY pdo.errors '<para xmlns="http://docbook.org/ns/docbook">
Gibt einen Fehler der Stufe <constant>E_WARNING</constant> aus, wenn das Attribut <constant>PDO::ATTR_ERRMODE</constant>
auf <constant>PDO::ERRMODE_WARNING</constant> gesetzt ist.
</para>
<para xmlns="http://docbook.org/ns/docbook">
Löst eine <classname>PDOException</classname> aus, wenn das Attribut <constant>PDO::ATTR_ERRMODE</constant>
auf <constant>PDO::ERRMODE_EXCEPTION</constant> gesetzt ist.
</para>'>

<!-- PECL entities -->
<!ENTITY pecl.moved 'Diese &link.pecl;-Erweiterung ist nicht Teil von PHP.'>

<!ENTITY pecl.bundled 'Diese &link.pecl;-Erweiterung ist Teil von PHP.'>

<!ENTITY pecl.info 'Information zur Installation dieser PECL-Erweiterung
finden sie im Kapitel <link xmlns="http://docbook.org/ns/docbook" linkend="install.pecl">Installation von PECL-Erweiterungen</link>.
Zusätzliche Informationen wie neue Releases, Downloads,
Quelldateien, Maintainerinformation und ein CHANGELOG finden Sie hier: '>

<!ENTITY pecl.info.dead 'Diese Erweiterung wird als nicht mehr gepflegt betrachtet
und es gibt dort keine Aktivität mehr. Der Quellcode für diese Erweiterung steht jedoch weiterhin innerhalb des
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>
<acronym xmlns="http://docbook.org/ns/docbook">SVN</acronym> hier zur Verfügung:'>

<!ENTITY pecl.info.dead.git 'Diese Erweiterung wird nicht mehr gepflegt und gilt als tot. Der Quellcode für
diese Erweiterung ist jedoch weiterhin im
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>-<acronym xmlns="http://docbook.org/ns/docbook">GIT</acronym>  verfügbar: '>

<!ENTITY pecl.windows.download 'Eine <acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-Datei für diese
<acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>-Erweiterung steht derzeit nicht zur Verfügung.
Weitere Details finden Sie im Abschnitt zum
<link xmlns="http://docbook.org/ns/docbook" linkend="install.windows.building">Kompilieren für Windows</link>.'>

<!ENTITY pecl.windows.download.avail 'Windows-Binaries
(<acronym xmlns="http://docbook.org/ns/docbook">DLL</acronym>-Dateien) für
diese <acronym xmlns="http://docbook.org/ns/docbook">PECL</acronym>-Erweiterung
sind auf der PECL-Website erhältlich.'>

<!ENTITY pecl.windows.download.unbundled '&pecl.windows.download;'>

<!ENTITY pecl.moved-ver 'Diese Erweiterung wurde ins &link.pecl;-Repositorium
verschoben und ist nicht mehr Teil von PHP ab PHP '>

<!-- PGSQL entities -->

<!ENTITY pgsql.parameter.connection '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PgSql\Connection</classname>-Instanz.</para>'>

<!ENTITY pgsql.parameter.connection-with-unspecified-default '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PgSql\Connection</classname>-Instanz.
Falls <parameter>connection</parameter> nicht angegeben wurde, wird die Standardverbindung benutzt.
Das ist die zuletzt mit <function>pg_connect</function> oder <function>pg_pconnect</function> aufgebaute Verbindung.
<warning><simpara>Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.connection-with-nullable-default '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PgSql\Connection</classname>-Instanz.
Falls <parameter>connection</parameter> &null; ist, wird die Standardverbindung benutzt.
Das ist die zuletzt mit <function>pg_connect</function> oder <function>pg_pconnect</function> aufgebaute Verbindung.
<warning><simpara>Seit PHP 8.1.0 ist die Verwendung der Standardverbindung veraltet.</simpara></warning></para>'>

<!ENTITY pgsql.parameter.result '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PgSql\Result</classname>-Instanz, die von <function>pg_query</function>,
<function>pg_query_params</function> oder <function>pg_execute</function> (unter anderen) zurückgegeben wurde.</para>'>

<!ENTITY pgsql.parameter.lob '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>PgSql\Lob</classname>-Instanz, die von <function>pg_lo_open</function> zurückgegeben wurde.</para>'>

<!ENTITY pgsql.parameter.mode '<para xmlns="http://docbook.org/ns/docbook">
Ein optionaler Parameter, der bestimmt, wie das zurückgegebene <type>&array;</type> indiziert werden soll.
<parameter>mode</parameter> ist eine Konstante, die einen der folgenden Werte annehmen kann:
<constant>PGSQL_ASSOC</constant>, <constant>PGSQL_NUM</constant> und <constant>PGSQL_BOTH</constant>.
Wenn die Funktion mit <constant>PGSQL_NUM</constant> aufgerufen wird, wird ein Array mit numerischen Indizes zurückgegeben,
mit <constant>PGSQL_ASSOC</constant> wird ein Array mit assoziatives Indizes zurückgegeben
und mit <constant>PGSQL_BOTH</constant> ein Array mit beiden Indizes.</para>'>

<!ENTITY pgsql.changelog.connection-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>connection</parameter> erwartet nun eine <classname>PgSql\Connection</classname>-Instanz;
  vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>result</parameter> erwartet nun eine <classname>PgSql\Result</classname>-Instanz;
  vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.lob-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>lob</parameter> erwartet nun eine <classname>PgSql\Lob</classname>-Instanz;
  vorher wurde eine &resource; erwartet.
 </entry>
</row>'>

<!ENTITY pgsql.changelog.return-result-object '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Gibt nun eine <classname>PgSql\Result</classname>-Instanz zurück;
  vorher wurde eine &resource; zurückgegeben.
 </entry>
</row>'>

<!-- Common pieces for reference part END -->

<!ENTITY windows.builtin '<simpara xmlns="http://docbook.org/ns/docbook">Die Windowsversion von PHP enthält diese
Erweiterung. Um diese Funktionen zu verwenden, müssen Sie keine zusätzlichen
Erweiterungen aktivieren.</simpara>'>

<!-- These are here as helpers for manual consistency and brievety-->
<!ENTITY safemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.safe-mode">Safe Mode</link>'>

<!ENTITY sqlsafemode '<link xmlns="http://docbook.org/ns/docbook" linkend="ini.sql.safe-mode">SQL safe mode</link>'>

<!-- APD Notes -->
<!ENTITY apd.debug-level.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>debug_level</parameter></term><listitem><para>Ein aus der Addition von
<literal>XXX_TRACE</literal>-Konstanten gewonnener Integerwert.</para>
<para>. Von der Verwendung der <constant>MEMORY_TRACE</constant>-Konstante
wird abgeraten, da diese die Ausführung sehr verlangsamt und keine genauen
Ergebnisse zu liefern scheint. <constant>ASSIGNMENT_TRACE</constant> ist
noch nicht implementiert.</para><para>Um alle funktioierenden Traces
(TIMING, FUNCTIONS, ARGS SUMMARY (ähnlich zu strace -c)) zu aktivieren,
benutzen Sie den Wert 99</para></listitem></varlistentry>'>

<!-- BCMath Notes -->
<!ENTITY bc.scale.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>scale</parameter></term><listitem><para>Dieser optionale Parameter
kann benutzt werden, um die Anzahl der Nachkommastellen im Ergebnis
festzulegen. Sie können mit Hilfe der <function>bcscale</function>-Funktion
auch einen globalen Vorgabewert für alle Funktionen
festlegen.</para></listitem></varlistentry>'>

<!-- CTYPE Notes -->
<!ENTITY note.ctype.parameter.integer '<note xmlns="http://docbook.org/ns/docbook"><para>
Wenn ein <type>int</type> zwischen -128 und 255 (inklusive) übergeben wird, wird dieser als
ASCII-Wert eines einzelnen Buchstabens interpretiert (zu negativen Werten wird 256 dazu addiert,
um Buchstaben des erweiterten ASCII-Zeichensatzes zu erlauben). Alle anderen Integer werden wie
eine Zeichenkette interpretiert, welche die dezimalen Ziffern des Integers enthält.</para></note>'>

<!ENTITY note.ctype.parameter.non-string '<warning xmlns="http://docbook.org/ns/docbook"><para>
Seit PHP 8.1.0 ist die Übergabe eines Nicht-String-Arguments veraltet. In
Zukunft wird das Argument statt als ASCII-Codepunkt als String interpretiert
werden. Je nach beabsichtigtem Verhalten sollte das Argument entweder in &string;
umgewandelt werden, oder es sollte ein expliziter Aufruf von
<function>chr</function> erfolgen.</para></warning>'>

<!ENTITY ctype.result.empty-string 'Bei einem Aufruf mit einer leeren Zeichenkette wird immer &false; zurückgegeben.'>

<!-- FTP Notes -->
<!ENTITY ftp.changelog.ftp-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.1.0</entry>
 <entry>
  Der Parameter <parameter>ftp</parameter> erwartet nun eine
  <classname>FTP\Connection</classname>-Instanz; vorher wurde eine &resource;
  erwartet.
 </entry>
</row>'>
<!ENTITY ftp.parameter.ftp '<para xmlns="http://docbook.org/ns/docbook">Eine <classname>FTP\Connection</classname>-Instanz.</para>'>

<!-- GMP Notes -->
<!ENTITY gmp.return 'Ein <classname xmlns="http://docbook.org/ns/docbook">GMP</classname>-Objekt.'>
<!ENTITY gmp.parameter '<para xmlns="http://docbook.org/ns/docbook">Ein <classname>GMP</classname>-Object, ein &integer; oder eine numeriche Zeichenkette.</para>'>

<!-- MySQLi Notes -->
<!ENTITY mysqli.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: Ein von <function>mysqli_query</function>,
<function>mysqli_store_result</function>, <function>mysqli_use_result</function> oder
<function>mysqli_stmt_get_result</function> zurückgegebenes <classname>mysqli_result</classname>-Objekt.</para></listitem></varlistentry>'>
<!ENTITY mysqli.link.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mysql</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: ein von
<function>mysqli_connect</function> oder <function>mysqli_init</function>
zurückgegebenes <classname>mysqli</classname>-Objekt.</para></listitem></varlistentry>'>
<!ENTITY mysqli.stmt.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>statement</parameter></term><listitem><para>Nur bei prozeduralem Aufruf: ein von
<function>mysqli_stmt_init</function> zurückgegebenes
<classname>mysqli_stmt</classname>-Objekt.</para></listitem></varlistentry>'>
<!ENTITY mysqli.available.mysqlnd 'Nur in <link xmlns="http://docbook.org/ns/docbook"
linkend="book.mysqlnd">mysqlnd</link> verfügbar.'>
<!ENTITY mysqli.charset.note '<note xmlns="http://docbook.org/ns/docbook">
<para>MySQLnd nimmt immer den Standardzeichensatz des Servers an. Dieser Zeichensatz wird während
des Aufbaus der Verbindung bzw. der Authentifizierung übermittelt und danach von MySQLnd verwendet.
</para><para>Libmysqlclient verwendet als Standardzeichensatz den, der in der Datei
<filename>my.cnf</filename> angegeben oder durch einen Aufruf von <function>mysqli_options</function>
vor dem Aufruf von <function>mysqli_real_connect</function> aber nach
<function>mysqli_init</function> gesetzt wurde.</para></note>'>
<!ENTITY mysqli.integer.overflow.as.string.note '<note xmlns="http://docbook.org/ns/docbook">
<para>Wenn die Anzahl der Zeilen größer ist als <constant>PHP_INT_MAX</constant>,
wird die Anzahl als &string; zurückgegeben.</para></note>'>
<!ENTITY mysqli.sqlinjection.warning '<warning xmlns="http://docbook.org/ns/docbook">
<title>Sicherheitswarnung: SQL-Injection</title><para>Wenn die Abfrage
irgendwelche Eingabevariablen enthält, sollten stattdessen
<link linkend="mysqli.quickstart.prepared-statements">parametrisierte Prepared Statements</link>
verwendet werden. Alternativ dazu müssen die Daten korrekt formatiert sein und
alle Strings müssen mit der Funktion
<function>mysqli_real_escape_string</function> maskiert werden.</para></warning>'>

<!-- Notes for PCRE -->
<!ENTITY pcre.pattern.warning '<para xmlns="http://docbook.org/ns/docbook">
Wenn das übergebene Regex-Muster nicht zu einem gültigen Regex kompiliert werden
kann, wird ein Fehler der Stufe <constant>E_WARNING</constant> ausgegeben.
</para>'>

<!-- Notes for SAPI/Apache -->
<!ENTITY apache.req.module '<simpara xmlns="http://docbook.org/ns/docbook">
 Diese Funktion wird unterstützt, wenn PHP als Apache-Modul installiert wurde.
</simpara>'>

<!-- Notes for SAPI/FPM -->
<!ENTITY fpm.intro '<para xmlns="http://docbook.org/ns/docbook">FPM (FastCGI Process Manager) ist eine Alternative zu PHP FastCGI
mit einigen zusätzlichen Features (besonders) für Websites mit hoher Last.
</para>'>

<!-- SimpleXML Notes -->
<!ENTITY simplexml.iteration '<note xmlns="http://docbook.org/ns/docbook"><simpara>SimpleXML definiert für die
meisten Methoden Regeln für das Hinzufügen von iterativen Eigenschaften. Diese
können weder mit <function>var_dump</function> oder auf andere Weise angezeigt
werden.</simpara></note>'>

<!-- SQLite Notes -->
<!ENTITY sqlite.case-fold '<para xmlns="http://docbook.org/ns/docbook">Die Groß- und Kleinschreibung der
Spaltennamen, die von <constant>SQLITE_ASSOC</constant> und
<constant>SQLITE_BOTH</constant> zurückgegeben werden, wird entsprechend der
Konfigurationsdirektive <link
linkend="ini.sqlite.assoc-case">sqlite.assoc_case</link> geändert.</para>'>

<!ENTITY sqlite.decode-bin '<para xmlns="http://docbook.org/ns/docbook">Falls der Parameter
<parameter>decode_binary</parameter> auf &true; gesetzt ist (das ist die
Standardeinstellung), dekodiert PHP die Binärkodierung, die bei Verwendung von
<function>sqlite_escape_string</function> auf die Daten angewendet wird.
Solange Sie die Daten nicht mit anderen SQLite-Fähigen Applikationen teilen,
sollten Sie diesen Wert in der Standardeinstellung lassen.</para>'>

<!ENTITY sqlite.no-unbuffered '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion kann nicht mit
ungepufferten Ergebnishandlern benutzt werden.</para></note>'>

<!ENTITY sqlite.param-compat '<note xmlns="http://docbook.org/ns/docbook"><simpara>Zwei alternative Syntaxen werden
für die Kompatibilität mit anderen Datenbank-Erweiterungen (wie &zb; MySQL)
unterstützt. Die bevorzugte Form ist die erste, bei der der Parameter
<parameter>dbhandle</parameter> der erste Parameter der Funktion
ist.</simpara></note>'>

<!ENTITY sqlite.result-type '<para xmlns="http://docbook.org/ns/docbook">Der optionale Parameter
<parameter>result_type</parameter> akzeptiert eine Konstante und bestimmt,
wie das zurückgegebene Array indiziert wird. Während mit
<constant>SQLITE_ASSOC</constant> nur assoziative Indizes (Namensfelder)
zurückgegeben werden, werden mit <constant>SQLITE_NUM</constant> nur
numerische Indizes (geordnete Feldnummern) zurückgegeben.
<constant>SQLITE_BOTH</constant> gibt sowohl assoziative als auch numerische
Indizes zurück. <constant>SQLITE_BOTH</constant> ist die
Standardeinstellung.</para>'>

<!-- Database Notes -->
<!ENTITY database.field-case '<note xmlns="http://docbook.org/ns/docbook"><simpara>Bei den Spaltennamen, die von
dieser Funktion zurückgegeben werden, wird <emphasis>zwischen Groß- und
Kleinschreibung unterschieden</emphasis>.</simpara></note>'>

<!ENTITY database.fetch-null '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion setzt NULL-Felder
auf den PHP-Wert &null;.</simpara></note>'>

<!-- MSQL Notes -->
<!-- The msql.*.description entities are used in the parameters refsect1 -->
<!ENTITY msql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Die mSQL-Verbindung.
Wird keine Verbindungskennung angegeben, wird die letzte durch
<function>msql_connect</function> geöffnete Verbindung angenommen. Falls
keine solche Verbindung gefunden wird, versucht die Funktion, eine Verbindung
so aufzubauen, als wäre <function>msql_connect</function> aufgerufen worden
und verwendet diese.</para></listitem></varlistentry>'>

<!ENTITY msql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Das Ergebnis <type>Ressource</type>,
das ausgewertet wird. Dieses Ergebnis kommt von einem Aufruf von
<function>msql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY msql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Der numerische Offset des Feldes.
Der <parameter>field_offset</parameter> beginnt bei
<literal>1</literal>.</para></listitem></varlistentry>'>


<!-- MySQL Notes -->
<!-- The mysql.*.description entities are used in the parameters refsect1 -->
<!ENTITY mysql.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Die MySQL-Verbindung.
Wird die Verbindungskennung nicht angegeben, wird die letzte durch
<function>mysql_connect</function> geöffnete Verbindung angenommen. Falls
keine solche Verbindung gefunden wird, wird versucht, eine Verbindung
aufzubauen, wie es beim Aufruf von <function>mysql_connect</function> ohne
Angabe von Argumenten der Fall wäre. Falls zufällig keine Verbindung gefunden
oder aufgebaut werden kann, wird eine Warnung der Stufe
<constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'>

<!ENTITY mysql.linkid-noreopen.description '<varlistentry
xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Die MySQL Verbindung. Wenn nicht angegeben,
wird die letzte mit <function>mysql_connect</function> geöffnete Verbindung verwendet. Wenn
noch keine Verbindung hergestellt wurde wird ein <constant>E_WARNING</constant> Fehler
geworfen.</para></listitem></varlistentry>'>

<!ENTITY mysql.result.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>result</parameter></term><listitem><para>Das Ergebnis
<type>Ressource</type>, das ausgewertet wird. Dieses Ergebnis kommt von einem
Aufruf von
<function>mysql_query</function>.</para></listitem></varlistentry>'>

<!ENTITY mysql.field-offset.req.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>field_offset</parameter></term><listitem><para>Der numerische Offset des Feldes.
Der <parameter>field_offset</parameter> beginnt bei <literal>0</literal>. Falls
<parameter>field_offset</parameter> nicht existiert, wird eine Warnung der Stufe
<constant>E_WARNING</constant> erzeugt.</para></listitem></varlistentry>'>

<!ENTITY mysql.alternative.note '<para xmlns="http://docbook.org/ns/docbook">Diese Erweiterung ist seit PHP 5.5.0 als veraltet markiert und wurde in PHP 7.0.0 entfernt.
Verwenden Sie stattdessen die Erweiterungen <link linkend="book.mysqli">MySQLi</link> oder <link linkend="ref.pdo-mysql">PDO_MySQL</link>.
Weitere Informationen bietet der Ratgeber <link linkend="mysqlinfo.api.choosing">MySQL: Auswahl einer API</link>.
Alternativen zu dieser Funktion umfassen:</para>'>

<!ENTITY mysql.alternative.note.4-3-0 '<para xmlns="http://docbook.org/ns/docbook">Diese Funktion wurde in PHP 4.3.0 als veraltet gekennzeichnet und wurde
in PHP 7.0.0 zusammen mit der gesamten <link linkend="book.mysql">ursprünglichen MySQL-Erweiterung</link> entfernt.
Stattdessen sollten die aktiv entwickelten Erweiterungen <link linkend="book.mysqli">MySQLi</link> oder <link linkend="ref.pdo-mysql">PDO_MySQL</link> verwendet werden.
Weitere Informationen bietet der Ratgeber <link linkend="mysqlinfo.api.choosing">MySQL: Auswahl einer API</link>.
Alternativen zu dieser Funktion umfassen:</para>'>

<!ENTITY mysql.alternative.note.5-3-0 '<para xmlns="http://docbook.org/ns/docbook">Diese Funktion wurde in PHP 5.3.0 als veraltet gekennzeichnet und wurde
in PHP 7.0.0 zusammen mit der gesamten <link linkend="book.mysql">ursprünglichen MySQL-Erweiterung</link> entfernt.
Stattdessen sollten die aktiv entwickelten Erweiterungen <link linkend="book.mysqli">MySQLi</link> oder <link linkend="ref.pdo-mysql">PDO_MySQL</link> verwendet werden.
Weitere Informationen bietet der Ratgeber <link linkend="mysqlinfo.api.choosing">MySQL: Auswahl einer API</link>.
Alternativen zu dieser Funktion umfassen:</para>'>

<!ENTITY mysql.alternative.note.5-4-0 '<para xmlns="http://docbook.org/ns/docbook"> Diese Funktion wurde in PHP 5.4.0 als veraltet gekennzeichnet und wurde
in PHP 7.0.0 zusammen mit der gesamten <link linkend="book.mysql">ursprünglichen MySQL-Erweiterung</link> entfernt.
Stattdessen sollten die aktiv entwickelten Erweiterungen <link linkend="book.mysqli">MySQLi</link> oder <link linkend="ref.pdo-mysql">PDO_MySQL</link> verwendet werden.
Weitere Informationen bietet der Ratgeber <link linkend="mysqlinfo.api.choosing">MySQL: Auswahl einer API</link>.
Alternativen zu dieser Funktion umfassen:</para>'>

<!ENTITY mysql.alternative.note.5-5-0 '<para xmlns="http://docbook.org/ns/docbook"> Diese Funktion wurde in PHP 5.5.0 als veraltet gekennzeichnet und wurde
in PHP 7.0.0 zusammen mit der gesamten <link linkend="book.mysql">ursprünglichen MySQL-Erweiterung</link> entfernt.
Stattdessen sollten die aktiv entwickelten Erweiterungen <link linkend="book.mysqli">MySQLi</link> oder <link linkend="ref.pdo-mysql">PDO_MySQL</link> verwendet werden.
Weitere Informationen bietet der Ratgeber <link linkend="mysqlinfo.api.choosing">MySQL: Auswahl einer API</link>.
Alternativen zu dieser Funktion umfassen:</para>'>

<!ENTITY mysql.close.connections.result.sets '<para xmlns="http://docbook.org/ns/docbook">
Offene nicht-persistente MySQL Verbindungen und Ergebnismengen werden
automatisch zerstört, wenn ein PHP-Skript seine Ausführung beendet. Obwohl
also das explizite Schließen von offenen Verbindungen und das Freigeben von
Ergebnismengen optional ist, wird es dennoch empfohlen. Dadurch werden
Ressourcen unmittelbar an PHP und MySQL zurückgeben, was die Performance
verbessern kann. Weitere Informationen sind unter
<link linkend="language.types.resource.self-destruct">Freigeben von Ressourcen</link> zu finden.</para>'>

<!-- Sybase Notes -->
<!ENTITY sybase.ct.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion steht nur zur Verfügung,
wenn Sie die CT-Bibliothek als Schnittstelle zu Sybase verwenden.</simpara></note>'>

<!ENTITY sybase.db.only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion steht nur zur Verfügung,
wenn Sie die DB-Bibliothek als Schnittstelle zu Sybase verwenden.</simpara></note>'>

 <!ENTITY sybase.linkid.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>link_identifier</parameter></term><listitem><para>Die Sybase-Verbindung.
Wird keine Verbindung angegeben, so wird die letzte mit
<function>sybase_connect</function> geöffnete Verbindung angenommen.
Wird keine solche Verbindung gefunden, wird versucht eine Verbindung
so zu öffnen, als ob <function>sybase_connect</function> ohne Parameter
aufgerufen wurde. Kann keine Verbindung gefunden oder geöffnet werden,
so wird eine <constant>E_WARNING</constant> Warnung
generiert.</para></listitem></varlistentry>'>

<!-- CPDF Notes -->
<!ENTITY cpdf.ul '<para xmlns="http://docbook.org/ns/docbook">Der optionale Parameter <parameter>mode</parameter>
bestimmt die Länge der Einheit. Ist dieser gleich 0 oder nicht angegeben,
wird die Standardeinheit benutzt, die für die Seite angegeben wurde.
Andernfalls werden die Koordinaten in Postscript-Punkten ohne Beachtung der
aktuellen Einheit gemessen.</para>'>

<!ENTITY cpdf.mode.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>mode</parameter></term><listitem><para>Der optionale Parameter
<parameter>mode</parameter> bestimmt die Maßeinheit. Wenn er
0 ist oder nicht übergeben wurde, wird die Standardmaßeinheit des
Dokuments benutzt, ansonsten werden Koordinaten in PostScript
Punkten gemessen und die Standardmaßeinheit ignoriert.
</para></listitem></varlistentry>'>

<!ENTITY cpdf.pdf-document.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>pdf_document</parameter></term><listitem><para>Das von
<function>cpdf_open</function> gelieferte
Dokument-Handle.</para></listitem></varlistentry>'>

<!-- Xattr entities -->
<!ENTITY xattr.namespace '<para xmlns="http://docbook.org/ns/docbook">Erweiterte Eigenschaften haben zwei
verschiedene Namensräume: den User- und den Root-Namensraum. Der
User-Namensraum steht allen Benutzern zur Verfügung, während der
Root-Namensraum nur Benutzern mit Root-Rechten zur Verfügung steht. xattr
operiert standardmäßig im User-Namensraum, aber das können Sie mit dem
Parameter <parameter>flags</parameter> ändern.</para>'>

<!-- Notes for IPv6 -->
<!ENTITY ipv6.brackets '<note xmlns="http://docbook.org/ns/docbook"><simpara>Wenn Sie eine numerische IPv6-Adresse
angeben, &zb; <literal>fe80::1</literal>, müssen Sie die IP in eckige Klammern
schreiben, &zb; <literal>tcp://[fe80::1]:80</literal>.</simpara></note>'>

<!ENTITY ipv6.php5 '<note xmlns="http://docbook.org/ns/docbook"><simpara>IPv6-Unterstützung steht seit PHP 5.0.0 zur
Verfügung.</simpara></note>'>

<!-- Notes for tidy -->
<!ENTITY note.tidy.ze2 '<note xmlns="http://docbook.org/ns/docbook"><simpara> Diese Funktion wird nur von der Zend
Engine 2 (PHP &gt;= 5.0.0) unterstützt.</simpara></note>'>

<!ENTITY tidy.object 'Das <classname xmlns="http://docbook.org/ns/docbook">Tidy</classname> Objekt.'>

<!ENTITY note.tidy.1only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion steht nur in Tidy 1.0
zur Verfügung. In Tidy 2.0 ist diese Funktion obsolet und wurde
entfernt.</simpara></note>'>

<!ENTITY note.tidy.2only '<note xmlns="http://docbook.org/ns/docbook"><simpara>Die optionalen Parameter
<parameter>config</parameter> und <parameter>encoding</parameter> stehen seit
Tidy 2.0 zur Verfügung.</simpara></note>'>

<!ENTITY tidy.conf-enc '<para xmlns="http://docbook.org/ns/docbook">Der Parameter
<parameter>config</parameter> kann entweder als Array oder Zeichenkette
übergeben werden. Bei der Übergabe als Zeichenkette wird diese als Name der
Konfigurationsdatei interpretiert, bei der Übergabe als Array als die Optionen
selbst. Für mögliche Optionen und deren Bedeutung siehe
<link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.tidy.conf;">&url.tidy.conf;</link>.
</para><para>Der Parameter <parameter>encoding</parameter> bestimmt die
Kodierung für die Ein- und Ausgabe von Dokumenten. Mögliche Werte für
<parameter>encoding</parameter>: <literal>ascii</literal>,
<literal>latin0</literal>, <literal>latin1</literal>, <literal>raw</literal>,
<literal>utf8</literal>, <literal>iso2022</literal>, <literal>mac</literal>,
<literal>win1252</literal>, <literal>ibm858</literal>, <literal>utf16</literal>,
<literal>utf16le</literal>, <literal>utf16be</literal>, <literal>big5</literal>
und <literal>shiftjis</literal>.</para>'>

<!-- Snippets for the installation section -->
<!ENTITY warn.apache2.compat '<warning xmlns="http://docbook.org/ns/docbook"><para>Wir empfehlen, in einer
Produktionsumgebung kein Threaded MPM mit Apache2 zu verwenden. Verwenden Sie
stattdessen das Prefork MPM, welches der Standard-MPM für Apace 2.0 und 2.2 ist.
Für weitere Informationen und die Gründe lesen Sie bitte den entsprechenden
FAQ-Eintrag über die Verwendung von
<link linkend="faq.installation.apache2">Apache2 mit Threaded MPM.</link></para></warning>'>
<!ENTITY warn.install.third-party-support '<warning xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <para>
  Pakete von Drittanbietern werden als inoffiziell betrachtet und nicht direkt
  vom PHP-Projekt unterstützt. Auftretende Fehler sollten dem Anbieter dieser
  inoffiziellen Pakete gemeldet werden, es sei denn, sie können mit den Paketen
  aus dem
  <link xlink:href="&url.php.downloads;">offiziellen Downloadbereich</link>
  reproduziert werden.
 </para>
</warning>'>

<!ENTITY note.apache.slashes '<note xmlns="http://docbook.org/ns/docbook"><simpara>Beachten Sie bitte, dass Sie bei
Pfadangaben in der Apachekonfigurationsdatei unter Windows alle Backslashes,
wie &zb; <filename>c:\directory\file.ext</filename>, in Schrägstriche umwandeln
sollten: <filename>c:/directory/file.ext</filename>. Bei Verzeichnisnamen
kann weiterhin ein abschließender Schrägstrich nötig sein.</simpara></note>'>

<!-- Snippets and titles for the contributors section -->
<!ENTITY Credit.Authors.and.Contributors 'Autoren und Mitwirkende'>

<!ENTITY Credit.Introduction '<para xmlns="http://docbook.org/ns/docbook"> Es gibt eine große Anzahl von Mitwirkenden, die
derzeit an unserer Arbeit beteiligt sind oder dem Projekt in der Vergangenheit
wertvolle Hilfe geleistet haben. Ebenfalls gibt es eine Vielzahl von Personen,
die hier nicht namentlich aufgeführt sind, die durch ihre User Notes auf den
Handbuchseiten mithelfen. Die User Notes werden kontinuierlich in unser
Handbuch integriert und wir schätzen diese Unterstützung außerordentlich.
Alle folgenden Listen sind alphabetisch sortiert.
</para>'>

<!ENTITY Credit.Authors.and.Editors 'Autoren und Editoren'>

<!ENTITY Credit.Past.Authors.Text 'Folgende Personen verdienenen Anerkennung
dafür, dass Sie wesentlichen Inhalt zum Handbuch beigetragen haben und/oder weiterhin
beitragen werden:'>

<!ENTITY Credit.Past.Editors.Text 'Folgende Personen haben
durch Ihre Editionsarbeit wesentlich zum Handbuch beigetragen:'>

<!ENTITY Credit.Note.Editors.Title 'Betreuer der User Notes'>

<!ENTITY Credit.Note.Editors.Active 'Die zurzeit aktivsten Betreuer:'>

<!ENTITY Credit.Note.Editors.Inactive 'Auch folgende Personen haben
einiges an Mühe und Zeit zur Betreuung der User Notes investiert:'>

<!ENTITY listendand ' und'>

<!-- classkit und runkit entities -->
<!ENTITY note.classkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion kann
nicht genutzt werden, um die aktuell ausgeführte (oder verkette) Methode
zu manipulieren.</simpara></note>'>

<!ENTITY note.runkit.selfmanipulation '<note xmlns="http://docbook.org/ns/docbook"><simpara> Diese Funktion kann nicht
genutzt werden, um die aktuell ausgeführte (oder verkette) Methode zu
manipulieren.</simpara></note>'>

<!ENTITY note.runkit.sandbox '<note xmlns="http://docbook.org/ns/docbook"><simpara>Sandbox-Unterstützung
(wird benötigt für <function>runkit_lint</function>, <function>runkit_lint_file</function>,
und die <classname>Runkit_Sandbox</classname>-Klasse) ist nur ab PHP 5.1
und speziell gepatchten Versionen
von PHP 5.0 verfügbar und setzt voraus das Thread-Unterstützung aktiviert wurde.
Weiterführende Informationen finden sie in der <filename>README</filename>-Datei
des runkit-Pakets.</simpara></note>'>

<!ENTITY note.runkit.internal-override '<note xmlns="http://docbook.org/ns/docbook"><simpara>Normalerweise können
nur benutzerdefinierte Funktionen gelöscht, umbenannt oder modifiziert werden.
Wenn Sie auch interne Funktionen übersteuern wollen, müssen Sie
<literal>runkit.internal_override</literal> in Ihrer &php.ini;
aktivieren.</simpara>
</note>'>

<!-- SSH2 Extension -->
<!ENTITY note.ssh2.subsystem.publickey '<note xmlns="http://docbook.org/ns/docbook"><simpara>
Das Publickey-Subsystem wird benötigt, um öffentliche Schlüssel
auf einem Server zu verwalten, für welche der Client
<emphasis>bereits authentifiziert ist</emphasis>.
Sie können sich gegenüber einem anderen System mit Publickey-Authentifizierung
authentifizieren, indem Sie die
<function>ssh2_auth_pubkey_file</function> nutzen.</simpara></note>'>

<!-- Session notes -->
<!ENTITY returns.session.storage.retval 'Der Rückgabewert (normalerweise &true; bei Erfolg und &false; bei Misserfolg). Es ist zu beachten, dass dieser Wert intern PHP zur Verarbeitung zurückgegeben wird.'>

<!-- XMLWriter Notes -->
<!ENTITY xmlwriter.xmlwriter.description '<varlistentry xmlns="http://docbook.org/ns/docbook"><term>
<parameter>writer</parameter></term><listitem><para>Nur für prozedurale Aufrufe.
Die <classname>XMLWriter</classname>-Instanz, die bearbeitet werden soll. Dieses Objekt wird von Aufrufen von <function>xmlwriter_open_uri</function> oder <function>xmlwriter_open_memory</function> geliefert.</para></listitem></varlistentry>'>

<!ENTITY xmlwriter.changelog.writer-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>writer</parameter> erwartet nun eine
  <classname>XMLWriter</classname>-Instanz; vorher wurde eine
  <type>&resource;</type> erwartet.
 </entry>
</row>'>

<!-- SOAP notes -->
<!ENTITY soap.wsdl.mode.only '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion funktioniert nur im WSDL-Modus.</para></note>'>

<!-- Stomp notes -->
<!ENTITY stomp.param.link '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>link</parameter></term><listitem><para>Nur für prozedurale Aufrufe: Die Stomp-Verbindung, die von <function>stomp_connect</function> zurückgegeben wurde.</para></listitem></varlistentry>'>

<!ENTITY stomp.param.headers '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>headers</parameter></term><listitem><para>Assoziatives Array, welches alle zusätzlichen Header beinhaltet (&zb; receipt).</para></listitem></varlistentry>'>

<!ENTITY stomp.note.transaction '<note xmlns="http://docbook.org/ns/docbook"><para>Ein Transaktionsheader kann angegeben werden. Dies zeigt an, dass die Bestätigung der Nachricht ein Bestandteil der benanten Transaktion sein soll.</para></note>'>

<!ENTITY stomp.note.sync '<tip xmlns="http://docbook.org/ns/docbook"><simpara>Eine grundlegende Eigenschaft von Stomp ist die Synchronität. Synchrone Kommunikation kann durch das Hinzufügen eines Empfangsheaders (receipt-Header) implementiert werden. Dies führt dazu, dass Methoden solange nichts zurückgeben, bis der Server den Empfang der Nachricht bestätigt hat oder der Lese-Timeout überschritten wurde.</simpara></tip>'>

<!-- SVN notes -->
<!ENTITY svn.relativepath '<note xmlns="http://docbook.org/ns/docbook"><simpara>Relative Pfade werden so aufgelöst, als ob das aktuelle Verzeichnis das wäre,
in dem sich das PHP-Binary befindet. Um stattdessen das aktuelle Verzeichnis des aufrufenden Skripts zu nutzen,
muss die Funktion <function>realpath</function> oder dirname(__FILE__) verwendet werden.</simpara></note>'>
<!ENTITY svn.referto.status 'Siehe auch <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.status">Status-Konstanten</link> für mögliche Werte.'>
<!ENTITY svn.referto.type 'Siehe auch <link xmlns="http://docbook.org/ns/docbook" linkend="svn.constants.type">Type-Konstanten</link> für mögliche Werte.'>

<!-- FANN notes -->
<!ENTITY fann.ann.description '<para xmlns="http://docbook.org/ns/docbook"><type>Ressource</type> eines neuralen Netzwerks.</para>'>

<!ENTITY fann.train.description '<para xmlns="http://docbook.org/ns/docbook"><type>Ressource</type> für Trainingsdaten eines neuralen Netzwerks.</para>'>

<!ENTITY fann.errdat.description '<para xmlns="http://docbook.org/ns/docbook">Entweder eine <type>Ressource</type> eines neuralen Netzwerks oder <type>Ressource</type> mit Trainingsdaten.</para>'>

<!ENTITY fann.return.void '<para xmlns="http://docbook.org/ns/docbook">Es wird kein Wert zurückgegeben.</para>'>

<!ENTITY fann.return.bool '<para xmlns="http://docbook.org/ns/docbook">Gibt &true; bei Erfolg, sonst &false; zurück.</para>'>

<!ENTITY fann.return.ann '<para xmlns="http://docbook.org/ns/docbook">Gibt bei Erfolg die <type>Ressource</type> eines neuralen Netzwerks zurück oder &false; im Fehlerfall.</para>'>

<!ENTITY fann.return.train '<para xmlns="http://docbook.org/ns/docbook">Gibt bei Erfolg eine <type>Ressource</type> mit Trainingsdaten zurück oder &false; im Fehlerfall.</para>'>

<!ENTITY fann.note.function.fann-2.2 '<note xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion ist nur verfügbar, wenn die Erweiterung fann mit libfann &gt;= 2.2 kompiliert wurde.</para></note>'>

<!-- Imagick generic return types -->
<!ENTITY imagick.return.success 'Liefert &true; bei Erfolg.'>
<!ENTITY imagick.imagick.throws 'Wirft ImagickException bei Fehlern.'>
<!ENTITY imagick.imagickdraw.throws 'Wirft ImagickDrawException bei Fehlern.'>
<!ENTITY imagick.imagickpixel.throws 'Wirft ImagickPixelException bei Fehlern.'>
<!ENTITY imagick.imagickpixeliterator.throws 'Wirft ImagickPixelIteratorException bei Fehlern.'>

<!-- Imagick version infos -->
<!ENTITY imagick.method.available.0x629 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.2.9 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x631 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.1 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x632 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.2 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x636 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.6 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x637 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.7 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x638 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.8 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x639 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.3.9 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x640 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.0 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x641 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.1 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x642 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.2 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x643 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.3 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x644 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.4 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x645 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.5 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x647 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.7 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x649 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.4.9 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x653 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.5.3 oder höher kompiliert wurde.'>
<!ENTITY imagick.method.available.0x657 'Diese Funktion ist verfügbar, wenn Imagick gegen die ImageMagick-Version 6.5.7 oder höher kompiliert wurde.'>

<!ENTITY imagick.method.not.available.0x700 'Diese Funktion ist nicht verfügbar, wenn Imagick gegen die ImageMagick-Version 7.0.0 oder höher kompiliert wurde.'>

<!ENTITY imagick.constant.available 'Diese Konstante ist verfügbar, wenn Imagick kompiliert wurde gegen die ImageMagick-Version'>

<!ENTITY imagick.deprecated.function-3-4-4 '<warning xmlns="http://docbook.org/ns/docbook"><simpara>Diese Funktion ist von Imagick 3.4.4 an <emphasis>MISSBILLIGT</emphasis>. Von der weiteren Verwendung wird dringend abgeraten.</simpara></warning>'>

<!-- Imagick default channel information -->
<!ENTITY imagick.default.channel.info 'Der Standardwert ist <constant xmlns="http://docbook.org/ns/docbook">Imagick::CHANNEL_DEFAULT</constant>. Weitere Informationen enthält die Liste der <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">Channel-Konstanten</link>'>

<!-- Fuzz parameter -->
<!ENTITY imagick.parameter.fuzz 'Die Menge an Ungenauigkeit. Wird dieser Wert &zb; auf 10 gesetzt, so wird die Farbe Rot bei Intensitäten von 100 und 102 als identisch betrachtet.'>

<!-- Channel parameter -->
<!ENTITY imagick.parameter.channel 'Übergeben Sie eine Channel-Konstante, die für Ihren Channel-Moduls gültig ist. Um mehr als einen Channel anzuwenden, können Sie die <link xmlns="http://docbook.org/ns/docbook" linkend="imagick.constants.channel">Channel-Konstanten</link> mit bitweisen Operationen verknüpfen. &imagick.default.channel.info;'>

<!-- Alpha parameter -->
<!ENTITY imagick.parameter.alpha 'Die Stufe der Transparenz. 1.0 ist völlig undurchsichtig und 0.0 ist komplett transparent.'>

<!ENTITY imagick.imagickexception.throw 'Wirf eine
<classname xmlns="http://docbook.org/ns/docbook">ImagickException</classname> bei einem Fehler.'>

<!ENTITY imagick.bestfit.note '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Das Verhalten des Parameters <parameter>bestfit</parameter> hat sich mit Imagick 3.0.0 geändert.
  Vor dieser Version wurde ein Bild der Größe 200x150 bei der angegebenen Größe von 400x400
  nicht verändert. In Imagick 3.0.0 und späteren Versionen wird dieses Bild auf die Größe
  400x300 hochgerechnet, da dies die passendste größe für die angegebene Bildgröße ist.
  Wenn der <parameter>bestfit</parameter>-Parameter angegeben wird, so muss sowohl eine
  Breite als auch eine Höhe angegeben werden.
 </simpara>
</note>'>

<!ENTITY note.openssl.cnf '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Die ordnungsgemäße Ausführung dieser Funktion setzt die Installation einer
  gültigen <filename>openssl.cnf</filename>-Datei voraus. Mehr Information
  hierzu sind im Abschnitt
  <link linkend="openssl.installation">Installation</link> zu finden.
 </simpara>
</note>'>

<!ENTITY note.openssl.param-notext '<para xmlns="http://docbook.org/ns/docbook">
 Der optionale Parameter<parameter>notext</parameter> beinflusst die
 Ausführlichkeit der Ausgabe. Wenn er auf &false; gesetzt wird, werden
 zusätzliche lesbare Informationen in die Ausgabe aufgenommen. Der
 Vorgabewert für <parameter>notext</parameter> ist &true;.
</para>'>

<!-- COM/Dotnet -->
<!ENTITY com.variant-arith '<note xmlns="http://docbook.org/ns/docbook">
<para>
 Wie bei allen arithmetischen Variantfunktionen, können die Parameter dieser
 Funktion entweder native PHP-Typen (Integer, String, Fließkomma, Boolean
 oder &null;) oder Instanzen einer COM-, VARIANT- oder DOTNET-Klasse sein.
 Native PHP-Typen werden nach den gleichen Regeln in Varianten umgewandelt
 wie auch im Konstruktor der <xref linkend="class.variant"/>-Klasse.
 Für COM- und DOTNET-Objekte wird der Wert ihrer Standardeigenschaft
 genommen und als Variantenwert genutzt.
</para>
<para>
 Die arithmetischen Variantenfunktionen sind Wrapper für die ähnlich
 benannten Funktionen der COM-Bibliothek, weiterführende Informationen
 hierzu finden sie in der MSDN-Bibliothek. Die PHP-Funktionen sind leicht
 abweichend benannt, so korrespondiert <function>variant_add</function>
 in PHP zu VarAdd() in der MSDN-Dokumentation.
</para>
</note>
'>

<!ENTITY com.use-oo-instead '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Diese Funktion existiert nicht in PHP 5. Sie sollten stattdessen die
  reguläre und natürlichere OO-Syntax für Zugriffe auf Eigenschaften und
  für Methodenaufrufe benutzen.
 </simpara>
</note>
'>

<!-- phar -->
<!ENTITY phar.write '<note xmlns="http://docbook.org/ns/docbook">
 <para>
  Diese Methode des <classname>Phar</classname>-Objekts funktioniert nur
  wenn die &php.ini;-Einstellung <literal xmlns="http://docbook.org/ns/docbook">phar.readonly</literal> auf 0
  gesetzt ist, sonst wird eine <classname>PharException</classname> geworfen.
 </para>
</note>'>

<!ENTITY phar.removed.pharcompress '<note xmlns="http://docbook.org/ns/docbook">
<para>Diese Methode wurde beginnend mit Version 2.0.0 der Erweiterung phar
entfernt. Alternative Implementationen bieten <function>Phar::compress</function>,
<function>Phar::decompress</function>, <function>Phar::compressFiles</function> und
<function>Phar::decompressFiles</function>.</para></note>'>

<!ENTITY phar.removed.pharfileinfocompress '<note xmlns="http://docbook.org/ns/docbook">
<para>Diese Methode wurde beginnend mit Version 2.0.0 der Erweiterung phar
entfernt. Alternative Implementationen bieten <function>PharFileInfo::isCompressed</function>,
<function>PharFileInfo::decompress</function> und
<function>PharFileInfo::compress</function>.</para></note>'>

<!ENTITY phar.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Die Funktionen <function>Phar::addFile</function>, <function>Phar::addFromString</function> und <function>Phar::offsetSet</function>
  speichern bei jedem Aufruf ein neues phar-Archiv. Wenn die Leistung ein
  wichtiger Faktor ist, sollte stattdessen
  <function>Phar::buildFromDirectory</function> oder <function>Phar::buildFromIterator</function>
  verwendet werden.
 </simpara>
</note>'>

<!ENTITY phardata.note.performance '<note xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Die Funktionen <function>PharData::addFile</function>, <function>PharData::addFromString</function> und <function>PharData::offsetSet</function>
  speichern bei jedem Aufruf ein neues phar-Archiv. Wenn die Leistung ein
  wichtiger Faktor ist, sollte stattdessen
  <function>PharData::buildFromDirectory</function> oder <function>PharData::buildFromIterator</function>
  verwendet werden.
 </simpara>
</note>'>

<!-- XML -->
<!ENTITY libxml.required '<para xmlns="http://docbook.org/ns/docbook">
 Diese Erweiterung erfordert die Erweiterung
 <link linkend="book.libxml">libxml</link>. Das heißt, dass die Übergabe von
 <option role="configure">--with-libxml</option>, oder vor PHP 7.4.0
 <option role="configure">--enable-libxml</option>, ebenfalls benötigt wird.
 Dies wird jedoch implizit erfüllt, da libxml standardmäßig aktiviert wird.
</para>'>

<!-- XMLReader -->
<!ENTITY xmlreader.libxml20620.note '<caution xmlns="http://docbook.org/ns/docbook"><para>Diese Funktion ist nur verfügbar, wenn PHP mit libxml 20620 oder später kompiliert wurde.</para></caution>'>

<!-- inotify -->
<!ENTITY inotify.instance.description 'Von <function xmlns="http://docbook.org/ns/docbook">inotify_init</function> zurückgegebene Ressource'>

<!-- User streams -->
<!ENTITY userstream.not.implemented.warning '<para xmlns="http://docbook.org/ns/docbook">Wirft
<constant>E_WARNING</constant>, wenn der Aufruf dieser Methode
fehlschlug (&zb; weil sie nicht implementiert ist).</para>'>

<!ENTITY userstream.updates.context '<note xmlns="http://docbook.org/ns/docbook"><para>Die
<varname linkend="streamwrapper.props.context">streamWrapper::$context</varname>-Eigenschaft
wird, wenn verfügbar, aktualisiert, wenn der aufrufenden Funktion
ein gültiger Kontext übergeben wurde.</para></note>'>

<!-- Gmagick -->
<!ENTITY gmagick.return.success 'Gibt im Erfolgsfall &true; zurück.'>
<!ENTITY gmagick.gmagickexception.throw 'Wirft bei einem Fehler eine
<classname xmlns="http://docbook.org/ns/docbook">GmagickException</classname>.'>

<!-- Reflection -->
<!ENTITY reflection.export.return 'Falls der Parameter
<parameter xmlns="http://docbook.org/ns/docbook">return</parameter> auf &true; gesetzt ist,
so wird der Export als ein <type xmlns="http://docbook.org/ns/docbook">String</type>
zurückgegeben, andernfalls wird &null; zurückgegeben.'>

<!ENTITY reflection.export.param.return 'Wird dies auf &true; gesetzt, so wird der Export
zurückgegeben anstelle ihn auszugeben. Wird dies auf &false; gesetzt (der Standardwert), wird
das Gegenteil passieren.'>

<!ENTITY reflection.invoke.reference 'Wenn die Funktion einige Argumente per Referenz akzeptiert,
so müssen diese als Referenzen in die Argument-Liste gegeben werden.'>

<!ENTITY reflection.export.param.name 'Die Reflection, die exportiert werden soll.'>

<!ENTITY reflection.getattributes.param.name '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>name</parameter></term>
<listitem>
 <para>
  Die Ergebnisse werden so gefiltert, dass nur
  <classname>ReflectionAttribute</classname>-Instanzen für Attribute mit
  diesem Klassennamen enthalten sind.
 </para>
</listitem>
</varlistentry>'>

<!ENTITY reflection.getattributes.param.flags '<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>flags</parameter></term>
<listitem>
 <para>
  Flags, die festlegen, wie die Ergebnisse gefiltert werden sollen, wenn
  <parameter>name</parameter> angegeben wird.
 </para>
 <para>
  Die Voreinstellung ist <literal>0</literal>, was nur Ergebnisse für die
  Attribute der Klasse <parameter>name</parameter> liefert.
 </para>
 <para>
  Die einzige andere Möglichkeit ist die Verwendung von
  <constant>ReflectionAttribute::IS_INSTANCEOF</constant>, wodurch stattdessen
  <literal>instanceof</literal> zum Filtern verwendet wird.
 </para>
</listitem>
</varlistentry>'>

<!-- SPL -->
<!ENTITY spl.datastructures.intro.title '<title xmlns="http://docbook.org/ns/docbook">Datenstrukturen</title>'>

<!ENTITY spl.exceptions.intro.title '<title xmlns="http://docbook.org/ns/docbook">Exceptions</title>'>
<!ENTITY spl.exceptions.intro '<para xmlns="http://docbook.org/ns/docbook">SPL bietet einige Standard-Exceptions an.</para><para xmlns="http://docbook.org/ns/docbook">Siehe auch <xref linkend="reserved.exceptions" /></para>'>

<!ENTITY spl.files.intro.title '<title xmlns="http://docbook.org/ns/docbook">Dateibehandlung</title>'>
<!ENTITY spl.files.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>SPL bietet einige Klassen für die Verarbeitung von Dateien.</para></partintro>'>

<!ENTITY spl.interfaces.intro.title '<title xmlns="http://docbook.org/ns/docbook">Interfaces</title>'>
<!ENTITY spl.interfaces.intro '<para xmlns="http://docbook.org/ns/docbook">SPL bietet einige Interfaces an.</para><para xmlns="http://docbook.org/ns/docbook">Siehe auch <xref linkend="reserved.interfaces" /></para>'>
<!ENTITY spl.interfaces.list '<title xmlns="http://docbook.org/ns/docbook">Liste von Interfaces</title>'>

<!ENTITY spl.iterators.intro.title '<title xmlns="http://docbook.org/ns/docbook">Iteratoren</title>'>
<!ENTITY spl.iterators.intro '<para xmlns="http://docbook.org/ns/docbook">SPL bietet einige Iteratoren zum durchlaufen von Objekten an.</para>'>

<!ENTITY spl.misc.intro.title '<title xmlns="http://docbook.org/ns/docbook">Verschiedene Klassen und Interfaces</title>'>
<!ENTITY spl.misc.intro '<partintro xmlns="http://docbook.org/ns/docbook"><para>Klassen und Interfaces, die nicht zu den anderen Kategorien in SPL passen.</para></partintro>'>

<!-- ZIP -->
<!ENTITY zip.filename.separator '<note xmlns="http://docbook.org/ns/docbook"><simpara>Für maximale Portierbarkeit wird empfohlen, in ZIP-Dateinamen immer Schrägstriche (<literal>/</literal>) als Verzeichnis-Trennzeichen zu verwenden.</simpara></note>'>

<!-- Win32Service -->
<!ENTITY win32service.false.error ' und &false;, wenn es ein Problem mit den Parametern gab oder einen <link xmlns="http://docbook.org/ns/docbook" linkend="win32service.constants.errors">Win32-Fehlercode</link> im Fehlerfall.'>
<!ENTITY win32service.success.false.error 'Gibt im Erfolgsfall &true; zurück&win32service.false.error;'>
<!ENTITY win32service.noerror.false.error 'wurde im Erfolgsfall <constant xmlns="http://docbook.org/ns/docbook">WIN32_NO_ERROR</constant> zurückgegeben&win32service.false.error;'>

<!-- SNMP -->
<!ENTITY snmp.set.type.values '<para xmlns="http://docbook.org/ns/docbook">
 Die <acronym>MIB</acronym> definiert den Typ jeder Objekt-ID. Dieser muss als ein einzelnes Zeichen aus der folgenden Liste angegeben werden.
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>Typen</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>=</entry><entry>Der Typ wird aus der MIB übernommen</entry></row>
   <row><entry>i</entry><entry>INTEGER</entry> </row>
   <row><entry>u</entry><entry>INTEGER</entry></row>
   <row><entry>s</entry><entry>STRING</entry></row>
   <row><entry>x</entry><entry>HEX STRING</entry></row>
   <row><entry>d</entry><entry>DECIMAL STRING</entry></row>
   <row><entry>n</entry><entry>NULLOBJ</entry></row>
   <row><entry>o</entry><entry>OBJID</entry></row>
   <row><entry>t</entry><entry>TIMETICKS</entry></row>
   <row><entry>a</entry><entry>IPADDRESS</entry></row>
   <row><entry>b</entry><entry>BITS</entry></row>
  </tbody>
 </tgroup>
</table>
<para xmlns="http://docbook.org/ns/docbook">
 Wenn <constant>OPAQUE_SPECIAL_TYPES</constant> beim Kompilieren der <acronym>SNMP</acronym>-Bibliothek definiert wurde, sind auch die folgenden Angaben gültig:
</para>
<table xmlns="http://docbook.org/ns/docbook">
 <title>Typen</title>
 <tgroup cols="2">
  <tbody>
   <row><entry>U</entry><entry>unsigned int64</entry></row>
   <row><entry>I</entry><entry>signed int64</entry></row>
   <row><entry>F</entry><entry>float</entry></row>
   <row><entry>D</entry><entry>double</entry></row>
  </tbody>
 </tgroup>
</table>
'>
<!ENTITY snmp.set.type.values.asn.mapping '<para xmlns="http://docbook.org/ns/docbook">
 In den meisten Fällen wird der entsprechende ASN.1-Typ verwendet. &apos;s&apos;, &apos;x&apos;, &apos;d&apos; und &apos;b&apos; sind alles verschiedene Arten, einen OCTET STRING-Wert anzugeben, und
 der vorzeichenlose Typ &apos;u&apos; wird auch für den Umgang mit Gauge32-Werten verwendet.
</para>
'>
<!ENTITY snmp.set.type.values.equal.note '<para xmlns="http://docbook.org/ns/docbook">
 Wenn die MIB-Dateien mit "snmp_read_mib" in den MIB-Baum geladen oder in der libsnmp-Konfiguration angegeben werden, kann &apos;=&apos; als
 als Parameter <parameter>type</parameter> für alle Objekt-IDs verwendet werden, da der Typ dann automatisch aus der MIB gelesen werden kann.
</para>
'>
<!ENTITY snmp.set.type.values.bitset.note '<para xmlns="http://docbook.org/ns/docbook">
 Zu beachten ist, dass es zwei Möglichkeiten gibt, eine Variable vom Typ BITS zu setzen, &zb;
 "SYNTAX BITS {telnet(0), ftp(1), http(2), icmp(3), snmp(4), ssh(5), https(6)}":
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook">
 <listitem>
  <simpara>
   Die Verwendung des Typs "b" und eine Liste von Bitnummern. Diese Methode wird nicht empfohlen, da eine GET-Anfrage für dieselbe OID &zb; 0xF8 zurückgeben würde.
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Die Verwendung des Typs "x" und eine Hex-Zahl, aber ohne(!) das übliche Präfix "0x".
  </simpara>
 </listitem>
</itemizedlist>
<para xmlns="http://docbook.org/ns/docbook">
 Siehe den Abschnitt Beispiele für weitere Details.
</para>
'>
<!ENTITY snmp.methods.exceptions_enable.refsect '<refsect1 role="errors" xmlns="http://docbook.org/ns/docbook">
&reftitle.errors;
<para>
 Diese Methode löst standardmäßig keine Exceptions aus.
 Um das Auslösen einer SNMPException-Exception beim Auftreten bestimmter Bibliotheksfehler zu aktivieren, muss
 muss der SNMP-Klassenparameter <parameter>exceptions_enabled</parameter>
 auf einen entsprechenden Wert gesetzt werden. Siehe <link linkend="snmp.props.exceptions-enabled">
 <parameter>SNMP::$exceptions_enabled</parameter> explanation</link> für weitere Details.
</para>
</refsect1>
'>

<!-- Eio -->
<!ENTITY eio.callback.proto '<para xmlns="http://docbook.org/ns/docbook">
Die <parameter xmlns="http://docbook.org/ns/docbook">callback</parameter>-Funktion wird aufgerufen, wenn die Anfrage abgeschlossen ist.
Sie muss dem folgenden Prototyp entsprechen: <programlisting role="php"><![CDATA[
void callback(mixed $data, int $result[, resource $req]);
]]></programlisting>
<variablelist xmlns="http://docbook.org/ns/docbook">
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>data</parameter></term>
<listitem><para>sind die benutzerdefinierten Daten, die an die Anfrage übergeben werden.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>result</parameter></term>
<listitem><para>der anfragespezifische Ergebniswert; im Grunde der Wert, der vom entsprechenden
Systemaufruf zurückgegeben wird.</para></listitem>
</varlistentry>
<varlistentry xmlns="http://docbook.org/ns/docbook">
<term><parameter>req</parameter></term>
<listitem><para>ist eine optionale Anfrage-Ressource, die in Funktionen wie <function>eio_get_last_error</function> verwendet werden kann.</para></listitem>
</varlistentry>
</variablelist>
</para>
'>

<!ENTITY eio.request.pri.values '<para
xmlns="http://docbook.org/ns/docbook">The request priority: <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MIN</constant>, <constant
xmlns="http://docbook.org/ns/docbook">EIO_PRI_MAX</constant>, or &null;.
If &null; passed, <parameter
xmlns="http://docbook.org/ns/docbook">pri</parameter> internally is set to
<constant xmlns="http://docbook.org/ns/docbook">EIO_PRI_DEFAULT</constant>.
</para>
'>

<!ENTITY eio.warn.relpath '<warning
xmlns="http://docbook.org/ns/docbook"><simpara xmlns="http://docbook.org/ns/docbook">Avoid relative
paths</simpara></warning>
'>

<!ENTITY trader.arg.array.of.real 'Array of real values.'>
<!ENTITY trader.arg.array.of.real.high 'High price, array of real values.'>
<!ENTITY trader.arg.array.of.real.low 'Low price, array of real values.'>
<!ENTITY trader.arg.array.of.real.close 'Closing price, array of real values.'>
<!ENTITY trader.arg.array.of.real.open 'Opening price, array of real values.'>
<!ENTITY trader.arg.array.of.real.volume 'Volume traded, array of real values.'>
<!ENTITY trader.arg.array.of.real.periods 'Array of real values.'>
<!ENTITY trader.arg.penetration 'Percentage of penetration of a candle within another candle.'>
<!ENTITY trader.arg.vfactor 'Volume Factor. Valid range from 1 to 0.'>
<!ENTITY trader.arg.time.period 'Number of period. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.fast.period 'Number of period for the fast MA. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.slow.period 'Number of period for the slow MA. Valid range from 2 to 100000.'>
<!ENTITY trader.arg.signal.period 'Smoothing for the signal line (nb of period). Valid range from 1 to 100000.'>
<!ENTITY trader.arg.fastk.period 'Time period for building the Fast-K line. Valid range from 1 to 100000.'>
<!ENTITY trader.arg.fastd.period 'Smoothing for making the Fast-D line. Valid range from 1 to 100000, usually set to 3.'>
<!ENTITY trader.arg.slowk.period 'Smoothing for making the Slow-K line. Valid range from 1 to 100000, usually set to 3.'>
<!ENTITY trader.arg.slowd.period 'Smoothing for making the Slow-D line. Valid range from 1 to 100000.'>
<!ENTITY trader.arg.min.period 'Value less than minimum will be changed to Minimum period. Valid range from 2 to 100000'>
<!ENTITY trader.arg.max.period 'Value higher than minimum will be changed to Maximum period. Valid range from 2 to 100000'>
<!ENTITY trader.arg.ma.type 'Type of Moving Average. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.fast.ma.type 'Type of Moving Average for fast MA. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slow.ma.type 'Type of Moving Average for slow MA. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.fastd.ma.type 'Type of Moving Average for Fast-D. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.fastk.ma.type 'Type of Moving Average for Fast-K. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slowd.ma.type 'Type of Moving Average for Slow-D. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.slowk.ma.type 'Type of Moving Average for Slow-K. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.signal.ma.type 'Type of Moving Average for signal line. <link xmlns="http://docbook.org/ns/docbook" linkend="trader.constants">TRADER_MA_TYPE_*</link> series of constants should be used.'>
<!ENTITY trader.arg.nbdevup 'Deviation multiplier for upper band. Valid range from <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> to <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.nbdevdn 'Deviation multiplier for lower band. Valid range from <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-min">TRADER_REAL_MIN</link> to <link xmlns="http://docbook.org/ns/docbook" linkend="constant.trader-real-max">TRADER_REAL_MAX</link>.'>
<!ENTITY trader.arg.fast.limit 'Upper limit use in the adaptive algorithm. Valid range from 0.01 to 0.99.'>
<!ENTITY trader.arg.slow.limit 'Lower limit use in the adaptive algorithm. Valid range from 0.01 to 0.99.'>

<!-- Mongo -->
<!ENTITY mongo.setreadpreference.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>read_preference</parameter></term><listitem><para>The read preference mode: <constant>MongoClient::RP_PRIMARY</constant>, <constant>MongoClient::RP_PRIMARY_PREFERRED</constant>, <constant>MongoClient::RP_SECONDARY</constant>, <constant>MongoClient::RP_SECONDARY_PREFERRED</constant>, or <constant>MongoClient::RP_NEAREST</constant>.</para></listitem></varlistentry><varlistentry><term><parameter>tags</parameter></term><listitem><para>An array of zero or more tag sets, where each tag set is itself an array of criteria used to match tags on replica set members.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setreadpreference.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if either parameter is invalid, or if one or more tag sets are provided with the <constant>MongoClient::RP_PRIMARY</constant> read preference mode.</para>'>
<!ENTITY mongo.getreadpreference.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the read preference. The array contains the values <literal>type</literal> for the string read preference mode (corresponding to the <classname>MongoClient</classname> constants), and <literal>tagsets</literal> containing a list of all tag set criteria. If no tag sets were specified, <literal>tagsets</literal> will not be present in the array.</para>'>
<!ENTITY mongo.setwriteconcern.parameters '<variablelist xmlns="http://docbook.org/ns/docbook"><varlistentry><term><parameter>w</parameter></term><listitem><para>The write concern. This may be an integer denoting the number of servers required to acknowledge the write, or a string mode (e.g. "majority").</para></listitem></varlistentry><varlistentry><term><parameter>wtimeout</parameter></term><listitem><para>The maximum number of milliseconds to wait for the server to satisfy the write concern.</para></listitem></varlistentry></variablelist>'>
<!ENTITY mongo.setwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">Returns &true; on success, or &false; otherwise.</para>'>
<!ENTITY mongo.setwriteconcern.errors '<para xmlns="http://docbook.org/ns/docbook">Emits <constant>E_WARNING</constant> if the <literal>w</literal> parameter is not an integer or string value.</para>'>
<!ENTITY mongo.getwriteconcern.returnvalues '<para xmlns="http://docbook.org/ns/docbook">This function returns an array describing the write concern. The array contains the values <literal>w</literal> for an integer acknowledgement level or string mode, and <literal>wtimeout</literal> denoting the maximum number of milliseconds to wait for the server to satisfy the write concern.</para>'>
<!ENTITY mongo.command.parameters.maxtimems '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"maxTimeMS"</literal></para><para>Specifies a cumulative time limit in milliseconds for processing the operation on the server (does not include idle time). If the operation is not completed by the server within the timeout period, a <classname>MongoExecutionTimeoutException</classname> will be thrown.</para></listitem>'>
<!ENTITY mongo.index.parameters.background '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"background"</literal></para><para>Builds the index in the background so that building an index does <emphasis>not</emphasis> block other database activities. Specify &true; to build in the background. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para>Prior to MongoDB 2.6.0, index builds on secondaries were executed as foreground operations, irrespective of this option. See <link xlink:href="&url.mongodb.dochub.indexes.rs;" xmlns:xlink="http://www.w3.org/1999/xlink">Building Indexes with Replica Sets</link> for more information.</para></warning></listitem>'>
<!ENTITY mongo.index.parameters.dropdups '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal></para><para>Specify &true; to force creation of a unique index where the collection may contain duplicate values for a key. MongoDB will index the first occurrence of a key and delete all subsequent documents from the collection that contain a duplicate value for that key. The default value is &false;.</para><warning xmlns="http://docbook.org/ns/docbook"><para><literal>"dropDups"</literal> may delete data from your database. Use with extreme caution.</para></warning><note xmlns="http://docbook.org/ns/docbook"><para>This option is not supported on MongoDB 2.8+. Index creation will fail if the collection contains duplicate values.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.expireafterseconds '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"expireAfterSeconds"</literal></para><para>The value of this option should specify the number of seconds after which a document should be considered expired and automatically removed from the collection. This option is only compatible with single-field indexes where the field will contain <classname>MongoDate</classname> values.</para><note xmlns="http://docbook.org/ns/docbook"><para>This feature is available in MongoDB 2.2+. See <link xlink:href="&url.mongodb.docs.expire_data;" xmlns:xlink="http://www.w3.org/1999/xlink">Expire Data from Collections by Setting TTL</link> for more information.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.name '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"name"</literal></para><para>A optional name that uniquely identifies the index.</para><note xmlns="http://docbook.org/ns/docbook"><para>By default, the driver will generate an index name based on the index&apos;s field(s) and ordering or type. For example, a compound index <literal>array("x" => 1, "y" => -1)</literal> would be named <literal>"x_1_y_-1"</literal> and a geospatial index <literal>array("loc" => "2dsphere")</literal> would be named <literal>"loc_2dsphere"</literal>. For indexes with many fields, it is possible that the generated name might exceed MongoDB&apos;s <link xlink:href="&url.mongodb.docs.limits;#Index-Name-Length" xmlns:xlink="http://www.w3.org/1999/xlink">limit for index names</link>. The <literal>"name"</literal> option may be used in that case to supply a shorter name.</para></note></listitem>'>
<!ENTITY mongo.index.parameters.sparse '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"sparse"</literal></para><para>Specify &true; to create a sparse index, which only indexes documents containing a specified field. The default value is &false;.</para></listitem>'>
<!ENTITY mongo.index.parameters.unique '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"unique"</literal></para><para>Specify &true; to create a unique index. The default value is &false;. This option applies only to ascending/descending indexes.</para><note xmlns="http://docbook.org/ns/docbook"><para>When MongoDB indexes a field, if a document does not have a value for the field, a &null; value is indexed. If multiple documents do not contain a field, a unique index will reject all but the first of those documents. The <literal>"sparse"</literal> option may be used to overcome this, since it will prevent documents without the field from being indexed.</para></note></listitem>'>
<!ENTITY mongo.listcollections.note '<note xmlns="http://docbook.org/ns/docbook"><simpara>This method will use the <link xlink:href="&url.mongodb.docs.command;listCollections" xmlns:xlink="http://www.w3.org/1999/xlink">listCollections</link> database command when communicating with MongoDB 2.8+. For previous database versions, the method will query the special <literal>system.namespaces</literal> collection.</simpara></note>'>
<!ENTITY mongo.listcollections.parameters.filter '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"filter"</literal></para><para>Optional query criteria. If provided, this criteria will be used to filter the collections included in the result.</para><para>Relevant fields that may be queried include <literal>"name"</literal> (collection name as a string, without the database name prefix) and <literal>"options" (object containing options used to create the collection).</literal>.</para><note><simpara>MongoDB 2.6 and earlier versions require the <literal>"name"</literal> criteria, if specified, to be a string value (i.e. equality match). This is because the driver must prefix the value with the database name in order to query the <literal>system.namespaces</literal> collection. Later versions of MongoDB do not have this limitation, as the driver will use the listCollections command.</simpara></note></listitem>'>
<!ENTITY mongo.listcollections.parameters.includesystemcollections '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"includeSystemCollections"</literal></para><para>Boolean, defaults to &false;. Determines whether system collections should be included in the result.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcern '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"w"</literal></para><para>See <link linkend="mongo.writeconcerns">Write Concerns</link>. The default value for <classname>MongoClient</classname> is <literal>1</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wtimeout"</literal></para><para>Deprecated alias for <literal>"wTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.writes.parameters.writeconcerntimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"wTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for <link linkend="mongo.writeconcerns">write concern</link> acknowledgement. It is only applicable when <literal>"w"</literal> is greater than <literal>1</literal>, as the timeout pertains to replication. If the write concern is not satisfied within the time limit, a <classname>MongoCursorException</classname> will be thrown. A value of <literal>0</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>10000</literal> (ten seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.fsync '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"fsync"</literal></para><para>Boolean, defaults to &false;. If journaling is enabled, it works exactly like <literal>"j"</literal>. If journaling is not enabled, the write operation blocks until it is synced to database files on disk. If &true;, an acknowledged insert is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If journaling is enabled, users are strongly encouraged to use the <literal>"j"</literal> option instead of <literal>"fsync"</literal>. Do not use <literal>"fsync"</literal> and <literal>"j"</literal> simultaneously, as that will result in an error.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.sockettimeoutms '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"socketTimeoutMS"</literal></para><para>This option specifies the time limit, in milliseconds, for socket communication. If the server does not respond within the timeout period, a <classname>MongoCursorTimeoutException</classname> will be thrown and there will be no way to determine if the server actually handled the write or not. A value of <literal>-1</literal> may be specified to block indefinitely. The default value for <classname>MongoClient</classname> is <literal>30000</literal> (30 seconds).</para></listitem>'>
<!ENTITY mongo.writes.parameters.journal '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"j"</literal></para><para>Boolean, defaults to &false;. Forces the write operation to block until it is synced to the journal on disk. If &true;, an acknowledged write is implied and this option will override setting <literal>"w"</literal> to <literal>0</literal>.</para><note><simpara>If this option is used and journaling is disabled, MongoDB 2.6+ will raise an error and the write will fail; older server versions will simply ignore the option.</simpara></note></listitem>'>
<!ENTITY mongo.writes.parameters.safe '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"safe"</literal></para><para>Deprecated. Please use the <link linkend="mongo.writeconcerns">write concern</link> <literal>"w"</literal> option.</para></listitem>'>
<!ENTITY mongo.writes.parameters.timeout '<listitem xmlns="http://docbook.org/ns/docbook"><para><literal>"timeout"</literal></para><para>Deprecated alias for <literal>"socketTimeoutMS"</literal>.</para></listitem>'>
<!ENTITY mongo.errors.exceptions.writeconcern '<para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorException</classname> if the <literal>"w"</literal> option is set and the write fails.</para><para xmlns="http://docbook.org/ns/docbook">Throws <classname>MongoCursorTimeoutException</classname> if the <literal>"w"</literal> option is set to a value greater than one and the operation takes longer than <varname>MongoCursor::$timeout</varname> milliseconds to complete.  This does not kill the operation on the server, it is a client-side timeout. The operation in <varname>MongoCollection::$wtimeout</varname> is milliseconds.</para>'>
<!ENTITY mongo.errors.deprecated '<para xmlns="http://docbook.org/ns/docbook">Issues <constant>E_DEPRECATED</constant> warning</para>'>
<!ENTITY mongo.gridfs.store.metadata.note '<note xmlns="http://docbook.org/ns/docbook"><para>These fields may also overwrite those that would be created automatically by the driver, as described in the MongoDB core documentation for the <link xlink:href="&url.mongodb.docs.gridfs;#the-files-collection" xmlns:xlink="http://www.w3.org/1999/xlink">files collection</link>. Some practical use cases for this behavior would be to specify a custom <literal>chunkSize</literal> or <literal>_id</literal> for the file.</para></note>'>
<!ENTITY mongo.gridfs.store.return '<para xmlns="http://docbook.org/ns/docbook">Returns the <literal>_id</literal> of the saved file document. This will be a generated <classname>MongoId</classname> unless an <literal>_id</literal> was explicitly specified in the <parameter>metadata</parameter> parameter.</para>'>
<!ENTITY mongo.mongowritebatch.writeoptions.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>An array of Write Options.<informaltable><thead><row><entry>key</entry><entry>value meaning</entry></row></thead><tbody><row><entry>w (int|string)</entry><entry><link linkend="mongo.writeconcerns">Write concern</link> value</entry></row><row><entry>wtimeout (int)</entry><entry><link linkend="mongo.writeconcerns">Maximum time to wait for replication</link></entry></row><row><entry>ordered</entry><entry>Determines if MongoDB must apply this batch in order. Ordered writes execute serially (i.e. one at a time) and execution will stop after the first error. Unordered writes may execute in parallel and execution will not stop after the first error. Defaults to &true;</entry></row><row><entry>j (bool)</entry><entry>Wait for journaling on the primary. This value is discouraged, use WriteConcern instead</entry></row><row><entry>fsync (bool)</entry><entry>Wait for fsync on the primary. This value is discouraged, use WriteConcern instead</entry></row></tbody></informaltable></para></listitem>'>
<!ENTITY mongo.mongowritebatch.collection.description '<listitem xmlns="http://docbook.org/ns/docbook"><para>The <classname>MongoCollection</classname> to execute the batch on. Its <link linkend="mongo.writeconcerns">write concern</link> will be copied and used as the default write concern if none is given as <parameter>$write_options</parameter> or during <methodname>MongoWriteBatch::execute</methodname>.</para></listitem>'>
<!ENTITY mongo.context.server ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>server</parameter> </term> <listitem> <para> An array containing the basic information about the server that was picked. <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>hash</entry> <entry>server hash, example: <literal>localhost:27017;-;X;56052</literal></entry> </row> <row> <entry>type</entry> <entry>Node type (primary/secondary/mongos/arbiter): <literal>2</literal></entry> </row> <row> <entry>max_bson_size</entry> <entry>The maximum BSON Size over the wire this node accepts: <literal>16777216</literal></entry> </row> <row> <entry>max_message_size</entry> <entry>The maximum Message Size over the wire this node accepts: <literal>48000000</literal></entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.writeoptions '<varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>writeOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>ordered</entry> <entry>boolean, if the operation (in case of batch operation) must be executed sequentually (ordered=true)</entry> </row> <row> <entry>writeConcern</entry> <entry>An array of writeConcern options (see below)</entry> </row> </tbody> </tgroup> </informaltable> <table> <title>writeConcern array values</title> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>fsync</entry> <entry>boolean, force flushing to disk before returning</entry> </row> <row> <entry>j</entry> <entry>boolean, force journal write before returning</entry> </row> <row> <entry>wtimeout</entry> <entry>integer, milliseconds, maximum time the primary is allowed to wait to verify replication</entry> </row> <row> <entry>w</entry> <entry>integer=server count, or string=replication-tag</entry> </row> </tbody> </tgroup> </table> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.context.protocoloptions ' <varlistentry xmlns="http://docbook.org/ns/docbook"> <term> <parameter>protocolOptions</parameter> </term> <listitem> <para> <informaltable> <tgroup cols="2"> <thead> <row> <entry>key</entry> <entry>value</entry> </row> </thead> <tbody> <row> <entry>message_length</entry> <entry>The total size (in bytes) of the encoded message being sent over the wire</entry> </row> <row> <entry>request_id</entry> <entry>The request identifier for this message: <literal>42</literal></entry> </row> <row> <entry>namespace</entry> <entry>The MongoDB namespace used for the protocol message <literal>dbname.collectionname</literal></entry> </row> </tbody> </tgroup> </informaltable> </para> </listitem> </varlistentry>'>
<!ENTITY mongo.alternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this class
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
Alternatives to this class include:</para>'>
<!ENTITY mongo.noalternative.class.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this class
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this class in the new extension.</para>'>
<!ENTITY mongo.alternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
Alternatives to this method include:</para>'>
<!ENTITY mongo.noalternative.method.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this method in the new extension.</para>'>
<!ENTITY mongo.alternative.phplib.note '<para
xmlns="http://docbook.org/ns/docbook">This extension that defines this method
is deprecated. Instead, the <link linkend="set.mongodb">MongoDB</link> extension should be used.
There is no equivalent for this method in the new extension, but there is an
alternative in the <link linkend="mongodb.overview">PHP library</link>:</para>'>

<!ENTITY mongo.deprecated.note '<para
xmlns="http://docbook.org/ns/docbook">Diese Erweiterung ist veraltet.
Stattdessen sollte die Erweiterung
<link linkend="set.mongodb">MongoDB</link> verwendet werden.</para>'>

<!-- TRANSLATE!!! -->
<!-- mongodb -->
<!ENTITY mongodb.changelog.tentative-return-types '
       <row xmlns="http://docbook.org/ns/docbook">
        <entry>PECL mongodb 1.15.0</entry>
        <entry>
         Rückgabetypen für Methoden werden in PHP 8.0 und neuer als vorläufig
         deklariert, was in Code, der diese Schnittstelle implementiert, ohne
         die entsprechenden Rückgabetypen zu deklarieren, einen Hinweis auf eine
         veraltete Verwendung auslöst. Um diesen Hinweis zu unterdrücken, kann
         das Attribut <code>#[ReturnTypeWillChange]</code> hinzugefügt werden.
        </entry>
       </row>
'>

<!ENTITY mongodb.option.collation '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>collation</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Die <link xlink:href="&url.mongodb.docs.collation;" xmlns:xlink="http://www.w3.org/1999/xlink">Collation</link> (Vergleichs-/Sortierregel) ermöglicht es dem Benutzer, sprachspezifische Regeln für den Vergleich von Zeichenketten anzugeben, so &zb; Regeln für die Groß- und Kleinschreibung und Akzentzeichen. Bei der Angabe der Sortierung ist das Feld <literal>"locale"</literal> obligatorisch; alle anderen Sortierfelder sind optional. Die Beschreibungen der Felder sind unter <link xlink:href="&url.mongodb.docs.collation;#collation-document" xmlns:xlink="http://www.w3.org/1999/xlink">Collation Document</link> zu finden.
           </para>
           <para>
            Wenn keine Kollation angegeben wurde, aber die Sammlung eine Standardkollation hat, verwendet die Operation die für die Sammlung angegebene Kollation. Wenn weder für die Sammlung noch für die Operation eine Kollation angegeben wurde, verwendet MongoDB den einfachen binären Vergleich, der in früheren Versionen für den Vergleich von Zeichenketten verwendet wurde.
           </para>
           <para>
            Diese Option ist ab MongoDB 3.4 verfügbar. Wenn sie bei einer älteren Serverversion angegeben wird, kommt es bei der Ausführung zu einer Exception.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.let '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>let</entry>
          <entry><type class="union"><type>array</type><type>object</type></type></entry>
          <entry>
           <para>
            Die Zuordnung von Parameternamen und -werten. Die Werte müssen Konstanten oder geschlossene Ausdrücke sein, die nicht auf Dokumentfelder verweisen. Auf die Parameter kann dann als Variablen im Kontext eines aggregierten Ausdrucks zugegriffen werden (&zb; <literal>$$var</literal>).
           </para>
           <para>
            Diese Option ist ab MongoDB 5.0 verfügbar. Wenn sie bei einer älteren Serverversion angegeben wird, kommt es bei der Ausführung zu einer Exception.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultClient '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultClient</entry>
          <entry><classname>MongoDB\Driver\Manager</classname></entry>
          <entry>Der Manager, der verwendet wird, um Datenschlüssel-Abfragen auf einen anderen MongoDB-Cluster zu routen. Standardmäßig werden der aktuelle Manager und Cluster verwendet.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.keyVaultNamespace '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>keyVaultNamespace</entry>
          <entry><type>string</type></entry>
          <entry>Ein vollständig qualifizierter Namensraum (&zb; <literal>"databaseName.collectionName"</literal>), der die Kollektion bezeichnet, die alle Datenschlüssel enthält, die für Ver- und Entschlüsselung verwendet werden. Diese Option muss angegeben werden.</entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.kmsProviders '
         <row xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
          <entry>kmsProviders</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Ein Dokument, das die Konfiguration für einen oder mehrere KMS-Provider enthält, die verwendet werden, um Datenschlüssel zu verschlüsseln. Zu den unterstützten Providern gehören <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal>, <literal>"kmip"</literal> und <literal>"local"</literal> und wenigstens einer muss angegeben werden.
           </para>
           <para>
            Wenn für <literal>"aws"</literal>, <literal>"azure"</literal> oder
            <literal>"gcp"</literal> ein leeres Dokument angegeben wird,
            versucht der Treiber, den Provider mit
            <link xlink:href="&url.mongodb.specs;/blob/master/source/client-side-encryption/client-side-encryption.rst#automatic-credentials">Automatic Credentials</link>
            (automatische Anmeldeinformationen) zu konfigurieren.
           </para>
           <para>
            Das Format für <literal>"aws"</literal> ist wie folgt:
           </para>
           <programlisting role="javascript">
<![CDATA[
aws: {
    accessKeyId: <string>,
    secretAccessKey: <string>,
    sessionToken: <optional string>
}
]]>
           </programlisting>
           <para>
            Das Format für <literal>"azure"</literal> ist wie folgt:
           </para>
           <programlisting role="javascript">
<![CDATA[
azure: {
    tenantId: <string>,
    clientId: <string>,
    clientSecret: <string>,
    identityPlatformEndpoint: <optional string> // Der Standardwert ist "login.microsoftonline.com"

}
]]>
           </programlisting>
           <para>
            Das Format für <literal>"gcp"</literal> ist wie folgt:
           </para>
           <programlisting role="javascript">
<![CDATA[
gcp: {
    email: <string>,
    privateKey: <base64 string>|<MongoDB\BSON\Binary>,
    endpoint: <optional string> // Der Standardwert ist "oauth2.googleapis.com"

}
]]>
           </programlisting>
           <para>
            Das Format für <literal>"kmip"</literal> ist wie folgt:
           </para>
           <programlisting role="javascript">
<![CDATA[
kmip: {
    endpoint: <string>
}
]]>
           </programlisting>
           <para>
          Das Format für <literal>"local"</literal> ist wie folgt:
           </para>
           <programlisting role="javascript">
<![CDATA[
local: {
    // Der 96-Byte-Hauptschlüssel, der zur Ver- und Entschlüsselung von
    // Datenschlüsseln verwendet wird
    key: <base64 string>|<MongoDB\BSON\Binary>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.encryption.masterKey-options-by-provider '
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"aws"</literal>-Provider-Optionen</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Typ</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>region</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>key</entry>
       <entry>string</entry>
       <entry>Erforderlich; der Amazon-Ressourcenname (ARN) für den AWS-Kundenhauptschlüssel (CMK).</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional; ein alternativer Host-Bezeichner, an den KMS-Anfragen gesendet werden; kann die Portnummer enthalten.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"azure"</literal>-Provider-Optionen</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Typ</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyVaultEndpoint</entry>
       <entry>string</entry>
       <entry>Erforderlich; der Host mit optionalem Port (&zb; "example.vault.azure.net").</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional; eine bestimmte Version des genannten Schlüssels. Standardmäßig wird die primäre Version des Schlüssels verwendet.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"gcp"</literal>-Provider-Optionen</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Typ</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>projectId</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>location</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>keyRing</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>keyName</entry>
       <entry>string</entry>
       <entry>Erforderlich</entry>
      </row>
      <row>
       <entry>keyVersion</entry>
       <entry>string</entry>
       <entry>Optional; eine bestimmte Version des genannten Schlüssels. Standardmäßig wird die primäre Version des Schlüssels verwendet.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional; der Host mit optionalem Port. Der Standardwert ist "cloudkms.googleapis.com".</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   <table>
    <title><literal>"kmip"</literal>-Provider-Optionen</title>
    <tgroup cols="3">
     <thead>
      <row>
       <entry>Option</entry>
       <entry>Typ</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry>keyId</entry>
       <entry>string</entry>
       <entry>Optional; der eindeutige Bezeichner für ein 96 Byte großes, verwaltetes geheimes KMIP-Datenobjekt. Wenn nicht angegeben, erstellt der Treiber ein zufälliges geheimes KMIP-Datenobjekt mit 96 Byte.</entry>
      </row>
      <row>
       <entry>endpoint</entry>
       <entry>string</entry>
       <entry>Optional; der Host mit optionalem Port.</entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
'>
<!ENTITY mongodb.option.encryption.tlsOptions '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>tlsOptions</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Ein Dokument, das die TLS-Konfiguration für einen oder mehrere KMS-Provider enthält. Zu den unterstützten Providern gehören <literal>"aws"</literal>, <literal>"azure"</literal>, <literal>"gcp"</literal> und <literal>"kmip"</literal>. Alle Provider unterstützen die folgenden Optionen:
           </para>
           <programlisting role="javascript">
<![CDATA[
<provider>: {
    tlsCaFile: <optionale Zeichenkette>,
    tlsCertificateKeyFile: <optionale Zeichenkette>,
    tlsCertificateKeyFilePassword: <optionale Zeichenkette>,
    tlsDisableOCSPEndpointCheck: <optionaler Boolean>
}
]]>
           </programlisting>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.maxCommitTimeMS '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>maxCommitTimeMS</entry>
          <entry>integer</entry>
          <entry>
           <para>
            Die maximale Dauer in Millisekunden, die ein einziger
            <literal>commitTransaction</literal>-Befehl beanspruchen darf.
           </para>
           <para>
            Wenn angegeben, muss <literal>maxCommitTimeMS</literal> eine
            vorzeichenbehaftete 32-bit Ganzzahl größer als oder gleich Null
            sein.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readConcern</entry>
          <entry><classname>MongoDB\Driver\ReadConcern</classname></entry>
          <entry>
           <para>
            A read concern to apply to the operation.
           </para>
           <para>
            This option is available in MongoDB 3.2+ and will result in an
            exception at execution time if specified for an older server
            version.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.readPreference '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>readPreference</entry>
          <entry><classname>MongoDB\Driver\ReadPreference</classname></entry>
          <entry>
           <para>
            A read preference to use for selecting a server for the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.session '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>session</entry>
          <entry><classname>MongoDB\Driver\Session</classname></entry>
          <entry>
           <para>
            A session to associate with the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.option.transactionReadWriteConcern '
     <warning xmlns="http://docbook.org/ns/docbook">
      <para>
       If you are using a <literal>"session"</literal> which has a transaction
       in progress, you cannot specify a <literal>"readConcern"</literal> or
       <literal>"writeConcern"</literal> option. This will result in an
       <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>
       being thrown. Instead, you should set these two options when you create
       the transaction with
       <methodname>MongoDB\Driver\Session::startTransaction</methodname>.
      </para>
     </warning>
'>
<!ENTITY mongodb.option.writeConcern '
         <row xmlns="http://docbook.org/ns/docbook">
          <entry>writeConcern</entry>
          <entry><classname>MongoDB\Driver\WriteConcern</classname></entry>
          <entry>
           <para>
            A write concern to apply to the operation.
           </para>
          </entry>
         </row>
'>
<!ENTITY mongodb.parameter.namespace '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>namespace</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      A fully qualified namespace (e.g. <literal>"databaseName.collectionName"</literal>).
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.db '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>db</parameter> (<type>string</type>)</term>
    <listitem>
     <para>
      The name of the database on which to execute the command.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.bulkwrite '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>bulk</parameter> (<classname>MongoDB\Driver\BulkWrite</classname>)</term>
    <listitem>
     <para>
      The write(s) to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.command '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>command</parameter> (<classname>MongoDB\Driver\Command</classname>)</term>
    <listitem>
     <para>
      The command to execute.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.encryptOpts '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>options</parameter></term>
    <listitem>
     <para>
      <table>
       <title>Verschlüsselungsoptionen</title>
       <tgroup cols="3">
        <thead>
         <row>
          <entry>Option</entry>
          <entry>Typ</entry>
          <entry>&Description;</entry>
         </row>
        </thead>
        <tbody>
         <row>
          <entry>algorithm</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Der zu verwendende Verschlüsselungsalgorithmus. Diese Option ist
            erforderlich und es muss eine der folgenden
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption-Konstanten</link>
            angegeben werden:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_DETERMINISTIC</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::AEAD_AES_256_CBC_HMAC_SHA_512_RANDOM</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_UNINDEXED</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant></member>
           </simplelist>
          </entry>
         </row>
         <row>
          <entry>contentionFactor</entry>
          <entry><type>int</type></entry>
          <entry>
           <para>
            The contention factor for evaluating queries with indexed, encrypted
            payloads.
           </para>
           <para>
            This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyAltName</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            Identifies a key vault collection document by
            <literal>keyAltName</literal>. This option is mutually exclusive
            with <literal>keyId</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>keyId</entry>
          <entry><classname>MongoDB\BSON\Binary</classname></entry>
          <entry>
           <para>
            Identifies a data key by <literal>_id</literal>. The value is a UUID
            (binary subtype 4). This option is mutually exclusive with
            <literal>keyAltName</literal> and exactly one is required.
           </para>
          </entry>
         </row>
         <row>
          <entry>queryType</entry>
          <entry><type>string</type></entry>
          <entry>
           <para>
            The query type for evaluating queries with indexed, encrypted
            payloads. Specify one of the following
            <link linkend="mongodb-driver-clientencryption.constants">ClientEncryption constants</link>:
           </para>
           <simplelist>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_EQUALITY</constant></member>
            <member><constant>MongoDB\Driver\ClientEncryption::QUERY_TYPE_RANGE</constant></member>
           </simplelist>
           <para>This option only applies and may only be specified when
            <literal>algorithm</literal> is
            <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_INDEXED</constant>
            or <constant>MongoDB\Driver\ClientEncryption::ALGORITHM_RANGE</constant>.
           </para>
          </entry>
         </row>
         <row>
          <entry>rangeOpts</entry>
          <entry><type>array</type></entry>
          <entry>
           <para>
            Index options for a queryable encryption field supporting "range"
            queries. The options below must match the values set in the
            <literal>encryptedFields</literal> of the target collection. For
            double and decimal128 BSON field types, <literal>min</literal>,
            <literal>max</literal>, and <literal>precision</literal> must all be
            set, or all be unset.
           </para>
           <para>
            <table>
             <title>Range index options</title>
             <tgroup cols="3">
              <thead>
               <row>
                <entry>Option</entry>
                <entry>Type</entry>
                <entry>Description</entry>
               </row>
              </thead>
              <tbody>
               <row>
                <entry>min</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The minimum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>max</entry>
                <entry><type>mixed</type></entry>
                <entry>
                 Required if <literal>precision</literal> is set. The maximum
                 BSON value of the range.
                </entry>
               </row>
               <row>
                <entry>sparsity</entry>
                <entry><type>int</type></entry>
                <entry>Optional; Positive 64-bit integer.</entry>
               </row>
               <row>
                <entry>precision</entry>
                <entry><type>int</type></entry>
                <entry>
                 Optional. Positive 32-bit integer specifying precision to use
                 for explicit encryption. May only be set for double or
                 decimal128 BSON field types.
                </entry>
               </row>
               <row>
                <entry>trimFactor</entry>
                <entry><type>int</type></entry>
                <entry>Optional; Positive 32-bit integer.</entry>
               </row>
              </tbody>
             </tgroup>
            </table>
           </para>
          </entry>
         </row>
        </tbody>
       </tgroup>
      </table>
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.query '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>query</parameter> (<classname>MongoDB\Driver\Query</classname>)</term>
    <listitem>
     <para>
      Die auszuführende Abfrage.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.typeMap '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>typeMap</parameter> (<type>array</type>)</term>
    <listitem>
     <para>
      <link linkend="mongodb.persistence.typemaps">Konfiguration der Typzuordnung</link>.
     </para>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.parameter.filter '
   <varlistentry xmlns="http://docbook.org/ns/docbook">
    <term><parameter>filter</parameter> (<type class="union"><type>array</type><type>object</type></type>)</term>
    <listitem>
     <para>
      Das <link xlink:href="&url.mongodb.docs;tutorial/query-documents/" xmlns:xlink="http://www.w3.org/1999/xlink">Abfrage-Prädikat</link>.
      Ein leeres Prädikat passt auf alle Dokumente in der Sammlung.
     </para>
     <note>
      <simpara>
       Bei der Auswertung von Abfragekriterien vergleicht MongoDB Typen und Werte gemäß seiner eigenen
       <link xlink:href="&url.mongodb.docs;reference/bson-type-comparison-order/" xmlns:xlink="http://www.w3.org/1999/xlink">Vergleichsregeln für BSON-Typen</link>, die sich von PHPs Regeln für <link linkend="types.comparisons">Typenvergleich</link> und <link linkend="language.types.type-juggling">Typen-Jonglage</link> unterscheidet. Wenn es eine Übereinstimmung mit einem speziellen BSON-Typ gibt, sollten die Abfragekriterien die entsprechende <link linkend="book.bson">BSON-Klasse</link> verwenden (&zb; <classname>MongoDB\BSON\ObjectId</classname>, um auf eine <link xlink:href="&url.mongodb.docs.objectid;" xmlns:xlink="http://www.w3.org/1999/xlink">ObjectId</link> zu passen).
      </simpara>
     </note>
    </listitem>
   </varlistentry>
'>
<!ENTITY mongodb.returns.cursor '<para xmlns="http://docbook.org/ns/docbook">Gibt bei Erfolg einen <classname>MongoDB\Driver\Cursor</classname> zurück.</para>'>
<!ENTITY mongodb.returns.writeresult '<para xmlns="http://docbook.org/ns/docbook">Gibt bei Erfolg ein <classname>MongoDB\Driver\WriteResult</classname> zurück.</para>'>
<!ENTITY mongodb.throws.std '&mongodb.throws.argumentparsing;&mongodb.throws.connection;&mongodb.throws.authentication;'>
<!ENTITY mongodb.throws.session-readwriteconcern '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, wenn die Option <literal>"session"</literal> mit einer zugehörigen Transaktion in Kombination mit einer der Optionen <literal>"readConcern"</literal> oder <literal>"writeConcern"</literal> verwendet wird.</member>'>
<!ENTITY mongodb.throws.session-unacknowledged '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, wenn die Option <literal>"session"</literal> in Kombination mit einer unbestätigten Schreibanweisung verwendet wird.</member>'>
<!ENTITY mongodb.throws.bulkwriteexception '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\BulkWriteException</classname>, wenn ein Schreibvorgang fehlschlägt (&zb; wegen eines Schreibfehlers oder eines Fehlers bei der Anwendung einer Schreibanweisung).</member>'>
<!ENTITY mongodb.throws.argumentparsing '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\InvalidArgumentException</classname>, wenn beim Analysieren von Argumenten ein Fehler auftritt.</member>'>
<!ENTITY mongodb.throws.authentication '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\AuthenticationException</classname>, wenn eine Authentifizierung erforderlich ist und fehlschlägt.</member>'>
<!ENTITY mongodb.throws.connection '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\ConnectionException</classname>, wenn der Aufbau einer Verbindung zum Server fehlschlägt (aus einem anderen Grund als der Authentifizierung).</member>'>
<!ENTITY mongodb.throws.bson.unexpected '<member xmlns="http://docbook.org/ns/docbook">Wirft eine <classname>MongoDB\Driver\Exception\UnexpectedValueException</classname>, wenn die Eingabe nicht genau ein BSON-Dokument enthält. Mögliche Gründe sind unter anderem ungültiges BSON, zusätzliche Daten (nach dem Lesen eines BSON-Dokuments) oder ein unerwarteter <link xlink:href="&url.mongodb.libbson;" xmlns:xlink="http://www.w3.org/1999/xlink">libbson</link>-Fehler.</member>'>

<!-- Not used in EN anymore -->
<!ENTITY mongodb.note.queryable-encryption-preview ''>

<!ENTITY mongodb.note.decimal128 '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     <classname>MongoDB\BSON\Decimal128</classname> ist nur mit MongoDB 3.4+
     kompatibel. Der Versuch, den Typ BSON mit einer früheren Version von
     MongoDB zu verwenden, führt zu einem Fehler.
    </simpara>
   </note>
'>
<!ENTITY mongodb.note.extended-json '
  <note xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
   <simpara>
    Die Ausgabe entspricht der Funktion <function>MongoDB\BSON\toJSON</function>,
    die das alte, treiberspezifische erweiterte JSON-Format verwendet. Dies
    entspricht nicht unbedingt den erweiterten JSON-Formaten
    <link xlink:href="&url.mongodb.specs.extendedjson;#relaxed-extended-json-example">relaxed</link>
    oder <link xlink:href="&url.mongodb.specs.extendedjson;#canonical-extended-json-example">canonical</link>,
    die von <function>MongoDB\BSON\toRelaxedExtendedJSON</function> bzw.
    <function>MongoDB\BSON\toCanonicalExtendedJSON</function> verwendet werden.
   </simpara>
  </note>
'>
<!ENTITY mongodb.note.forking '
   <note xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Auf Unix-Plattformen reagiert die Erweiterung empfindlich auf
     Skripte, die den Systemaufruf fork() verwenden, ohne auch exec()
     aufzurufen. Es wird davon abgeraten,
     <classname>MongoDB\Driver\Manager</classname>-Instanzen in einem
     geforkten Kindprozess wiederzuverwenden.
    </simpara>
   </note>
'>

<!ENTITY mongodb.note.uint32 '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Da der Integer-Typ bei PHP vorzeichenbehaftet ist, könnten einige Werte,
    die von dieser Methode zurückgegeben werden, auf 32-Bit-Plattformen als
    negative Ganzzahlen erscheinen. Um eine Zeichenketten-Darstellung des
    Dezimalwertes ohne Vorzeichen zu erhalten, kann das Formatierungszeichen
    <literal>"&#37;u"</literal> von <function>sprintf</function> verwendet werden.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.readpreference '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Die Option <literal>"readPreference"</literal> steuert nicht den Server,
    an den der Treiber die Operation ausgibt; sie wird immer auf diesem
    Serverobjekt ausgeführt. Stattdessen kann sie verwendet werden, wenn die
    Operation an einen sekundären Knoten (von einer Replikatsatzverbindung,
    keinen eigenständigen) oder einen Mongos-Knoten ausgegeben wird, um
    sicherzustellen, dass der Treiber das Übertragungsprotokoll entsprechend
    einstellt bzw. die Lesepräferenz zur Operation hinzufügt.
   </simpara>
  </note>
'>

<!ENTITY mongodb.note.server.write '
  <note xmlns="http://docbook.org/ns/docbook">
   <simpara>
    Es liegt in der Verantwortung des aufrufenden Codes, sicherzustellen, dass
    der Server in der Lage ist, den Schreibvorgang auszuführen. So schlägt
    beispielsweise die Ausführung eines Schreibvorgangs auf einem sekundären
    Server (mit Ausnahme seiner "lokalen" Datenbank) fehl.
   </simpara>
  </note>
'>

<!ENTITY mongodb.warning.duplicate-keys '
   <warning xmlns="http://docbook.org/ns/docbook">
    <simpara>
     Da Dokumente als Liste von Schlüssel-Wert-Paaren gespeichert werden,
     können BSON-Dokumente technisch gesehen doppelte Schlüssel enthalten;
     Anwendungen sollten allerdings davon absehen, Dokumente mit doppelten
     Schlüsseln zu erzeugen, da das Verhalten von Server und Treiber
     undefiniert sein kann. Der Grund dafür ist, dass PHP-Objekte und -Arrays
     keine doppelten Schlüssel haben können, weshalb bei der Dekodierung eines
     BSON-Dokuments mit doppelten Schlüsseln Daten verloren gehen können.
    </simpara>
   </warning>
'>

<!-- Radius -->
<!ENTITY radius.request.required '<note xmlns="http://docbook.org/ns/docbook"><para>Bevor diese Funktion aufgerufen werden kann, muss mittels <function>radius_create_request</function> eine Anfrage erstellt werden.</para></note>'>
<!ENTITY radius.parameter.attribute-type '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>type</parameter></term><listitem><para>Der Typ des Attributs.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.handle '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>radius_handle</parameter></term><listitem><para>Die RADIUS-Ressource.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.options '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>options</parameter></term><listitem><para>Eine Bitmaske der Attribut-Optionen; zur Verfügung stehen die Optionen <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> und <link linkend="constant.radius-option-salt"><constant>RADIUS_OPTION_SALT</constant></link>.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.tag '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>tag</parameter></term><listitem><para>Das Attribut-Tag. Dieser Parameter wird nur berücksichtigt, wenn die Option <link linkend="constant.radius-option-tagged"><constant>RADIUS_OPTION_TAGGED</constant></link> gesetzt ist.</para></listitem></varlistentry>'>
<!ENTITY radius.parameter.vendor '<varlistentry xmlns="http://docbook.org/ns/docbook"><term><parameter>vendor</parameter></term><listitem><para>Die Anbieter-ID.</para></listitem></varlistentry>'>

<!-- posix snippets -->
<!ENTITY posix.parameter.fd '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>file_descriptor</parameter></term>
 <listitem>
  <para>
   Der Dateideskriptor, welcher entweder eine Datei-<type>Ressource</type>
   oder ein Wert vom Typ <type>int</type> sein sollte. Ist dies ein
   <type>int</type>, dann wird davon ausgegangen, dass es sich um einen
   Dateideskriptor handelt, welcher direkt an den zugrundeliegenden
   Systemaufruf übergeben werden kann.
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY posix.rlimits '
<para xmlns="http://docbook.org/ns/docbook">
 Zu jeder Ressource gehören ein weicher und ein harter Grenzwert. Der weiche
 Grenzwert ist der Wert, den der Kernel für die entsprechende Ressource
 erzwingt. Der harte Grenzwert wirkt als Obergrenze für den weichen Grenzwert.
 Ein unprivilegierter Prozess darf seinen weichen Grenzwert nur auf einen Wert
 von 0 bis zum harten Grenzwert setzen und seinen harten Grenzwert
 unwiderruflich verringern.
</para>
'>

<!-- strings snippets -->
<!ENTITY strings.parameter.encoding '
 <para xmlns="http://docbook.org/ns/docbook">
  Ein optionaler Parameter, der die Zeichenkodierung für eine Konvertierung
  definiert.
 </para>
 <para xmlns="http://docbook.org/ns/docbook">
  Wird der Parameter <parameter>encoding</parameter> ausgelassen, so wird
  der Wert der Konfigurationsoption
  <link linkend="ini.default-charset">default_charset</link> als Standardwert
  dafür verwendet.
 </para>
 <para xmlns="http://docbook.org/ns/docbook">
  Obwohl dieser Parameter technisch gesehen optional ist, wird dringend
  empfohlen, den korrekten Wert für den jeweiligen Code anzugeben, falls die
  Konfigurationsoption
  <link linkend="ini.default-charset">default_charset</link> für die jeweilige
  Eingabe möglicherweise falsch gesetzt ist.
 </para>
'>

<!ENTITY strings.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>format</parameter></term>
 <listitem>
  <para>
   Der Formatstring setzt sich aus keiner oder mehreren Anweisungen
   zusammen: Normale Zeichen (abgesehen von <literal>&#37;</literal>),
   die direkt in das Ergebnis kopiert werden und
   <emphasis>Konvertierungsanweisungen</emphasis>, die jeweils ihre
   eigenen Parameter abrufen.
  </para>
  <para>
   Eine Konvertierungsanweisung folgt diesem Prototypen:
   <literal>&#37;[ArgNum$][Flags][Weite][.Präzision]Spezifizierer</literal>.
  </para>
  <formalpara>
   <title>ArgNum</title>
   <para>
    Eine Ganzzahl gefolgt von einem Dollarzeichen <literal>$</literal>, die die
    Nummer des Arguments angibt, das für die Konversion verwendet werden soll.
   </para>
  </formalpara>
  <para>
   <table>
    <title>Flags</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Flag</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>-</literal></entry>
       <entry>
        Linksbündig innerhalb der angegebenen Feldbreite;
        Rechtsbündig ist der Standard
       </entry>
      </row>
      <row>
       <entry><literal>+</literal></entry>
       <entry>
        Positive Zahlen mit einem Pluszeichen
        <literal>+</literal>; Standardmäßig werden nur negative
        Zahlen mit negativen Vorzeichen ausgegeben
       </entry>
      </row>
      <row>
       <entry><literal> </literal>(Leerzeichen)</entry>
       <entry>
        Füllt das Ergebnis mit Leerzeichen auf.
        Dies ist der Standard.
       </entry>
      </row>
      <row>
       <entry><literal>0</literal></entry>
       <entry>
        Füllt nach Links mit Nullen auf.
        Mit dem <literal>s</literal>-Spezifizierer
        kann dies auch nach rechts mit Nullen auffüllen.
       </entry>
      </row>
      <row>
       <entry><literal>&apos;</literal>(Zeichen)</entry>
       <entry>
        Füllt das Ergebnis mit dem angegebenen Zeichen auf.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <formalpara>
   <title>Breite</title>
   <para>
    Entweder eine Ganzzahl die angibt, wie viele Zeichen (Minimum) das
    Konvertierungsergebnis haben soll oder <literal>*</literal>. Wenn
    <literal>*</literal> verwendet wird, wird die Breite als zusätzlicher
    ganzzahliger Wert angegeben, der bestimmt, wie viele Zeichen vor dem durch
    den Spezifizierer formatierten Wert stehen sollen.
   </para>
  </formalpara>
  <formalpara>
   <title>Genauigkeit</title>
   <para>
    Ein Punkt <literal>.</literal>, optional gefolgt von einer Ganzzahl oder
    <literal>*</literal>, dessen Bedeutung vom Spezifizierer abhängt:
    <itemizedlist>
     <listitem>
      <simpara>
       Für die Spezifizierer <literal>e</literal>, <literal>E</literal>,
       <literal>f</literal> und <literal>F</literal>: Dies stellt die
       Anzahl der Nachkommastellen an, die nach dem Dezimaltrennzeichen
       ausgegeben werden soll (Standardmäßig ist dies 6).
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Für die Spezifizierer <literal>g</literal>, <literal>G</literal>,
       <literal>h</literal> und <literal>H</literal>:
       Die maximale Anzahl der auszugebenenden signifikanten
       Nachkommastellen.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Für den <literal>s</literal> Spezifizierer: Verhält sich wie ein
       Abschneidepunkt, der eine maximale Anzahl an Zeichen in der
       Zeichenkette angibt.
      </simpara>
     </listitem>
    </itemizedlist>
    <note>
     <simpara>
      Wenn der Punkt ohne einen expliziten Wert für die Genauigkeit angegeben
      wird, wird 0 angenommen. Wenn <literal>*</literal> verwendet wird, wird
      die Genauigkeit als zusätzliche Ganzzahl vor dem durch den Bezeichner
      formatierten Wert angegeben.
     </simpara>
    </note>
   </para>
  </formalpara>

  <para>
   <table>
    <title>Spezifizierer</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Spezifizierer</entry>
       <entry>&Description;</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><literal>&#37;</literal></entry>
       <entry>
        Ein Prozentzeichen. Kein Parameter nötig.
       </entry>
      </row>
      <row>
       <entry><literal>b</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl behandelt und
        als Binärzahl ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>c</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl behandelt und
        als Zeichen aus dem ASCII-Zeichensatz ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>d</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl behandelt und
        als (vorzeichenbehaftete) Dezimalzahl ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>e</literal></entry>
       <entry>
        Der Parameter wird als Zahl in wissenschaftlicher Schreibweise
        (&zb; 1.2e+2) behandelt.
       </entry>
      </row>
      <row>
       <entry><literal>E</literal></entry>
       <entry>
        Wie der Spezifizierer <literal>e</literal>, aber schreibt
        einen Großbuchstaben (&zb; 1.2E+2).
       </entry>
      </row>
      <row>
       <entry><literal>f</literal></entry>
       <entry>
        Der Parameter wird als Gleitkommazahl betrachtet
        und als Gleitkommazahl ausgegeben (abhängig von der Locale).
       </entry>
      </row>
      <row>
       <entry><literal>F</literal></entry>
       <entry>
        Der Parameter wird als Gleitkommazahl betrachtet
        und als Gleitkommazahl (unabhängig von der Locale) ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>g</literal></entry>
       <entry>
        <para>
         Generelles Format.
        </para>
        <para>
         Sei P gleich der Genauigkeit, wenn nicht Null, 6, wenn die Genauigkeit
         nicht angegeben ist, oder 1 wenn die Genauigkeit Null ist.
         Dann, wenn eine Konvertierung mittels E einen Exponenten von X hätte:
        </para>
        <para>
         Wenn P > X ≥ −4, erfolgt die Konvertierung mit Spezifizierer f und Genauigkeit
         P - (X + 1), andernfalls mit Spezifizierer e und Genauigkeit P - 1.
        </para>
       </entry>
      </row>
      <row>
       <entry><literal>G</literal></entry>
       <entry>
        Wie der Spezifizierer <literal>g</literal>, aber
        es wird <literal>E</literal> und <literal>f</literal> verwendet.
       </entry>
      </row>
      <row>
       <entry><literal>h</literal></entry>
       <entry>
        Wie der Spezifizierer <literal>g</literal>, aber es werden
        <literal>F</literal> verwendet. Verfügbar ab PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>H</literal></entry>
       <entry>
        Wie der Spezifizierer <literal>g</literal>, aber es werden
        <literal>E</literal> und <literal>F</literal> verwendet. Verfügbar ab
        PHP 8.0.0.
       </entry>
      </row>
      <row>
       <entry><literal>o</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl betrachtet und als Oktalzahl
        ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>s</literal></entry>
       <entry>
        Der Parameter wird als Zeichenkette betrachtet und ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>u</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl betrachtet und als
        vorzeichenlose Dezimalzahl ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>x</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl betrachtet und als
        Hexadezimalzahl (mit Kleinbuchstaben) ausgegeben.
       </entry>
      </row>
      <row>
       <entry><literal>X</literal></entry>
       <entry>
        Der Parameter wird als Ganzzahl betrachtet und als
        Hexadezimalzahl (mit Großbuchstaben) ausgegeben.
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
  <warning>
   <para>
    Der Spezifizierer <literal>c</literal> ignoriert Auffüllung und Weite.
   </para>
  </warning>
  <warning>
   <para>
    Der Versuch, die Kombination aus Zeichenketten mit Weite-Spezifizierern
    und Zeichensätzen die mehr als ein Byte pro zeichen erwarten zu verwenden,
    führt zu unvorhersehbaren Ergebnissen.
   </para>
  </warning>
  <para>
   Variablen werden auf einen für den Spezifizier passenden Typen umgewandelt:
   <table>
    <title>Typ-Behandlung</title>
    <tgroup cols="2">
     <thead>
      <row>
       <entry>Typ</entry>
       <entry>Spezifizierer</entry>
      </row>
     </thead>
     <tbody>
      <row>
       <entry><type>string</type></entry>
       <entry><literal>s</literal></entry>
      </row>
      <row>
       <entry><type>int</type></entry>
       <entry>
        <literal>d</literal>,
        <literal>u</literal>,
        <literal>c</literal>,
        <literal>o</literal>,
        <literal>x</literal>,
        <literal>X</literal>,
        <literal>b</literal>
       </entry>
      </row>
      <row>
       <entry><type>float</type></entry>
       <entry>
        <literal>e</literal>,
        <literal>E</literal>,
        <literal>f</literal>,
        <literal>F</literal>,
        <literal>g</literal>,
        <literal>G</literal>,
        <literal>h</literal>,
        <literal>H</literal>
       </entry>
      </row>
     </tbody>
    </tgroup>
   </table>
  </para>
 </listitem>
</varlistentry>
'>

<!ENTITY strings.scanf.parameter.format '
<varlistentry xmlns="http://docbook.org/ns/docbook">
     <term><parameter>format</parameter></term>
     <listitem>
      <para>
       Das interpretierte Format für <parameter>string</parameter>, wie es in
       der Dokumentation zu <function>sprintf</function> beschrieben ist, mit
       den folgenden Unterschieden:
       <simplelist>
        <member>
         Die Funktion beachtet die Locale nicht.
        </member>
        <member>
         <literal>F</literal>, <literal>g</literal>, <literal>G</literal> und
         <literal>b</literal> werden nicht unterstützt.
        </member>
        <member>
         <literal>D</literal> steht für eine Dezimalzahl.
        </member>
        <member>
         <literal>i</literal> steht für eine Ganzzahl mit Angabe der Basis.
        </member>
        <member>
         <literal>n</literal> steht für die Anzahl der bisher verarbeiteten Zeichen.
        </member>
        <member>
         <literal>s</literal> beendet das Lesen beim ersten Whitespace-Zeichen.
        </member>
        <member>
         <literal>*</literal> anstelle von <literal>argnum$</literal>
         unterdrückt die Zuweisung dieser Umwandlungsspezifikation.
        </member>
       </simplelist>
      </para>
     </listitem>
    </varlistentry>
'>

<!ENTITY strings.parameter.needle.non-string '
 <para xmlns="http://docbook.org/ns/docbook">
  Wenn der Parameter <parameter>needle</parameter> keine Zeichenkette ist,
  wird er vor PHP 8.0.0 in eine Ganzzahl umgewandelt und als ordinaler Wert
  eines Zeichens betrachtet. Dieses Verhalten gilt seit PHP 7.3.0 als veraltet
  und es wird dringend empfohlen, sich nicht darauf zu verlassen. Ist das
  Verhalten gewünscht, so sollte <parameter>needle</parameter> explizit in
  eine Zeichenkette umgewandelt werden oder explizit die Funktion
  <function>chr</function> aufgerufen werden.
 </para>
'>

<!ENTITY strings.changelog.needle-empty '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>needle</parameter> akzeptiert nun eine leere Zeichenkette.
 </entry>
</row>'>

<!ENTITY strings.changelog.encoding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>5.6.0</entry>
  <entry>
   Der Standardwert für den Parameter <parameter>encoding</parameter> wurde
   so angepasst, dass dieser Wert aus der Konfigurationseinstellung
   <link linkend="ini.default-charset">default_charset</link> bezogen wird.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-conversion '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   Die Umwandlung von Groß- und Kleinschreibung hängt nicht mehr von der mit
   <function>setlocale</function> eingestellten Locale ab. Es werden nur
   ASCII-Zeichen umgewandelt.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.ascii-case-folding '
 <row xmlns="http://docbook.org/ns/docbook">
  <entry>8.2.0</entry>
  <entry>
   Die Groß- und Kleinschreibung hängt nicht mehr von der mit
   <function>setlocale</function> eingestellten Locale ab. Es wird nur noch
   die Groß- und Kleinschreibung von ASCII-Bytes verglichen. Nicht-ASCII-Bytes
   werden nach ihrem Byte-Wert verglichen.
  </entry>
 </row>
'>

<!ENTITY strings.changelog.sprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Diese Funktion gibt bei Auftreten eines Fehlers nicht mehr &false;
       zurück.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn die Anzahl der Argumente Null ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen eine
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn <literal>[width]</literal> kleiner als Null oder größer als
       <constant>PHP_INT_MAX</constant> ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen einen
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn <literal>[precision]</literal> kleiner als Null oder größer als
       <constant>PHP_INT_MAX</constant> ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen eine
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn weniger Argumente angegeben werden als nötig, löst diese Funktion
       einen <classname>ArgumentCountError</classname> aus; vorher gab sie
       stattdessen eine <constant>E_WARNING</constant> aus.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.changelog.vsprintf '
  <informaltable xmlns="http://docbook.org/ns/docbook">
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Diese Funktion gibt bei Auftreten eines Fehlers nicht mehr &false;
       zurück.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn die Anzahl der Argumente Null ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen eine
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn <literal>[width]</literal> kleiner als Null oder größer als
       <constant>PHP_INT_MAX</constant> ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen eine
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn <literal>[precision]</literal> kleiner als Null oder größer als
       <constant>PHP_INT_MAX</constant> ist, löst diese Funktion einen
       <classname>ValueError</classname> aus; vorher gab sie stattdessen eine
       <constant>E_WARNING</constant> aus.
      </entry>
     </row>
     <row>
      <entry>8.0.0</entry>
      <entry>
       Wenn weniger Argumente angegeben werden als nötig, löst diese Funktion
       einen <classname>ValueError</classname> aus; vorher gab sie stattdessen
       eine <constant>E_WARNING</constant> aus.
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
'>

<!ENTITY strings.errors.sprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn die Anzahl der Argumente Null ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn <literal>[width]</literal> kleiner als Null oder größer als <constant>PHP_INT_MAX</constant> ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn <literal>[precision]</literal> kleiner als Null oder größer als <constant>PHP_INT_MAX</constant> ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn weniger Argumente angegeben werden als nötig, wird seit PHP 8.0.0 ein <classname>ArgumentCountError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen &false; zurückgegeben und eine <constant>E_WARNING</constant> ausgegeben.
  </para>
'>

<!ENTITY strings.errors.vsprintf '
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn die Anzahl der Argumente Null ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn <literal>[width]</literal> kleiner als Null oder größer als <constant>PHP_INT_MAX</constant> ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn <literal>[precision]</literal> kleiner als Null oder größer als <constant>PHP_INT_MAX</constant> ist, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen eine <constant>E_WARNING</constant> ausgegeben.
  </para>
  <para xmlns="http://docbook.org/ns/docbook">
   Wenn weniger Argumente angegeben werden als nötig, wird seit PHP 8.0.0 ein <classname>ValueError</classname> ausgelöst.
   Vor PHP 8.0.0 wurde stattdessen &false; zurückgegeben und eine <constant>E_WARNING</constant> ausgegeben.
  </para>
'>

<!-- filter snippets -->
<!ENTITY filter.param.filter '
 <varlistentry xmlns="http://docbook.org/ns/docbook">
  <term><parameter>filter</parameter></term>
  <listitem>
   <para>
    Die ID des anzuwendenden Filters. Die Handbuchseite
    <xref linkend="filter.filters" /> zeigt die verfügbaren Filter auf.
   </para>
   <para>
    Falls dieser Parameter ausgelassen wird, so wird
    <constant>FILTER_DEFAULT</constant> verwendet, was zu
    <link linkend="filter.filters.sanitize"><constant>FILTER_UNSAFE_RAW</constant></link>
    äquivalent ist. Dies wird dazu führen, dass keine Filterung stattfindet.
   </para>
  </listitem>
 </varlistentry>
'>

<!-- csprng snippets -->
<!ENTITY csprng.sources '
<para xmlns="http://docbook.org/ns/docbook">
 Die Zufallsquellen in der Reihenfolge ihrer Priorität sind folgende:
</para>
<itemizedlist xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <listitem>
  <para>
   Linux: <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   FreeBSD &gt;= 12 (PHP &gt;= 7.3): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Windows (PHP &gt;= 7.2): <link xlink:href="&url.csprng.cng-api;">CNG-API</link>
  </para>
  <para>
   Windows: <link xlink:href="&url.csprng.crypt-gen-random;">CryptGenRandom</link>
  </para>
 </listitem>
 <listitem>
  <para>
   macOS (PHP &gt;= 8.2; &gt;= 8.1.9; &gt;= 8.0.22 wenn CCRandomGenerateBytes bei der Kompilierung verfügbar ist): CCRandomGenerateBytes()
  </para>
  <para>
   macOS (PHP &gt;= 8.1; &gt;= 8.0.2): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   NetBSD &gt;= 7 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   OpenBSD &gt;= 5.5 (PHP &gt;= 7.1; &gt;= 7.0.1): arc4random_buf(), <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   DragonflyBSD (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <para>
   Solaris (PHP &gt;= 8.1): <link xlink:href="&url.csprng.get-random-2;">getrandom()</link>, <filename>/dev/urandom</filename>
  </para>
 </listitem>
 <listitem>
  <simpara>
   Jede beliebige Kombination von Betriebssystem und PHP-Version, die oben nicht erwähnt wurde: <filename>/dev/urandom</filename>
  </simpara>
 </listitem>
 <listitem>
  <simpara>
   Wenn keine der Quellen verfügbar ist oder keine davon Zufälligkeit erzeugen
   kann, wird eine <classname>Random\RandomException</classname> ausgelöst.
  </simpara>
 </listitem>
</itemizedlist>
'>
<!ENTITY csprng.errors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Wenn keine angemessene Quelle für Zufallszahlen verfügbar ist, wird eine
   <classname>Random\RandomException</classname> geworfen.
  </simpara>
 </listitem>
'>
<!ENTITY csprng.function.backport '
 <note xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Obwohl diese Funktion erst mit PHP 7.0.0 in PHP hinzugefügt wurde, gibt es
   <link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.csprng.compat;">Userland-Implementierungen</link>
   für PHP 5.2 bis einschließlich 5.6.
  </simpara>
 </note>
'>

<!-- Random snippets -->
<!ENTITY random.engineErrors '
 <listitem xmlns="http://docbook.org/ns/docbook">
  <simpara>
   Alle <classname>Throwable</classname>s, die von der Methode <methodname>Random\Engine::generate</methodname> der
   zugrundeliegenden <link linkend="random-randomizer.props.engine"><literal>Random\Randomizer::$engine</literal></link> ausgelöst werden.
  </simpara>
 </listitem>
'>

<!-- UOPZ snippets -->

<!ENTITY uopz.warn.removed.function-5-0-0 '<warning xmlns="http://docbook.org/ns/docbook">
 <simpara>
  Diese Funktion wurde mit PECL uopz 5.0.0 <emphasis>ENTFERNT</emphasis>.
 </simpara>
</warning>
'>

<!-- XML snippets -->
<!ENTITY xml.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <para>
   Der XML-Parser
  </para>
 </listitem>
</varlistentry>'>

<!ENTITY xml.handler.description '<para xmlns="http://docbook.org/ns/docbook">
 Wenn &null; oder eine leere Zeichenkette übergeben wird, wird der Handler auf
 seinen Standardzustand zurückgesetzt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Wenn <parameter>handler</parameter> vom Typ <type>callable</type> ist, wird
 das Callable als Handler gesetzt.
</para>
<para xmlns="http://docbook.org/ns/docbook">
 Wenn <parameter>handler</parameter> vom Typ <type>string</type> ist, kann es
 der Name der Methode eines Objekts sein, das mit
 <function>xml_set_object</function> gesetzt wurde.
</para>'>

<!ENTITY xml.handler.parser.param '<varlistentry xmlns="http://docbook.org/ns/docbook">
 <term><parameter>parser</parameter></term>
 <listitem>
  <simpara>
   Der XML-Parser, der den Handler aufruft.
  </simpara>
 </listitem>
</varlistentry>'>

<!ENTITY xml.changelog.parser-param '<row xmlns="http://docbook.org/ns/docbook">
 <entry>8.0.0</entry>
 <entry>
  <parameter>parser</parameter> erwartet nun eine
  <classname>XMLParser</classname>-Instanz; vorher wurde eine gültige
  <literal>xml</literal>-<type>Ressource</type> erwartet.
 </entry>
</row>'>

<!-- Migration Guide snippets -->
<!ENTITY migration56.openssl.peer-verification '
   <para xmlns="http://docbook.org/ns/docbook">
    Alle verschlüsselten Clientstreams verifizieren nun standardmäßig den
    Kommunikationspartner. Standardmäßig wird dafür das Standard-CA-Bundle
    von OpenSSL zur Verifikation des Peer-Zertifikates herangezogen. In
    den meisten Fällen sind keine Änderungen notwendig, um mit Servern
    mit gültigen SSL-Zertifikaten zu kommunizieren, da Distributoren
    üblicherweise OpenSSL mit vertrauenswürdigen CA-Bundles konfigurieren.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    Das Standard-CA-Bundle kann global durch eine Änderung der
    konfigurationseinstellungen openssl.cafile oder openssl.capath
    überschrieben werden, oder für einzelne Requests durch die
    Verwendung der Kontextoptionen
    <link linkend="context.ssl.cafile"><parameter>cafile</parameter></link> oder
    <link linkend="context.ssl.capath"><parameter>capath</parameter></link>.
   </para>

   <para xmlns="http://docbook.org/ns/docbook">
    Obwohl dies generell nicht empfehlenswert ist, kann die Verifikation
    der Peer-Zertifikate für einzelne Requests ausgeschaltet werden, indem
    die Kontextoption
    <link linkend="context.ssl.verify-peer"><parameter>verify_peer</parameter></link>
    auf &false; gesetzt wird. Die Verifikation des Peer-Namen kann durch
    das Setzen von
    <parameter>verify_peer_name</parameter>
    <link linkend="context.ssl.verify-peer-name"><parameter>verify_peer_name</parameter></link>
    auf &false; ausgeschaltet werden.
   </para>
'>

<!--
Aus der französischen Datei übernommen:
Die folgenden Entitäten sind in der englischen Datei nicht definiert.
-->

<!ENTITY php.version.added 'Steht zur Verfügung ab PHP '>
<!ENTITY php.version.in 'Steht zur Verfügung in PHP '>
<!ENTITY php.version.retired 'Steht zur Verfügung bis PHP '>

<!ENTITY imagick.imagickdraw.return.success 'Gibt bei Erfolg &true; zurück und
löst bei einem Fehler eine <classname>ImagickDrawException</classname> aus.'>
<!ENTITY imagick.imagickpixel.return.success 'Gibt bei Erfolg &true; zurück
und löst bei einem Fehler eine <classname>ImagickPixelException</classname>
aus.'>
<!ENTITY imagick.imagickpixeliterator.return.success 'Gibt bei Erfolg &true;
zurück und löst bei einem Fehler eine
<classname>ImagickPixelIteratorException</classname> aus.'>

<!-- Easy links -->

<!ENTITY nbsp '&#x000A0;'>
<!ENTITY zb 'z.&#x000A0;B.'>
<!ENTITY dh 'd.&#x000A0;h.'>
<!ENTITY array '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.array">Array</link>'>
<!ENTITY boolean '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.boolean">Boolean</link>'>
<!ENTITY float '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.float">Float</link>'>
<!ENTITY integer '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.integer">Integer</link>'>
<!ENTITY iterable '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.iterable">iterierbar</link>'>
<!ENTITY object '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.object">Objekt</link>'>
<!ENTITY resource '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.resource">Ressource</link>'>
<!ENTITY string '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.string">String</link>'>
<!ENTITY void '<link xmlns="http://docbook.org/ns/docbook" linkend="language.types.declarations.void">void</link>'>


<!ENTITY zero '<literal xmlns="http://docbook.org/ns/docbook">0</literal>'>
<!ENTITY one '<literal xmlns="http://docbook.org/ns/docbook">1</literal>'>

<!-- Widely used -->
<!ENTITY class.theclass 'Die Klasse'>

<!-- 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: fen fdm=syntax fdl=2 si
vim: et tw=78
vi: ts=1 sw=1
-->