svn: /phpdoc/de/trunk/ appendices/tokens.xml language/control-structures/declare.xml language/functions.xml language/oop5/interfaces.xml language/oop5/typehinting.xml language/oop5.xml reference/filesystem/functions/file-get-contents.xml reference/funchand/functions/func-get-arg.xml reference/funchand/functions/func-get-args.xml reference/funchand/functions/func-num-args.xml reference/soap/soapclient/construct.xml reference/soap/soapfault/construct.xml reference/soap/soapheader/construct.xml ref
[email protected] (Christoph Michael Becker)
| Newsgroups | php.doc.de |
|---|---|
| Message-ID | <[email protected]> |
cmb Tue, 29 Dec 2020 15:19:30 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=352272
Log:
Sync with EN
Changed paths:
U phpdoc/de/trunk/appendices/tokens.xml
U phpdoc/de/trunk/language/control-structures/declare.xml
U phpdoc/de/trunk/language/functions.xml
U phpdoc/de/trunk/language/oop5/interfaces.xml
D phpdoc/de/trunk/language/oop5/typehinting.xml
U phpdoc/de/trunk/language/oop5.xml
U phpdoc/de/trunk/reference/filesystem/functions/file-get-contents.xml
U phpdoc/de/trunk/reference/funchand/functions/func-get-arg.xml
U phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml
U phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml
U phpdoc/de/trunk/reference/soap/soapclient/construct.xml
U phpdoc/de/trunk/reference/soap/soapfault/construct.xml
U phpdoc/de/trunk/reference/soap/soapheader/construct.xml
U phpdoc/de/trunk/reference/soap/soapparam/construct.xml
U phpdoc/de/trunk/reference/soap/soapserver/construct.xml
U phpdoc/de/trunk/reference/soap/soapvar/construct.xml
svn-diffs-352272.txt
(text/x-diff, 59.2 KB)
Modified: phpdoc/de/trunk/appendices/tokens.xml
===================================================================
--- phpdoc/de/trunk/appendices/tokens.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/appendices/tokens.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 349702 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 351112 Maintainer: nobody Status: ready -->
<appendix xml:id="tokens" xmlns="http://docbook.org/ns/docbook">
<title>Liste der Parsertoken</title>
@@ -79,7 +79,7 @@
<entry></entry>
<entry>
Alle Zeichen unterhalb von ASCII 32 mit Ausnahme von \t (0x09), \n (0x0a) und \r (0x0d)
- (verfügbar seit PHP 7.4.0, und ebenfalls vor PHP 7.0.0, aber dort nicht verwendet)
+ (verfügbar seit PHP 7.4.0)
</entry>
</row>
<row>
@@ -105,7 +105,7 @@
<row>
<entry><constant>T_CALLABLE</constant></entry>
<entry>callable</entry>
- <entry><link linkend="language.types.callable">callable</link> (verfügbar seit PHP 5.4.0)</entry>
+ <entry><link linkend="language.types.callable">callable</link></entry>
</row>
<row>
<entry><constant>T_CASE</constant></entry>
@@ -118,11 +118,6 @@
<entry><xref linkend="language.exceptions"/></entry>
</row>
<row>
- <entry><constant>T_CHARACTER</constant></entry>
- <entry></entry>
- <entry>nicht mehr verwendet (entfernt in PHP 7.0.0)</entry>
- </row>
- <row>
<entry><constant>T_CLASS</constant></entry>
<entry>class</entry>
<entry><link linkend="language.oop5">Klassen und Objekte</link></entry>
@@ -151,7 +146,6 @@
<entry>??</entry>
<entry>
<link linkend="language.operators.comparison.coalesce">Vergleichsoperatoren</link>
- (verfügbar ab PHP 7.0.0)
</entry>
</row>
<row>
@@ -211,8 +205,7 @@
<row>
<entry><constant>T_DIR</constant></entry>
<entry>__DIR__</entry>
- <entry><link linkend="language.constants.predefined">Magische Konstanten</link>
- (verfügbar ab PHP 5.3.0)</entry>
+ <entry><link linkend="language.constants.predefined">Magische Konstanten</link></entry>
</row>
<row>
<entry><constant>T_DIV_EQUAL</constant></entry>
@@ -265,8 +258,7 @@
<entry><constant>T_ELLIPSIS</constant></entry>
<entry>...</entry>
<entry>
- <link linkend="functions.variable-arg-list.new">Funktionsargumente</link>
- (verfügbar ab PHP 5.6.0)
+ <link linkend="functions.variable-arg-list">Funktionsargumente</link>
</entry>
</row>
<row>
@@ -360,7 +352,7 @@
<row>
<entry><constant>T_FINALLY</constant></entry>
<entry>finally</entry>
- <entry><xref linkend="language.exceptions"/> (verfügbar ab PHP 5.5.0)</entry>
+ <entry><xref linkend="language.exceptions"/></entry>
</row>
<row>
<entry><constant>T_FN</constant></entry>
@@ -400,12 +392,12 @@
<row>
<entry><constant>T_GOTO</constant></entry>
<entry>goto</entry>
- <entry><link linkend="control-structures.goto">goto</link>(verfügbar ab PHP 5.3.0)</entry>
+ <entry><link linkend="control-structures.goto">goto</link></entry>
</row>
<row>
<entry><constant>T_HALT_COMPILER</constant></entry>
<entry>__halt_compiler()</entry>
- <entry><xref linkend="function.halt-compiler"/> (verfügbar ab PHP 5.1.0)</entry>
+ <entry><xref linkend="function.halt-compiler"/></entry>
</row>
<row>
<entry><constant>T_IF</constant></entry>
@@ -448,7 +440,7 @@
<row>
<entry><constant>T_INSTEADOF</constant></entry>
<entry>insteadof</entry>
- <entry><xref linkend="language.oop5.traits"/> (verfügbar ab PHP 5.4.0)</entry>
+ <entry><xref linkend="language.oop5.traits"/></entry>
</row>
<row>
<entry><constant>T_INTERFACE</constant></entry>
@@ -551,8 +543,7 @@
<entry><constant>T_NAMESPACE</constant></entry>
<entry>namespace</entry>
<entry>
- <link linkend="language.namespaces">Namensräume</link> (verfügbar ab PHP
- 5.3.0)
+ <link linkend="language.namespaces">Namensräume</link>
</entry>
</row>
<row>
@@ -572,7 +563,6 @@
<entry>\</entry>
<entry>
<link linkend="language.namespaces">Namensräume</link>
- (verfügbar ab PHP 5.3.0)
</entry>
</row>
<row>
@@ -622,7 +612,6 @@
<entry>**</entry>
<entry>
<link linkend="language.operators.arithmetic">Arithmetische Operatoren</link>
- (verfügbar ab PHP 5.6.0)
</entry>
</row>
<row>
@@ -630,7 +619,6 @@
<entry>**=</entry>
<entry>
<link linkend="language.operators.assignment">Zuweisungsoperatoren</link>
- (verfügbar ab PHP 5.6.0)
</entry>
</row>
<row>
@@ -689,7 +677,6 @@
<entry><=></entry>
<entry>
<link linkend="language.operators.comparison">Vergleichsoperatoren</link>
- (verfügbar ab PHP 7.0.0)
</entry>
</row>
<row>
@@ -745,12 +732,12 @@
<row>
<entry><constant>T_TRAIT</constant></entry>
<entry>trait</entry>
- <entry><xref linkend="language.oop5.traits"/> (verfügbar ab PHP 5.4.0)</entry>
+ <entry><xref linkend="language.oop5.traits"/></entry>
</row>
<row>
<entry><constant>T_TRAIT_C</constant></entry>
<entry>__TRAIT__</entry>
- <entry><link linkend="constant.trait">__TRAIT__</link> (verfügbar ab PHP 5.4.0)</entry>
+ <entry><link linkend="constant.trait">__TRAIT__</link></entry>
</row>
<row>
<entry><constant>T_TRY</constant></entry>
@@ -770,8 +757,7 @@
<row>
<entry><constant>T_USE</constant></entry>
<entry>use</entry>
- <entry><link linkend="language.namespaces">Namensräume</link>
- (verfügbar ab PHP 5.3.0)</entry>
+ <entry><link linkend="language.namespaces">Namensräume</link></entry>
</row>
<row>
<entry><constant>T_VAR</constant></entry>
@@ -802,12 +788,12 @@
<row>
<entry><constant>T_YIELD</constant></entry>
<entry>yield</entry>
- <entry><link linkend="control-structures.yield">Generatoren</link> (verfügbar ab PHP 5.5.0)</entry>
+ <entry><link linkend="control-structures.yield">Generatoren</link></entry>
</row>
<row>
<entry><constant>T_YIELD_FROM</constant></entry>
<entry>yield from</entry>
- <entry><link linkend="control-structures.yield.from">Generator</link> (verfügbar ab PHP 7.0.0)</entry>
+ <entry><link linkend="control-structures.yield.from">Generator</link></entry>
</row>
</tbody>
</tgroup>
Modified: phpdoc/de/trunk/language/control-structures/declare.xml
===================================================================
--- phpdoc/de/trunk/language/control-structures/declare.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/language/control-structures/declare.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347260 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: sammywg Status: ready -->
<sect1 xml:id="control-structures.declare" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title><literal>declare</literal></title>
@@ -29,39 +29,10 @@
Informationen über die <link
linkend="control-structures.declare.encoding">encoding</link>-Direktive),
und die <literal>strict_types</literal>-Direktive (siehe den Abschnitt über
- <link linkend="functions.arguments.type-declaration.strict">strict</link>
+ <link linkend="language.types.declarations.strict">strict</link>
auf der Seite über Funktionsargumente).
</para>
<para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>7.0.0</entry>
- <entry>Die <literal>strict_types</literal>-Direktive hinzugefügt</entry>
- </row>
- <row>
- <entry>7.0.0</entry>
- <entry>
- Die <literal>ticks</literal>-Direktive wirkt sich nicht mehr versehentlich
- auf andere Kompilationseinheiten aus.
- </entry>
- </row>
- <row>
- <entry>5.3.0</entry>
- <entry>Die <literal>encoding</literal>-Direktive hinzugefügt</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- <para>
Da Direktiven behandelt werden, wenn die Datei kompiliert wird, dürfen nur
Literale als Direktiven-Werte angegeben werden. Variable und Konstante können
nicht verwendet werden. Zur Veranschaulichung:
@@ -224,16 +195,8 @@
</simpara>
</caution>
<para>
- Der encodete declare-Wert wird in PHP 5.3 ignoriert, sofern PHP nicht mit
- <literal>--enable-zend-multibyte</literal> kompiliert wurde.
+ Siehe auch <link linkend="ini.zend.script-encoding">zend.script_encoding</link>.
</para>
- <para>
- PHP bietet abgesehen von <function>phpinfo</function> keine Möglichkeit zur Laufzeit
- herauszufinden, ob es mit <literal>--enable-zend-multibyte</literal> kompiliert wurde.
- </para>
- <para>
- See also <link linkend="ini.zend.script-encoding">zend.script_encoding</link>.
- </para>
</sect2>
</sect1>
Modified: phpdoc/de/trunk/language/functions.xml
===================================================================
--- phpdoc/de/trunk/language/functions.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/language/functions.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,7 +1,8 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 350788 Maintainer: cmb Status: in progress -->
+<!-- EN-Revision: 351885 Maintainer: cmb Status: in progress -->
<!-- Credits: hholzgra, tom, updated to fix build by theseer -->
+<!-- r351733 and r351885 have not been translated -->
<chapter xml:id="language.functions" xmlns="http://docbook.org/ns/docbook">
<title>Funktionen</title>
@@ -213,7 +214,53 @@
</programlisting>
</example>
</para>
+ <para>
+ As of PHP 8.0.0, the list of function arguments may include a trailing comma, which
+ will be ignored. That is particularly useful in cases where the list of arguments is
+ long or contains long variable names, making it convenient to list arguments vertically.
+ </para>
+ <example>
+ <title>Function Argument List with trailing Comma</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function takes_many_args(
+ $first_arg,
+ $second_arg,
+ $a_very_long_argument_name,
+ $arg_with_default = 5,
+ $again = 'a default string', // This trailing comma was not permitted before 8.0.0.
+)
+{
+ // ...
+}
+?>
+]]>
+ </programlisting>
+ </example>
+ <para>
+ As of PHP 8.0.0, passing optional arguments after mandatory arguments
+ is deprecated. This can generally be resolved by dropping the default value.
+ One exception to this rule are arguments of the form
+ <code>Type $param = null</code>, where the &null; default makes the type implicitly
+ nullable. This usage remains allowed, though it is recommended to use an
+ explicit nullable type instead.
+ </para>
+ <example>
+ <title>Passing optional arguments after mandatory arguments</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+function foo($a = [], $b) {} // Before
+function foo($a, $b) {} // After
+function bar(A $a = null, $b) {} // Still allowed
+function bar(?A $a, $b) {} // Recommended
+?>
+]]>
+ </programlisting>
+ </example>
+
<sect2 xml:id="functions.arguments.by-reference">
<title>Parameter als Verweise übergeben</title>
@@ -379,433 +426,32 @@
<note>
<simpara>
Das Setzen von Standardwerten für Argumente, die als Referenz
- übergeben werden ("passed by reference") wird seit PHP 5
+ übergeben werden ("passed by reference") wird
unterstützt.
</simpara>
</note>
</sect2>
-
- <sect2 xml:id="functions.arguments.type-declaration">
- <title>Typdeklarationen</title>
- <note>
- <para>
- Typdeklarationen waren unter PHP 5 ebenfalls unter dem Namen Type-Hints bekannt.
- </para>
- </note>
-
- <para>
- Typdeklarationen erlauben es, dass Funktionsparameter zur Aufrufzeit von einem bestimmten Typ sind.
- Ist der gegebene Wert von einem falschen Typ,
- dann wird ein Fehler generiert: in PHP 5 ist es ein recoverable fatal error,
- während PHP 7 eine <classname>TypeError</classname>-Exception auslöst.
- </para>
-
- <para>
- Um eine Typdeklaration zu spezifizieren, sollte der Typname vor dem Parameternamen hinzugefügt werden.
- Wird der Vorgabewert des Parameters als &null; definiert, akzeptiert die Funktion die Übergabe von &null;.
- </para>
-
- <sect3 xml:id="functions.arguments.type-declaration.types">
- <title>Gültige Typen</title>
- <informaltable>
- <tgroup cols="3">
- <thead>
- <row>
- <entry>Typ</entry>
- <entry>Beschreibung</entry>
- <entry>Minimale PHP-Version</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>Klassen/Interface-Name</entry>
- <entry>
- Der Parameter muss ein Exemplar (&instanceof;) der gegebenen Klasse oder des Interface sein.
- </entry>
- <entry>PHP 5.0.0</entry>
- </row>
- <row>
- <entry><literal>self</literal></entry>
- <entry>
- Der Parameter muss ein Exemplar (&instanceof;) der selben Klasse sein für die die
- Methode definiert ist. Dies kann nur für Klassen- und Objektmethoden
- verwendet werden.
- </entry>
- <entry>PHP 5.0.0</entry>
- </row>
- <row>
- <entry><type>array</type></entry>
- <entry>
- Der Parameter muss ein <type>Array</type> sein.
- </entry>
- <entry>PHP 5.1.0</entry>
- </row>
- <row>
- <entry><type>callable</type></entry>
- <entry>
- Der Parameter muss ein gültiges <type>Callable</type> sein.
- </entry>
- <entry>PHP 5.4.0</entry>
- </row>
- <row>
- <entry><type>bool</type></entry>
- <entry>
- Der Parameter muss ein Boolescher Wert (<type>boolean</type>) sein.
- </entry>
- <entry>PHP 7.0.0</entry>
- </row>
- <row>
- <entry><type>float</type></entry>
- <entry>
- Der Parameter muss eine Gleitkommazahl (<type>float</type>) sein.
- </entry>
- <entry>PHP 7.0.0</entry>
- </row>
- <row>
- <entry><type>int</type></entry>
- <entry>
- Der Parameter muss eine Ganzzahl (<type>integer</type>) sein.
- </entry>
- <entry>PHP 7.0.0</entry>
- </row>
- <row>
- <entry><type>string</type></entry>
- <entry>
- Der Parameter muss ein <type>String</type> sein.
- </entry>
- <entry>PHP 7.0.0</entry>
- </row>
- <row>
- <entry><literal>iterable</literal></entry>
- <entry>
- Der Parameter muss entweder ein <type>Array</type> oder ein
- &instanceof; <classname>Traversable</classname> sein.
- </entry>
- <entry>PHP 7.1.0</entry>
- </row>
- <row>
- <entry><literal>object</literal></entry>
- <entry>
- Der Parameter muss ein <type>Object</type> sein.
- </entry>
- <entry>PHP 7.2.0</entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- <warning>
- <para>
- Aliase der oben genannten skalaren Typen werden nicht unterstützt.
- Statt dessen werden sie als Klassen- oder Schnittstellennamen angesehen.
- Zum Beispiel erfordert die Verwendung von <literal>boolean</literal>
- als Parameter oder Rückgabetyp ein Argument oder einen Rückgabewert, der
- ein Exemplar (&instanceof;) der Klasse oder Schnittstelle <literal>boolean</literal>
- ist, anstatt vom Typ <type>bool</type>:
- </para>
- <para>
- <example>
- <programlisting role="php">
- <![CDATA[
- <?php
- function test(boolean $param) {}
- test(true);
- ?>
- ]]>
- </programlisting>
- &example.outputs;
- <screen>
- <![CDATA[
- Fatal error: Uncaught TypeError: Argument 1 passed to test() must be an instance of boolean, boolean given, called in - on line 1 and defined in -:1
- ]]>
- </screen>
- </example>
- </para>
- </warning>
- </sect3>
-
- <sect3 xml:id="functions.arguments.type-declaration.examples">
- &reftitle.examples;
- <example>
- <title>Grundlegende Klassen-Typdeklaration</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-class C {}
-class D extends C {}
-
-// Dies erweitert C nicht.
-class E {}
-
-function f(C $c) {
- echo get_class($c)."\n";
-}
-
-f(new C);
-f(new D);
-f(new E);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-C
-D
-
-Fatal error: Uncaught TypeError: Argument 1 passed to f() must be an instance of C, instance of E given, called in - on line 14 and defined in -:8
-Stack trace:
-#0 -(14): f(Object(E))
-#1 {main}
- thrown in - on line 8
-]]>
- </screen>
- </example>
-
- <example>
- <title>Grundlegende Interface-Typdeklaration</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-interface I { public function f(); }
-class C implements I { public function f() {} }
-
-// Dies implementiert I nicht.
-class E {}
-
-function f(I $i) {
- echo get_class($i)."\n";
-}
-
-f(new C);
-f(new E);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-C
-
-Fatal error: Uncaught TypeError: Argument 1 passed to f() must implement interface I, instance of E given, called in - on line 13 and defined in -:8
-Stack trace:
-#0 -(13): f(Object(E))
-#1 {main}
- thrown in - on line 8
-]]>
- </screen>
- </example>
-
- <example>
- <title>Typisierte Referenzparameter</title>
- <simpara>
- Deklarierte Typen von Referenzparametern werden nur beim Betreten der Funktion
- geprüft, nicht aber beim Verlassen derselben, so dass sich der Typ des Arguments
- nach dem Verlassen geändert haben kann.
- </simpara>
- <programlisting role="php">
-<![CDATA[
-<?php
-function array_baz(array &$param)
-{
- $param = 1;
-}
-$var = [];
-array_baz($var);
-var_dump($var);
-array_baz($var);
-?>
-]]>
- </programlisting>
- &example.outputs.similar;
- <screen>
-<![CDATA[
-int(1)
-
-Fatal error: Uncaught TypeError: Argument 1 passed to array_baz() must be of the type array, int given, called in %s on line %d
-]]>
- </screen>
- </example>
- <example>
- <title>Nullable Typdeklaration</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-class C {}
-
-function f(C $c = null) {
- var_dump($c);
-}
-
-f(new C);
-f(null);
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-object(C)#1 (0) {
-}
-NULL
-]]>
- </screen>
- </example>
- </sect3>
-
- <sect3 xml:id="functions.arguments.type-declaration.strict">
- <title>Strenge Typisierung</title>
-
- <para>
- Standardmäßig erzwingt PHP die Umwandlung von Werten des falschen Typs in den erwarteten
- skalaren Typ, falls möglich. Zum Beispiel erhält eine Funktion, der ein <type>Integer</type>
- für einen Parameter, der einen <type>String</type> erwartet, übergeben wurde, eine Variable
- vom Typ <type>String</type>.
- </para>
-
- <para>
- Es ist möglich die strenge Typisierung für einzelne Dateien zu aktivieren. Im strengen
- Typisierungsmodus werden nur Variablen von genau dem Typ der Typdeklaration akzeptiert,
- oder ein <classname>TypeError</classname> wird ausgelöst. Die einzige Ausnahme dieser
- Regel ist, dass ein <type>Integer</type> an eine Funktion, die ein <type>Float</type>
- erwartet, übergeben werden darf. Funktionsaufrufe innerhalb von internen Funktionen sind
- nicht von der <literal>strict_types</literal>-Deklaration betroffen.
- </para>
-
- <para>
- Um die strenge Typisierung zu aktivieren, wird die &declare;-Anweisung mit der
- <literal>strict_types</literal>-Deklaration verwendet:
- </para>
-
- <caution>
- <para>
- Das Aktivieren der strengen Typisierung betrifft ebenfalls
- <link linkend="functions.returning-values.type-declaration">Rückgabe-Typdeklarationen</link>.
- </para>
- </caution>
-
- <note>
- <para>
- Strenge Typisierung gilt für Funktionsaufrufe, die <emphasis>innerhalb</emphasis> einer
- Datei im strengen Typisierungsmodus durchgeführt werden, nicht für Funktionen, die
- innerhalb dieser Datei deklariert wurden. Ruft eine Datei, für die strenge Typisierung
- nicht aktiviert ist, eine Funktion, die in einer Datei im strengen Typisierungsmodus
- definiert wurde, auf, wird die Präferenz des Aufrufers (schwache Typisierung) beachtet,
- und die Konvertierung des Werts wird erzwungen.
- </para>
- </note>
-
- <note>
- <para>
- Strenge Typisierung ist nur für skalare Typdeklarationen gültig, und erfodert folglich
- PHP 7.0.0 oder höher, da skalare Typdeklarationen erst in dieser Version hinzugefügt
- wurden.
- </para>
- </note>
-
- <example>
- <title>Strenge Typisierung</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-declare(strict_types=1);
-
-function sum(int $a, int $b) {
- return $a + $b;
-}
-
-var_dump(sum(1, 2));
-var_dump(sum(1.5, 2.5));
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-int(3)
-
-Fatal error: Uncaught TypeError: Argument 1 passed to sum() must be of the type integer, float given, called in - on line 9 and defined in -:4
-Stack trace:
-#0 -(9): sum(1.5, 2.5)
-#1 {main}
- thrown in - on line 4
-]]>
- </screen>
- </example>
-
- <example>
- <title>Schwache Typisierung</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-function sum(int $a, int $b) {
- return $a + $b;
-}
-
-var_dump(sum(1, 2));
-
-// Die Konvertierung nach Integer wird erzwungen: beachten Sie die Ausgabe weiter unten!
-var_dump(sum(1.5, 2.5));
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-int(3)
-int(3)
-]]>
- </screen>
- </example>
-
- <example>
- <title>Abfangen von <classname>TypeError</classname></title>
- <programlisting role="php">
-<![CDATA[
-<?php
-declare(strict_types=1);
-
-function sum(int $a, int $b) {
- return $a + $b;
-}
-
-try {
- var_dump(sum(1, 2));
- var_dump(sum(1.5, 2.5));
-} catch (TypeError $e) {
- echo 'Fehler: '.$e->getMessage();
-}
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-int(3)
-Fehler: Argument 1 passed to sum() must be of the type integer, float given, called in - on line 10
-]]>
- </screen>
- </example>
- </sect3>
- </sect2>
-
<sect2 xml:id="functions.variable-arg-list">
<title>Variable Anzahl von Parametern</title>
<simpara>
PHP unterstützt eine variable Anzahl an Parametern für benutzerdefinierte
- Funktionen. Dies wird seit PHP 5.6 durch das Token <literal>...</literal>
- umgesetzt. Für ältere Versionen von PHP stehen die Funktionen
- <function>func_num_args</function>, <function>func_get_arg</function>, und
- <function>func_get_args</function> bereit.
+ Funktionen durch Verwendung des Token <literal>...</literal>.
</simpara>
+ <note>
+ <simpara>
+ Es ist ebenfalls möglich eine variable Anzahl an Parametern durch Verwendung von
+ <function>func_num_args</function>, <function>func_get_arg</function>, und
+ <function>func_get_args</function> zu realisieren.
+ Diese Technik wird nicht empfohlen, da sie vor der Einführung des <literal>...</literal>
+ Tokens verwendet wurde.
+ </simpara>
+ </note>
- <sect3 xml:id="functions.variable-arg-list.new">
- <title><literal>...</literal> in PHP 5.6+</title>
-
<para>
- Ab PHP 5.6 kann eine Liste von Parametern das Token <literal>...</literal>
+ Eine Liste von Parametern kann das Token <literal>...</literal>
enthalten, um anzugeben, dass die Funktion eine variable Anzahl von
Parametern akzeptiert. Die zusätzlichen Werte werden als Array an die entsprechende Variable übergeben.
Zum Beispiel:
@@ -875,12 +521,12 @@
<para>
Es ist zudem ebenfalls möglich dem <literal>...</literal> Token eine
- <link linkend="language.oop5.typehinting">Typangabe</link> voran zu
+ <link linkend="language.types.declarations">Typdeklaration</link> voran zu
stellen. Ist dies der Fall, müssen alle Werte, die für <literal>...</literal>
relevant sind, vom entsprechenden Typ sein.
<example>
- <title>Variable Parameter mit Vorgabe des Typs</title>
+ <title>Variable Parameter mit Typdeklaration</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -916,7 +562,6 @@
<link linkend="functions.arguments.by-reference">als Referenz</link>
möglich.
</para>
- </sect3>
<sect3 xml:id="functions.variable-arg-list.old">
<title>Ältere Versionen von PHP</title>
@@ -930,11 +575,11 @@
</para>
<para>
- Das erste Beispiel von weiter oben würde in PHP 5.5 und davor so
+ Das erste Beispiel von weiter oben würde in alten PHP-Versionen so
umgesetzt werden können:
<example>
- <title>Zugriff auf variable Parameter in PHP 5.5 und davor</title>
+ <title>Zugriff auf variable Parameter in alten PHP-Versionen</title>
<programlisting role="php">
<![CDATA[
<?php
@@ -962,6 +607,111 @@
</sect2>
+ <sect2 xml:id="functions.named-arguments">
+ <title>Named Arguments</title>
+
+ <para>
+ PHP 8.0.0 introduced named arguments as an extension of the existing
+ positional parameters. Named arguments allow passing arguments to a
+ function based on the parameter name, rather than the parameter position.
+ This makes the meaning of the argument self-documenting, makes the
+ arguments order-independent and allows skipping default values arbitrarily.
+ </para>
+
+ <para>
+ Named arguments are passed by prefixing the value with the parameter name
+ followed by a colon. Using reserved keywords as parameter names is allowed.
+ The parameter name must be an identifier, specifying dynamically
+ is not allowed.
+ </para>
+
+ <example>
+ <title>Named argument syntax</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+myFunction(paramName: $value);
+array_foobar(array: $value);
+
+// NOT supported.
+function_name($variableStoringParamName: $value);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <example>
+ <title>Positional arguments versus named arguments</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+// Using positional arguments:
+array_fill(0, 100, 50);
+
+// Using named arguments:
+array_fill(start_index: 0, num: 100, value: 50);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ The order in which the named arguments are passed does not matter.
+ </para>
+
+ <example>
+ <title>Same example as above with a different order of parameters</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+array_fill(value: 50, num: 100, start_index: 0);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ Named arguments can be combined with positional arguments. In this case,
+ the named arguments must come after the positional arguments.
+ It is also possible to specify only some of the optional arguments of a
+ function, regardless of their order.
+ </para>
+
+ <example>
+ <title>Combining named arguments with positional arguments</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+htmlspecialchars($string, double_encode: false);
+// Same as
+htmlspecialchars($string, ENT_COMPAT | ENT_HTML401, 'UTF-8', false);
+?>
+]]>
+ </programlisting>
+ </example>
+
+ <para>
+ Passing the same parameter multiple times results in an Error exception.
+ </para>
+
+ <example>
+ <title>Error exception when passing the same parameter multiple times</title>
+ <programlisting role="php">
+ <![CDATA[
+<?php
+function foo($param) { ... }
+
+foo(param: 1, param: 2);
+// Error: Named parameter $param overwrites previous argument
+foo(1, param: 2);
+// Error: Named parameter $param overwrites previous argument
+?>
+]]>
+ </programlisting>
+ </example>
+
+ </sect2>
+
</sect1>
<sect1 xml:id="functions.returning-values">
@@ -1052,147 +802,6 @@
<link linkend="language.references">Referenzen in PHP</link>.
</simpara>
</sect2>
-
- <sect2 xml:id="functions.returning-values.type-declaration">
- <title>Rückgabe-Typdeklarationen</title>
-
- <para>
- PHP 7 führt die Unterstützung von Rückgabe-Typdeklarationen ein. Ähnlich wie
- <link linkend="functions.arguments.type-declaration">Parameter-Typdeklarationen</link>
- geben Rückgabe-Typdeklarationen den Typ des Wertes, der von einer Funktion zurückgegeben
- wird, an. Die gleichen <link linkend="functions.arguments.type-declaration.types">Typen</link>,
- die für Parameter-Typdeklarationen verfügbar sind, sind auch für Rückgabe-Typdeklarationen
- erlaubt.
- </para>
-
- <para>
- <link linkend="functions.arguments.type-declaration.strict">Strenge Typsierung</link>
- hat ebenfalls Auswirkungen auf Rückgabe-Typdeklarationen. Im normalen schwachen Typisierungsmodus werden zurückgegebene Werte in den korrekten Typ konvertiert, wenn sie
- nicht bereits diesen Typ haben.
- Ist diese Typkonvertierung nicht erlaubt (z.B. wenn ein &array; von einer Funktion mit dem Rückgabetype &integer; geliefert wird),
- wird ein <classname>TypeError</classname> ausgelöst.
- Im strengen Modus muss der zurückgegebene Wert den
- korrekten Typ haben; andernfalls wird ein <classname>TypeError</classname> ausgelöst.
- </para>
-
- <para>
- Von PHP 7.1.0 an erzeugen return Anweisungen ohne Argument einen <constant>E_COMPILE_ERROR</constant>,
- es sei denn der Rückgabetype ist <type>void</type>, in welchem Fall return Anweisungen
- mit einem Argument diesen Fehler erzeugen.
- </para>
-
- <para>
- Von PHP 7.1.0 an können Rückgabetypen als nullbar ausgezeichnet werden, indem
- dem Typnamen ein Fragezeichen (<literal>?</literal>) vorangestellt wird.
- Dies zeigt an, dass die Funktion entweder den angegeben Typ oder &null;
- zurückliefert.
- </para>
-
- <note>
- <para>
- Wird eine Elternmethode überschrieben, muss die Rückgabe-Typdeklaration der Kindmethode
- mit der Elternmethode übereinstimmen. Definiert die Elternmethode keinen Rückgabetyp,
- dann darf die Kindmethode das tun.
- </para>
- </note>
-
- <sect3 xml:id="functions.returning-values.type-declaration.examples">
- &reftitle.examples;
-
- <example>
- <title>Grundlegende Rückgabe-Typdeklaration</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-function sum($a, $b): float {
- return $a + $b;
-}
-
-// Beachten Sie, dass eine Gleitkommazahl zurückgegeben wird.
-var_dump(sum(1, 2));
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-float(3)
-]]>
- </screen>
- </example>
-
- <example>
- <title>Einsatz des strengen Typisierungsmodus</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-declare(strict_types=1);
-
-function sum($a, $b): int {
- return $a + $b;
-}
-
-var_dump(sum(1, 2));
-var_dump(sum(1, 2.5));
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-int(3)
-
-Fatal error: Uncaught TypeError: Return value of sum() must be of the type integer, float returned in - on line 5 in -:5
-Stack trace:
-#0 -(9): sum(1, 2.5)
-#1 {main}
- thrown in - on line 5
-]]>
- </screen>
- </example>
-
- <example>
- <title>Rückgabe eines Objekts</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-class C {}
-
-function getC(): C {
- return new C;
-}
-
-var_dump(getC());
-?>
-]]>
- </programlisting>
- &example.outputs;
- <screen>
-<![CDATA[
-object(C)#1 (0) {
-}
-]]>
- </screen>
- </example>
-
- <example>
- <title>Nullbare Rückgabe-Typdeklaration (von PHP 7.1.0 an)</title>
- <programlisting role="php">
-<![CDATA[
-<?php
-function get_item(): ?string {
- if (isset($_GET['item'])) {
- return $_GET['item'];
- } else {
- return null;
- }
-}
-?>
-]]>
- </programlisting>
- </example>
- </sect3>
- </sect2>
</sect1>
<sect1 xml:id="functions.variable-functions">
@@ -1306,8 +915,6 @@
</example>
</para>
<para>
- Ab PHP 5.4.0 können beliebige <type>Callables</type>s, die in einer Variable
- gespeichert sind, aufgerufen werden.
<example>
<title>Komplexe Callables</title>
<programlisting role="php">
@@ -1330,47 +937,22 @@
$func = array(new Foo, "baz");
$func(); // gibt "baz" aus
$func = "Foo::bar";
-$func(); // gibt ab PHP 7.0.0 "bar" aus; vorher wurde ein fataler Fehler ausgelöst
+$func(); // gibt "bar" aus
?>
]]>
</programlisting>
</example>
</para>
-
- <para>
- Siehe auch <function>is_callable</function>,
- <function>call_user_func</function>,
- <link linkend="language.variables.variable">Variable Variablen</link> und
- <function>function_exists</function>.
- </para>
-
- <sect2 role="changelog">
- &reftitle.changelog;
+
+ <sect2 role="seealso">
+ &reftitle.seealso;
<para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>7.0.0</entry>
- <entry>
- 'Klassenname::Methodenname' ist als Variablenfunktion erlaubt.
- </entry>
- </row>
- <row>
- <entry>5.4.0</entry>
- <entry>
- Array, die gültige Callables sind, sind als Variablenfunktion erlaubt.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
+ <simplelist>
+ <member><function>is_callable</function></member>
+ <member><function>call_user_func</function></member>
+ <member><function>function_exists</function></member>
+ <member><link linkend="language.variables.variable">Variable Variablen</link></member>
+ </simplelist>
</para>
</sect2>
</sect1>
@@ -1425,12 +1007,18 @@
Konvention, auf die Sie sich nicht unbedingt verlassen können.
</simpara>
</note>
- <para>
- Siehe auch <function>function_exists</function>,
- <link linkend="funcref">die Funktionsreferenz</link>,
- <function>get_extension_funcs</function> und
- <function>dl</function>.
- </para>
+
+ <sect2 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>function_exists</function></member>
+ <member><link linkend="funcref">die Funktionsreferenz</link></member>
+ <member><function>get_extension_funcs</function></member>
+ <member><function>dl</function></member>
+ </simplelist>
+ </para>
+ </sect2>
</sect1>
<sect1 xml:id="functions.anonymous">
@@ -1552,6 +1140,10 @@
</screen>
</example>
+ <para>
+ As of PHP 8.0.0, the list of scope-inherited variables may include a trailing
+ comma, which will be ignored.
+ </para>
<simpara>
Das Erben von Variablen aus dem Eltern-Gültigkeitsbereich ist <emphasis>nicht</emphasis>
das gleiche wie die Verwendung von globalen Variablen.
@@ -1644,17 +1236,10 @@
?>
]]>
</programlisting>
- &example.outputs.53;
- <screen>
-<![CDATA[
-Notice: Undefined variable: this in script.php on line 8
-NULL
-]]>
- </screen>
</example>
<para>
- Wird ab PHP 5.4.0 eine anonyme Funktion im Kontext einer Klasse deklariert, so wird diese
+ Wird eine anonyme Funktion im Kontext einer Klasse deklariert, so wird diese
Klasse automatisch an jene gebunden, was <literal>$this</literal> innerhalb des
Geltungbereichs verfügbar macht. Ist diese automatische Bindung der aktuellen
Klasse nicht erwünscht, dann können statt dessen <link
@@ -1665,7 +1250,7 @@
<sect2 xml:id="functions.anonymous-functions.static">
<title>Statische anonyme Funktionen</title>
<para>
- Ab PHP 5.4 können anonyme Funktionen statisch deklariert werden. Dies verhindert,
+ Anonyme Funktionen können statisch deklariert werden. Dies verhindert,
dass automatisch die aktuelle Klasse an sie gebunden wird. Objekte können zur Laufzeit
ebenfalls nicht an sie gebunden werden.
</para>
@@ -1747,19 +1332,6 @@
Variablen verwenden.
</entry>
</row>
- <row>
- <entry>5.4.0</entry>
- <entry>
- Anonyme Funktionen können sowohl <varname>$this</varname> verwenden
- als auch statisch deklariert werden.
- </entry>
- </row>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Anonyme Funktionen wurde eingeführt.
- </entry>
- </row>
</tbody>
</tgroup>
</informaltable>
Modified: phpdoc/de/trunk/language/oop5/interfaces.xml
===================================================================
--- phpdoc/de/trunk/language/oop5/interfaces.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/language/oop5/interfaces.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 348385 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: hholzgra Status: ready -->
<sect1 xml:id="language.oop5.interfaces" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Interfaces</title>
<para>
@@ -226,7 +226,7 @@
um sicherzustellen, dass ein bestimmtes Objekt bestimmte Methoden enthält.
Siehe
<link linkend="language.operators.type">instanceof</link>-Operator und
- <link linkend="language.oop5.typehinting">Type Hinting</link>.
+ <link linkend="language.types.declarations">Typdeklarationen</link>.
</para>
</sect2>
Deleted: phpdoc/de/trunk/language/oop5/typehinting.xml
===================================================================
--- phpdoc/de/trunk/language/oop5/typehinting.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/language/oop5/typehinting.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,32 +0,0 @@
-<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: 337365 Maintainer: cmb Status: ready -->
-<sect1 xml:id="language.oop5.typehinting" xmlns="http://docbook.org/ns/docbook">
- <title>Type-Hints</title>
-
- <para>
- Diese Dokumentation wurde in die <link
- linkend="functions.arguments.type-declaration">Funktionsreferenz</link> verschoben.
- </para>
-</sect1>
-
-<!-- Keep this comment at the end of the file
-Local variables:
-mode: sgml
-sgml-omittag:t
-sgml-shorttag:t
-sgml-minimize-attributes:nil
-sgml-always-quote-attributes:t
-sgml-indent-step:1
-sgml-indent-data:t
-indent-tabs-mode:nil
-sgml-parent-document:nil
-sgml-default-dtd-file:"~/.phpdoc/manual.ced"
-sgml-exposed-tags:nil
-sgml-local-catalogs:nil
-sgml-local-ecat-files:nil
-End:
-vim600: syn=xml fen fdm=syntax fdl=2 si
-vim: et tw=78 syn=sgml
-vi: ts=1 sw=1
--->
Modified: phpdoc/de/trunk/language/oop5.xml
===================================================================
--- phpdoc/de/trunk/language/oop5.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/language/oop5.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 348547 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: simp Status: ready -->
<!-- Credits: sammywg -->
<chapter xml:id="language.oop5" xmlns="http://docbook.org/ns/docbook">
@@ -9,7 +9,7 @@
<sect1 xml:id="oop5.intro">
<title>Einführung</title>
<para>
- Von PHP 5 an hat PHP ein vollständiges Objektmodell.
+ PHP hat ein vollständiges Objektmodell.
</para>
<para>
Unter den Features finden sich unter anderem
@@ -17,9 +17,8 @@
<link linkend="language.oop5.abstract">abstrakte</link> und
<link linkend="language.oop5.final">finale</link> Klassen und Methoden
sowie <link linkend="language.oop5.magic">magische Methoden</link>,
- <link linkend="language.oop5.interfaces">Interfaces</link>,
- <link linkend="language.oop5.cloning">Cloning</link> und
- <link linkend="language.oop5.typehinting">Typehinting</link>.
+ <link linkend="language.oop5.interfaces">Interfaces</link> und
+ <link linkend="language.oop5.cloning">Cloning</link>.
</para>
<para>
PHP behandelt Objekte auf die gleiche Art wie Referenzen oder Handles, das
@@ -49,7 +48,6 @@
&language.oop5.final;
&language.oop5.cloning;
&language.oop5.object-comparison;
- &language.oop5.typehinting;
&language.oop5.late-static-bindings;
&language.oop5.references;
&language.oop5.serialization;
Modified: phpdoc/de/trunk/reference/filesystem/functions/file-get-contents.xml
===================================================================
--- phpdoc/de/trunk/reference/filesystem/functions/file-get-contents.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/filesystem/functions/file-get-contents.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 347555 Maintainer: wiesemann Status: ready -->
+<!-- EN-Revision: 351365 Maintainer: wiesemann Status: ready -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.file-get-contents" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>file_get_contents</refname>
@@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
- <type>string</type><methodname>file_get_contents</methodname>
+ <type class="union"><type>string</type><type>false</type></type><methodname>file_get_contents</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter><initializer>&false;</initializer></methodparam>
<methodparam choice="opt"><type>resource</type><parameter>context</parameter></methodparam>
@@ -60,7 +60,7 @@
Suche im <link linkend="ini.include-path">include path</link>
auszulösen.
Dies ist nicht möglich, wenn <link
- linkend="functions.arguments.type-declaration.strict">strenge
+ linkend="language.types.declarations.strict">strenge
Typisierung</link> aktiviert wurde, da
<constant>FILE_USE_INCLUDE_PATH</constant> ein
<type>int</type> ist. Statt dessen ist &true; zu verwenden.
@@ -215,13 +215,6 @@
Unterstützung für negative <parameter>offset</parameter>s wurde hinzugefügt.
</entry>
</row>
- <row>
- <entry>5.1.0</entry>
- <entry>
- Die <parameter>offset</parameter>- und
- <parameter>maxlen</parameter>-Parameter wurden hinzugefügt.
- </entry>
- </row>
</tbody>
</tgroup>
</informaltable>
Modified: phpdoc/de/trunk/reference/funchand/functions/func-get-arg.xml
===================================================================
--- phpdoc/de/trunk/reference/funchand/functions/func-get-arg.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/funchand/functions/func-get-arg.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 338280 Maintainer: hholzgra Status: ready -->
+<!-- EN-Revision: 351112 Maintainer: hholzgra Status: ready -->
<refentry xml:id="function.func-get-arg" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -49,40 +49,6 @@
</para>
</refsect1>
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Diese Funktion kann nun auch in Parameterlisten genutzt werden.
- </entry>
- </row>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Wird diese Funktion aus dem äußersten Geltungsbereich einer Datei
- aufgerufen, die durch den Aufruf von <function>include</function> oder
- <function>require</function> innerhalb einer Funktion in der aufrufenden
- Datei inkludiert wurde, wird nun eine Warnung generiert und &false;
- zurückgegeben.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
-
<refsect1 role="errors">
&reftitle.errors;
<para>
@@ -226,7 +192,7 @@
&reftitle.seealso;
<para>
<simplelist>
- <member><link linkend="functions.variable-arg-list.new"><literal>...</literal> syntax in PHP 5.6+</link></member>
+ <member><link linkend="functions.variable-arg-list"><literal>...</literal> syntax in PHP 5.6+</link></member>
<member><function>func_get_args</function></member>
<member><function>func_num_args</function></member>
</simplelist>
Modified: phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml
===================================================================
--- phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/funchand/functions/func-get-args.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 338280 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 351112 Maintainer: nobody Status: ready -->
<refentry xml:id="function.func-get-args" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -32,39 +32,6 @@
</para>
</refsect1>
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Diese Funktion kann nun auch in Parameterlisten genutzt werden.
- </entry>
- </row>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Wird diese Funktion aus dem äußeren Geltungsbereich einer Datei
- aufgerufen, die durch den Aufruf von <function>include</function>
- oder <function>require</function> aus einer Funktion heraus inkludiert
- wurde, wird nun eine Warnung erzeugt, und &false; zurückgegeben.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
-
<refsect1 role="errors">
&reftitle.errors;
<para>
@@ -229,7 +196,7 @@
&reftitle.seealso;
<para>
<simplelist>
- <member><link linkend="functions.variable-arg-list.new"><literal>...</literal> Syntax in PHP 5.6+</link></member>
+ <member><link linkend="functions.variable-arg-list"><literal>...</literal> Syntax in PHP 5.6+</link></member>
<member><function>func_get_arg</function></member>
<member><function>func_num_args</function></member>
<member><methodname>ReflectionFunctionAbstract::getParameters</methodname></member>
Modified: phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml
===================================================================
--- phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/funchand/functions/func-num-args.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 334626 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 351112 Maintainer: nobody Status: ready -->
<refentry xml:id="function.func-num-args" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -32,39 +32,6 @@
</para>
</refsect1>
- <refsect1 role="changelog">
- &reftitle.changelog;
- <para>
- <informaltable>
- <tgroup cols="2">
- <thead>
- <row>
- <entry>&Version;</entry>
- <entry>&Description;</entry>
- </row>
- </thead>
- <tbody>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Diese Funktion kann nun auch in Parameterlisten genutzt werden.
- </entry>
- </row>
- <row>
- <entry>5.3.0</entry>
- <entry>
- Wird diese Funktion aus dem äußeren Geltungsbereich einer Datei
- aufgerufen, die durch den Aufruf von <function>include</function>
- oder <function>require</function> aus einer Funktion heraus inkludiert
- wurde, wird nun eine Warnung erzeugt, und -1 zurückgegeben.
- </entry>
- </row>
- </tbody>
- </tgroup>
- </informaltable>
- </para>
- </refsect1>
-
<refsect1 role="errors">
&reftitle.errors;
<para>
@@ -153,7 +120,7 @@
&reftitle.seealso;
<para>
<simplelist>
- <member><link linkend="functions.variable-arg-list.new"><literal>...</literal> Syntax in PHP 5.6+</link></member>
+ <member><link linkend="functions.variable-arg-list"><literal>...</literal> Syntax in PHP 5.6+</link></member>
<member><function>func_get_arg</function></member>
<member><function>func_get_args</function></member>
<member><methodname>ReflectionFunctionAbstract::getNumberOfParameters</methodname></member>
Modified: phpdoc/de/trunk/reference/soap/soapclient/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapclient/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapclient/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 343898 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 352202 Maintainer: sammywg Status: ready -->
<refentry xml:id="soapclient.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,11 +10,11 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
+ <constructorsynopsis>
<modifier>public</modifier> <methodname>SoapClient::__construct</methodname>
- <methodparam><type>mixed</type><parameter>wsdl</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
- </methodsynopsis>
+ <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>wsdl</parameter></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapClient::SoapClient</methodname>
</para>
Modified: phpdoc/de/trunk/reference/soap/soapfault/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapfault/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapfault/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: simp Status: ready -->
+<!-- EN-Revision: 352202 Maintainer: simp Status: ready -->
<refentry xml:id="soapfault.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,15 +10,15 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
- <methodname>SoapFault::__construct</methodname>
- <methodparam><type>string</type><parameter>faultcode</parameter></methodparam>
- <methodparam><type>string</type><parameter>faultstring</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>faultactor</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>detail</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>faultname</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>headerfault</parameter></methodparam>
- </methodsynopsis>
+ <constructorsynopsis>
+ <modifier>public</modifier> <methodname>SoapFault::__construct</methodname>
+ <methodparam><type class="union"><type>array</type><type>string</type><type>null</type></type><parameter>code</parameter></methodparam>
+ <methodparam><type>string</type><parameter>string</parameter></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>actor</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter>details</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>name</parameter><initializer>&null;</initializer></methodparam>
+ <methodparam choice="opt"><type>mixed</type><parameter>headerFault</parameter><initializer>&null;</initializer></methodparam>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapFault::SoapFault</methodname>
</para>
Modified: phpdoc/de/trunk/reference/soap/soapheader/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapheader/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapheader/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 288721 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 352204 Maintainer: nobody Status: ready -->
<refentry xml:id="soapheader.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,7 +10,7 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
+ <constructorsynopsis>
<methodname>SoapHeader::__construct</methodname>
<methodparam><type>string</type><parameter>namespace</parameter></methodparam>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
@@ -17,7 +17,7 @@
<methodparam choice="opt"><type>mixed</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type>bool</type><parameter>mustunderstand</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>actor</parameter></methodparam>
- </methodsynopsis>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapHeader::SoapHeader</methodname>
</para>
Modified: phpdoc/de/trunk/reference/soap/soapparam/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapparam/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapparam/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 312929 $ -->
-<!-- EN-Revision: 288721 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 352202 Maintainer: nobody Status: ready -->
<refentry xml:id="soapparam.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,11 +10,11 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
- <methodname>SoapParam::__construct</methodname>
+ <constructorsynopsis>
+ <modifier>public</modifier> <methodname>SoapParam::__construct</methodname>
<methodparam><type>mixed</type><parameter>data</parameter></methodparam>
<methodparam><type>string</type><parameter>name</parameter></methodparam>
- </methodsynopsis>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapParam::SoapParam</methodname>
</para>
Modified: phpdoc/de/trunk/reference/soap/soapserver/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapserver/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapserver/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision: 312929 $ -->
-<!-- EN-Revision: 321901 Maintainer: nobody Status: ready -->
+<!-- EN-Revision: 352202 Maintainer: nobody Status: ready -->
<refentry xml:id="soapserver.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,11 +10,11 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
+ <constructorsynopsis>
<modifier>public</modifier> <methodname>SoapServer::__construct</methodname>
- <methodparam><type>mixed</type><parameter>wsdl</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter>options</parameter></methodparam>
- </methodsynopsis>
+ <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>wsdl</parameter></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter>options</parameter><initializer>[]</initializer></methodparam>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapServer::SoapServer</methodname>
</para>
Modified: phpdoc/de/trunk/reference/soap/soapvar/construct.xml
===================================================================
--- phpdoc/de/trunk/reference/soap/soapvar/construct.xml 2020-12-29 14:14:24 UTC (rev 352271)
+++ phpdoc/de/trunk/reference/soap/soapvar/construct.xml 2020-12-29 15:19:30 UTC (rev 352272)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
-<!-- EN-Revision: 339115 Maintainer: sammywg Status: ready -->
+<!-- EN-Revision: 352202 Maintainer: sammywg Status: ready -->
<refentry xml:id="soapvar.construct" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -10,15 +10,15 @@
<refsect1 role="description">
&reftitle.description;
- <methodsynopsis>
- <methodname>SoapVar::__construct</methodname>
+ <constructorsynopsis>
+ <modifier>public</modifier> <methodname>SoapVar::__construct</methodname>
<methodparam><type>mixed</type><parameter>data</parameter></methodparam>
- <methodparam><type>string</type><parameter>encoding</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>type_name</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>type_namespace</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>node_name</parameter></methodparam>
- <methodparam choice="opt"><type>string</type><parameter>node_namespace</parameter></methodparam>
- </methodsynopsis>
+ <methodparam><type class="union"><type>int</type><type>null</type></type><parameter>encoding</parameter></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>typeName</parameter><initializer>""</initializer></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>typeNamespace</parameter><initializer>""</initializer></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>nodeName</parameter><initializer>""</initializer></methodparam>
+ <methodparam choice="opt"><type>string</type><parameter>nodeNamespace</parameter><initializer>""</initializer></methodparam>
+ </constructorsynopsis>
<para>
&info.function.alias; <methodname>SoapVar::SoapVar</methodname>
</para>