cvs: phpdoc-de /features commandline.xml cookies.xml /language/oop5 paamayim-nekudotayim.xml reflection.xml
| From: | Hartmut Holzgraefe | Date: | Sun, 23 Mar 2008 13:49:23 +0000 |
| Subject: | cvs: phpdoc-de /features commandline.xml cookies.xml /language/oop5 paamayim-nekudotayim.xml reflection.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2604@lists.php.net to get a copy of this message | ||
hholzgra Sun Mar 23 13:49:23 2008 UTC
Modified files:
/phpdoc-de/features commandline.xml cookies.xml
/phpdoc-de/language/oop5 paamayim-nekudotayim.xml reflection.xml
Log:
translation updates
http://cvs.php.net/viewvc.cgi/phpdoc-de/features/commandline.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/features/commandline.xml diff -u phpdoc-de/features/commandline.xml:1.6 phpdoc-de/features/commandline.xml:1.7 --- phpdoc-de/features/commandline.xml:1.6 Fri Mar 21 14:22:58 2008 +++ phpdoc-de/features/commandline.xml Sun Mar 23 13:49:23 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.48 Maintainer: hholzgra Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.52 Maintainer: hholzgra Status: ready --> <!-- Credits: fa --> <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP auf der Kommandozeile</title> @@ -57,9 +57,9 @@ Weil sowohl <option role="configure">--enable-cli</option> als auch <option role="configure"> --enable-cgi</option> standardmäßig eingeschaltet sind, muss <option role="configure">--enable-cli</option> in Ihrem configure-Kommando - nicht zwingend bedeuten, dass das CLI während - <command>make install</command> nach - <filename>{PREFIX}/bin/php</filename> kopiert wird. + nicht zwingend bedeuten, dass das CLI während + <command>make install</command> nach + <filename>{PREFIX}/bin/php</filename> kopiert wird. </para> </note> </para> @@ -108,7 +108,7 @@ <listitem> <para> Anders als beim <literal>CGI SAPI</literal> werden keine - Header auf der Standardausgabe ausgegeben. + Header auf der Standardausgabe ausgegeben. </para> <para> Obwohl das <literal>CGI SAPI</literal> einen Weg bietet, HTTP-Header zu @@ -133,8 +133,8 @@ <listitem> <para> Es gibt bestimmte &php.ini;-Direktiven, die vom - <literal>CLI SAPI</literal> außer Kraft gesetzt werden, weil sie in - einer Kommandozeilenumgebung keinen Sinn ergeben. + <literal>CLI SAPI</literal> außer Kraft gesetzt werden, weil sie in + einer Kommandozeilenumgebung keinen Sinn ergeben. </para> <para> <table> @@ -153,9 +153,9 @@ <entry>&false;</entry> <entry> Es kann sehr schwierig sein, eine Fehlermeldung auf der - Kommandozeile zu lesen, wenn sie mit all diesen bedeutungslosen - <literal>HTML</literal>-Tags vollgestopft ist, deswegen wird - diese Direktive auf &false; gesetzt. + Kommandozeile zu lesen, wenn sie mit all diesen bedeutungslosen + <literal>HTML</literal>-Tags vollgestopft ist, deswegen wird + diese Direktive auf &false; gesetzt. </entry> </row> <row> @@ -163,11 +163,11 @@ <entry>&true;</entry> <entry> Es ist erwünscht, dass alle Ausgaben, die von - <function>print</function>, <function>echo</function> und Konsorten - kommen, sofort auf die Ausgabe geschrieben werden und nicht in - irgendeinem Puffer gecacht werden. Sie können immer noch - <link linkend="ref.outcontrol">output buffering</link> benutzen, - wenn Sie die Standardausgabe aufschieben oder manipulieren wollen. + <function>print</function>, <function>echo</function> und Konsorten + kommen, sofort auf die Ausgabe geschrieben werden und nicht in + irgendeinem Puffer gecacht werden. Sie können immer noch + <link linkend="ref.outcontrol">output buffering</link> benutzen, + wenn Sie die Standardausgabe aufschieben oder manipulieren wollen. </entry> </row> <row> @@ -176,10 +176,10 @@ <entry> Wegen der unendlichen Möglichkeiten, PHP in Kommandozeilenumgebungen zu benutzen wurde die maximale - Ausführungszeit auf unbegrenzte Zeit eingestellt. Wohingegen - Anwendungen, die für das Web geschrieben wurden, oft in sehr kurzer - Zeit ausgeführt werden, neigen Anwendungen für die Kommandozeile - dazu, eine viel längere Ausführungszeit zu beanspruchen. + Ausführungszeit auf unbegrenzte Zeit eingestellt. Wohingegen + Anwendungen, die für das Web geschrieben wurden, oft in sehr kurzer + Zeit ausgeführt werden, neigen Anwendungen für die Kommandozeile + dazu, eine viel längere Ausführungszeit zu beanspruchen. </entry> </row> <row> @@ -188,27 +188,27 @@ <entry> <para> Weil diese Einstellung auf &true; gesetzt ist, werden Sie immer - Zugriff auf <emphasis>argc</emphasis> (Anzahl der Argumente, die - der Anwendung übergeben wurden) und <emphasis>argv</emphasis> - (Array der eigentlichen Argumente) im <literal>CLI SAPI</literal> - haben. + Zugriff auf <emphasis>argc</emphasis> (Anzahl der Argumente, die + der Anwendung übergeben wurden) und <emphasis>argv</emphasis> + (Array der eigentlichen Argumente) im <literal>CLI SAPI</literal> + haben. </para> <para> Seit PHP 4.3.0 werden die PHP-Variablen - <varname>$argc</varname> und <varname>$argv</varname> registriert - und mit den entsprechenden Werten gefüllt, wenn das - <literal>CLI SAPI</literal> benutzt wird. Vor dieser Version - verhielt sich die Erzeugung dieser Variablen so wie in den - <literal>CGI</literal>- und <literal>MODULE</literal>-Versionen, - die die PHP-Direktive - <link linkend="ini.register-globals">register_globals</link> auf - <emphasis>on</emphasis> verlangen. Ungeachtet der Version oder der - Einstellung von - <link linkend="ini.register-globals">register_globals</link> + <varname>$argc</varname> und <varname>$argv</varname> registriert + und mit den entsprechenden Werten gefüllt, wenn das + <literal>CLI SAPI</literal> benutzt wird. Vor dieser Version + verhielt sich die Erzeugung dieser Variablen so wie in den + <literal>CGI</literal>- und <literal>MODULE</literal>-Versionen, + die die PHP-Direktive + <link linkend="ini.register-globals">register_globals</link> auf + <emphasis>on</emphasis> verlangen. Ungeachtet der Version oder der + Einstellung von + <link linkend="ini.register-globals">register_globals</link> können Sie immer - <link linkend="reserved.variables.server">$_SERVER</link> oder - <varname>$HTTP_SERVER_VARS</varname> benutzen. Beispiel: - <varname>$_SERVER['argv']</varname> + <link linkend="reserved.variables.server">$_SERVER</link> oder + <varname>$HTTP_SERVER_VARS</varname> benutzen. Beispiel: + <varname>$_SERVER['argv']</varname> </para> </entry> </row> @@ -225,7 +225,7 @@ durchlaufen wurden. Dennoch können die Werte zur Laufzeit verändert werden (was aber für alle diese Direktiven keinen Sinn ergibt, beispielsweise - <link linkend="ini.register-argc-argv">register_argc_argv</link>). + <link linkend="ini.register-argc-argv">register_argc_argv</link>). </para> </note> </listitem> @@ -316,8 +316,14 @@ </programlisting> Sie brauchen diese Ressourcen nicht explizit schliessen, weil sie automatisch von PHP geschlossen werden, wenn - ihr Skript endet. + ihr Skript endet. </para> + <note> + <para> + Diese Konstanten sind nicht verfügbar wenn ein PHP Skript von + <literal>stdin</literal> eingelesen wird. + </para> + </note> </listitem> <listitem> <para> @@ -351,7 +357,7 @@ </screen> <para> Dies zeigt deutlich, dass PHP das aktuelle - Verzeichnis auf das des ausgeführten Skriptes ändert. + Verzeichnis auf das des ausgeführten Skriptes ändert. </para> <para> Benutzen der <literal>CLI SAPI</literal>-Version ergibt: @@ -448,11 +454,18 @@ </informalexample> <para> Beide Arten (ob sie die Option <option>-f</option> benutzen oder - nicht) führen die Datei <filename>my_script.php</filename> aus. - Sie können eine beliebige Datei ausführen - Ihr PHP-Skript - muss nicht die Dateiendung <literal>.php</literal> haben, sie + nicht) führen die Datei <filename>my_script.php</filename> aus. + Sie können eine beliebige Datei ausführen - Ihr PHP-Skript + muss nicht die Dateiendung <literal>.php</literal> haben, sie kann einen beliebigen Namen und eine beliebige Endung haben. </para> + <note> + <para> + Wenn Sie Argumente an Ihr Skript übergeben wollen müssen Sie + <literal>--</literal> als erstes Argument übergeben wenn Sie + die <option>-f</option> Option benutzen. + </para> + </note> </listitem> <listitem> <para> @@ -640,9 +653,9 @@ <entry> <para> Mit dieser Option kann man entweder ein Verzichnis angeben, - wo nach &php.ini; gesucht werden soll, oder man kann eine - eigene <literal>INI</literal>-Datei direkt angeben (diese - muss nicht &php.ini; heissen). Zum Beispiel: + wo nach &php.ini; gesucht werden soll, oder man kann eine + eigene <literal>INI</literal>-Datei direkt angeben (diese + muss nicht &php.ini; heissen). Zum Beispiel: </para> <informalexample> <screen> @@ -683,7 +696,7 @@ </para> <informalexample> <para> - Beispiele (die Zeilen sind aus layouttechnischen Gründen umgebrochen): + Beispiele (die Zeilen sind aus layouttechnischen Gründen umgebrochen): </para> <screen> <![CDATA[ @@ -731,6 +744,13 @@ verbindlich und kann weggelassen werden. Alleinige Angabe des Dateinamens ist ausreichend. </para> + <note> + <para> + Um Argumente an das Srkipt zu übergeben muss das erste Argument + <literal>--</literal> sein, ansonsten interpretiert PHP diese + als PHP Optionen. + </para> + </note> </entry> </row> <row> @@ -748,9 +768,9 @@ Diese Kommandozeilenoption ruft <function>phpinfo</function> auf und gibt das Ergebnis aus. Wenn PHP nicht korrekt funktioniert, ist es ratsam, <command>php -i</command> - zu benutzen und nachzusehen, ob etwa Fehlermeldungen vor oder - statt der Informationstabellen ausgegeben werden. Beachten Sie, - dass die Ausgabe bei Verwendung des CGI-Modus in <literal>HTML</literal> erfolgt + zu benutzen und nachzusehen, ob etwa Fehlermeldungen vor oder + statt der Informationstabellen ausgegeben werden. Beachten Sie, + dass die Ausgabe bei Verwendung des CGI-Modus in <literal>HTML</literal> erfolgt und deswegen ziemlich umfangreich ist. </entry> </row> @@ -765,8 +785,8 @@ detected in <filename></literal> auf die Standardausgabe geschrieben und der Rückgabewert ist <literal>0</literal>. Bei Misserfolg wird der Text <literal>Errors parsing - <filename></literal> zusätzlich zur internen - Parser-Fehlermeldung auf der Standardausgabe + <filename></literal> zusätzlich zur internen + Parser-Fehlermeldung auf der Standardausgabe ausgegeben und der Rückgabewert auf <literal>255</literal> gesetzt. </para> <para> @@ -788,7 +808,7 @@ <informalexample> <para> Wird diese Option benutzt, gibt PHP die eingebauten (und geladenen) PHP- und - Zend-Module aus: + Zend-Module aus: </para> <screen> <![CDATA[ @@ -819,15 +839,15 @@ Diese Option erlaubt die Ausführung von PHP direkt aus der Kommandozeile. Die PHP-Start- und -End-Tags (<literal><?php</literal> und - <literal>?></literal>) werden - <emphasis role="strong">nicht benötigt</emphasis> und verursachen + <literal>?></literal>) werden + <emphasis role="strong">nicht benötigt</emphasis> und verursachen Parserfehler, wenn sie dennoch vorhanden sind. </para> <note> <para> Man muss bei Benutzung dieser Form von PHP - aufpassen, dass es zu keinen Kollisionen mit - Kommandozeilenvariablen kommt. + aufpassen, dass es zu keinen Kollisionen mit + Kommandozeilenvariablen kommt. </para> <informalexample> <para> @@ -855,8 +875,8 @@ </screen> <para> Der korrekte Weg wäre, einfache Anführungszeichen zu benutzen - (<literal>'</literal>). Variablen in einfachen Anführungszeichen - werden von sh/bash nicht ersetzt. + (<literal>'</literal>). Variablen in einfachen Anführungszeichen + werden von sh/bash nicht ersetzt. </para> <screen> <![CDATA[ @@ -881,8 +901,8 @@ Bugreport unter <link xlink:href="&url.php.bugs;">&url.php.bugs;</link> eintragen. Man kann dennoch leicht in Schwierigkeiten kommen, wenn man versucht, - Kommandozeilenvariablen zu verwenden oder mit Backslashes zu escapen. - Sie wurden gewarnt. <!-- :-) --> + Kommandozeilenvariablen zu verwenden oder mit Backslashes zu escapen. + Sie wurden gewarnt. <!-- :-) --> </para> </note> <note> @@ -961,15 +981,15 @@ <entry>--syntax-highlight and --syntax-highlighting</entry> <entry> <para> - Den Quelltext mit farbiger Syntaxhervorhebung anzeigen. + Den Quelltext mit farbiger Syntaxhervorhebung anzeigen. </para> <para> Diese Option benutzt den internen Mechanismus zum Analysieren der Datei, generiert eine <literal>HTML</literal>-Version mit - Syntax-Highlighting davon, und schreibt sie auf die - Standardausgabe. Beachten Sie, dass sie nur einen Block von - <literal><code> [...] </code></literal>-HTML-Tags - erzeugt, keine HTML-Header. + Syntax-Highlighting davon, und schreibt sie auf die + Standardausgabe. Beachten Sie, dass sie nur einen Block von + <literal><code> [...] </code></literal>-HTML-Tags + erzeugt, keine HTML-Header. </para> <note> <para> @@ -1021,9 +1041,9 @@ dem momentanen Standard-Bibliotheken-Pfad auf Ihrem System zu laden (auf Linux-Systemen normalerweise in <filename>/etc/ld.so.conf</filename> angegeben). Wenn ein Dateiname mit - absoluter Pfadinformation übergeben wird, wird der Bibliotheken-Pfad - des Systems nicht benutzt. Ein relativer Dateiname mit - Pfadinformationen wird PHP nur veranlassen, + absoluter Pfadinformation übergeben wird, wird der Bibliotheken-Pfad + des Systems nicht benutzt. Ein relativer Dateiname mit + Pfadinformationen wird PHP nur veranlassen, zu versuchen, die Erweiterung in einem Pfad relativ zum aktuellen Verzeichnis zu laden. </para> @@ -1097,6 +1117,41 @@ <link linkend="language.oop5.reflection">Reflection</link> Unterstützung kompiliert wurde. </para> + <para> + <example> + <title><literal>--rc</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --rc Directory +Class [ <internal:standard> class Directory ] { + + - Constants [0] { + } + + - Static properties [0] { + } + + - Static methods [0] { + } + + - Properties [0] { + } + + - Methods [3] { + Method [ <internal> public method close ] { + } + + Method [ <internal> public method rewind ] { + } + + Method [ <internal> public method read ] { + } + } +} +]]> + </programlisting> + </example> + </para> </entry> </row> <row> @@ -1113,16 +1168,60 @@ <link linkend="language.oop5.reflection">Reflection</link> Unterstützung kompiliert wurde. </para> + <para> + <example> + <title><literal>--re</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --re json +Extension [ <persistent> extension #19 json version 1.2.1 ] { + + - Functions { + Function [ <internal> function json_encode ] { + } + Function [ <internal> function json_decode ] { + } + } +} +]]> + </programlisting> + </example> + </para> </entry> </row> <row> - <entry>-ri</entry> + <entry>--ri</entry> <entry>--rextinfo</entry> <entry> <para> Zeigt die Konfiguration der gegebenen Extension (entspricht der von <function>phpinfo</function> zurückgegebenen Information). - Verfügbar seit PHP 5.2.2. + Verfügbar seit PHP 5.2.2. Die Konfiguration des Sprachkerns können + über den speziellen Extension Namen "main" ermittelt werden. + </para> + <para> + <example> + <title><literal>--ri</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --ri date + +date + +date/time support => enabled +"Olson" Timezone Database Version => 2007.5 +Timezone Database => internal +Default timezone => Europe/Oslo + +Directive => Local Value => Master Value +date.timezone => Europe/Oslo => Europe/Oslo +date.default_latitude => 59.22482 => 59.22482 +date.default_longitude => 11.018084 => 11.018084 +date.sunset_zenith => 90.583333 => 90.583333 +date.sunrise_zenith => 90.583333 => 90.583333 +]]> + </programlisting> + </example> </para> </entry> </row> http://cvs.php.net/viewvc.cgi/phpdoc-de/features/cookies.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/features/cookies.xml diff -u phpdoc-de/features/cookies.xml:1.10 phpdoc-de/features/cookies.xml:1.11 --- phpdoc-de/features/cookies.xml:1.10 Sat Jun 23 13:21:28 2007 +++ phpdoc-de/features/cookies.xml Sun Mar 23 13:49:23 2008 @@ -1,16 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.14 Maintainer: tom Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.22 Maintainer: hholzgra Status: ready --> +<!-- Credits: tom --> <chapter xml:id="features.cookies" xmlns="http://docbook.org/ns/docbook"> <title>Cookies</title> <para> - PHP unterstützt HTTP-Cookies. Hierbei handelt es sich um einen + PHP unterstützt <acronym>HTTP</acronym>-Cookies. Hierbei handelt es sich um einen Mechanismus, um Informationen beim Client zu speichern und somit wiederkehrende Besucher zu identifizieren oder ihren Weg innerhalb - des Angebotes nachzuvollziehen. Cookies können durch die Funktion - <function>setcookie</function> gesetzt werden. Sie sind Bestandteil - des HTTP-Headers, was bedeutet, dass die Funktion + des Angebotes nachzuvollziehen. Cookies können durch die Funktionen + <function>setcookie</function> und <function>setrawcookie</function> + gesetzt werden. Sie sind Bestandteil + des <acronym>HTTP</acronym>-Headers, was bedeutet, dass die Funktion <function>setcookie</function> aufgerufen werden muss, bevor irgendeine Ausgabe an den Browser erfolgt. Dies ist die gleiche Einschränkung, der auch die Funktion <function>header</function> unterliegt. Sie können @@ -20,26 +22,31 @@ </para> <para> - Vom Client gesendete Cookies werden - abhängig von den - Konfigurationsvariablen <literal>register_globals</literal> und - <literal>variables_order</literal> - automatisch in eine Variable - geschrieben, wie es auch bei mittels GET oder POST gesendeten Daten - geschieht. Sollen einem Cookie mehrere Werte zugewiesen werden, so - muss dem Cookienamen lediglich <emphasis>[]</emphasis> angefügt + Vom Client gesendete Cookies werden automatisch im auto-globalen + Array + <link linkend="reserved.variables.cookies">$_COOKIE</link> + abgelegt wenn die <link linkend="ini.variables-order">variables_order</link> + Konfigurationsvariable den Kennbuchstaben "C" enthält. + Sollen einem Cookie mehrere Werte zugewiesen werden, so + muss dem Cookienamen lediglich <literal>[]</literal> angefügt werden. </para> <para> - Seit PHP 4.1.0 werden alle vom Client gesendeten Cookies in dem - auto-globalen Array <varname>$_COOKIE</varname> gespeichert. In - älteren PHP-Versionen stehen diese Daten in + Abhängig von Ihrer <link linkend="ini.register-globals">register_globals</link> + Konfiguration können Cookie-Inhalte auch in regulären Variablen + abgelegt werden. Es wird aber empfohlen sich nicht hierauf zu + verlassen da dies oft aus Sicherheitsgründen deaktiviert ist. + In älteren PHP-Versionen stehen diese Daten in <varname>$HTTP_COOKIE_VARS</varname> gespeichert, sofern die - Konfigurationsvariable <literal>track_vars</literal> gesetzt ist. + Konfigurationsvariable <literal>track_vars</literal> gesetzt ist + (diese Konfigurationsvariable ist seit PHP 4.0.3 verfügbar). </para> <para> Weitere Informationen sowie Anmerkungen zu Browser-Bugs finden - Sie im Abschnitt <function>setcookie</function>. + Sie im Abschnitt <function>setcookie</function> und + <function>setrawcookie</function>. </para> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-de/language/oop5/paamayim-nekudotayim.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/language/oop5/paamayim-nekudotayim.xml diff -u phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.2 phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.3 --- phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.2 Sat Jun 23 13:21:28 2007 +++ phpdoc-de/language/oop5/paamayim-nekudotayim.xml Sun Mar 23 13:49:23 2008 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.8 Maintainer: simp Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.14 Maintainer: hholzgra Status: ready --> +<!-- Credits: simp --> <sect1 xml:id="language.oop5.paamayim-nekudotayim" xmlns="http://docbook.org/ns/docbook"> <title>Gültigkeitsbereichsoperator (::)</title> @@ -18,6 +19,12 @@ </para> <para> + Beginnend mit PHP 5.3.0 ist es möglich eine Variable als Klassenreferenz + zu nutzen. Der Variablenwert kann kein Schlüsselwort (wie <literal>self</literal>, + <literal>parent</literal> oder <literal>static</literal>) sein. + </para> + + <para> Paamayim Nekudotayim scheint auf den ersten Blick eine eigenartige Wahl für die Benennung eines Doppel-Doppelpunktes zu sein. Jedoch entschied sich das Zend Team ihn so zu nennen, während Sie die Zend Engine 0.5 schrieben @@ -34,6 +41,9 @@ const CONST_VALUE = 'Ein konstanter Wert'; } +$classname = 'MyClass'; +echo $classname::CONST_VALUE; // Ab PHP 5.3.0 + echo MyClass::CONST_VALUE; ?> ]]> @@ -61,6 +71,9 @@ } } +$classname = 'OtherClass'; +echo $classname::doubleColon(); // Ab PHP 5.3.0 + OtherClass::doubleColon(); ?> ]]> http://cvs.php.net/viewvc.cgi/phpdoc-de/language/oop5/reflection.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/language/oop5/reflection.xml diff -u phpdoc-de/language/oop5/reflection.xml:1.8 phpdoc-de/language/oop5/reflection.xml:1.9 --- phpdoc-de/language/oop5/reflection.xml:1.8 Thu Nov 22 21:38:41 2007 +++ phpdoc-de/language/oop5/reflection.xml Sun Mar 23 13:49:23 2008 @@ -1,8 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.22 Maintainer: simp Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.34 Maintainer: hartmut Status: ready --> +<!-- Credits: simp --> <sect1 xml:id="language.oop5.reflection" xmlns="http://docbook.org/ns/docbook"> <title>Reflection</title> + <sect2 xml:id="language.oop5.reflection.toc"> + <title>Table of Contents</title> + <simplelist> + <member><link linkend="language.oop5.reflection.introduction">Einleitung</link></member> + <member><link linkend="language.oop5.reflection.reflector">Die Reflector Interface</link></member> + <member><link linkend="language.oop5.reflection.reflectionexception">Die ReflectionException Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionfunction">Die ReflectionFunction Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionparameter">Die ReflectionParameter Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionclass">Die Reflection Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionobject">Die ReflectionObject Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionmethod">Die ReflectionMethod Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionproperty">Die ReflectionProperty Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionextension">Die ReflectionExtension Klasse</link></member> + <member><link linkend="language.oop5.reflection.extending">Erweitern der Reflection Klassen</link></member> + </simplelist> + </sect2> <sect2 xml:id="language.oop5.reflection.introduction"> <title>Einleitung</title> <para> @@ -77,11 +94,11 @@ Method [ <internal> final private method __clone ] { } - Method [ <internal> <ctor> public method __construct ] { + Method [ <internal, ctor> public method __construct ] { - Parameters [2] { - Parameter #0 [ <required> $message ] - Parameter #1 [ <required> $code ] + Parameter #0 [ <optional> $message ] + Parameter #1 [ <optional> $code ] } } @@ -113,6 +130,27 @@ </para> </sect2> + <sect2 xml:id="language.oop5.reflection.reflector"> + <title><classname>Reflector</classname></title> + <para> + <classname>Reflector</classname> ist ein von allen Reflektionsklassen + implementiertes Interface. + </para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +interface Reflector +{ + public string __toString() + public static string export() +} +?> +]]> + </programlisting> + </informalexample> + </sect2> + <sect2 xml:id="language.oop5.reflection.reflectionexception"> <title><classname>ReflectionException</classname></title> <para> @@ -136,18 +174,19 @@ class ReflectionFunction extends ReflectionFunctionAbstract implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export(string name, bool return) public string getName() public bool isInternal() + public bool isDisabled() public bool isUserDefined() public string getFileName() public int getStartLine() public int getEndLine() public string getDocComment() public array getStaticVariables() - public mixed invoke(mixed args) + public mixed invoke([mixed args [, ...]]) public mixed invokeArgs(array args) public bool returnsReference() public ReflectionParameter[] getParameters() @@ -158,6 +197,12 @@ ]]> </programlisting> </informalexample> + <para> + Die Elternklasse <classname>ReflectionFunctionAbstract</classname> hat die + gleichen Methoden mit Ausnahme von <function>invoke</function>, + <function>invokeArgs</function>, <function>export</function> und + <function>isDisabled</function>. + </para> <note> <simpara> <function>getNumberOfParameters</function> und @@ -245,7 +290,7 @@ class ReflectionParameter implements Reflector { final private __clone() - public object __construct(string function, string parameter) + public void __construct(string function, string parameter) public string __toString() public static string export(mixed function, mixed parameter, bool return) public string getName() @@ -269,9 +314,8 @@ <function>isDefaultValueAvailable</function> und <function>isOptional</function> wurden in PHP 5.0.3 hinzugefügt, während <function>isArray</function> in PHP 5.1.0 neu ist. - <!-- Momentan auskommentiert <function>getDeclaringFunction</function> und - <function>getPosition</function> wurden in PHP 5.1.3 hinzugefügt. --> + <function>getPosition</function> wurden in PHP 5.1.3 hinzugefügt. </para> </note> <para> @@ -323,7 +367,7 @@ <title><classname>ReflectionClass</classname></title> <para> Die <classname>ReflectionClass</classname> Klasse erlaubt es, Klassen - zurückzuentwickeln. + und Interfaces zurückzuentwickeln. </para> <informalexample> <programlisting role="php"> @@ -332,7 +376,7 @@ class ReflectionClass implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export(mixed class, bool return) public string getName() @@ -503,7 +547,7 @@ class ReflectionObject extends ReflectionClass { final private __clone() - public object __construct(mixed object) + public void __construct(mixed object) public string __toString() public static string export(mixed object, bool return) } @@ -528,7 +572,7 @@ public __construct(mixed class, string name) public string __toString() public static string export(mixed class, string name, bool return) - public mixed invoke(stdclass object, mixed args) + public mixed invoke(stdclass object [, mixed args [, ...]]) public mixed invokeArgs(stdclass object, array args) public bool isFinal() public bool isAbstract() @@ -541,7 +585,7 @@ public int getModifiers() public ReflectionClass getDeclaringClass() - // Ererbt von ReflectionFunction + // Ererbt von ReflectionFunctionAbstract final private __clone() public string getName() public bool isInternal() @@ -763,6 +807,7 @@ public array getINIEntries() public ReflectionClass[] getClasses() public array getClassNames() + public string info() } ?> ]]> @@ -827,7 +872,7 @@ */ class My_Reflection_Method extends ReflectionMethod { - public $visibility = ''; + public $visibility = array(); public function __construct($o, $m) {
http://cvs.php.net/viewvc.cgi/phpdoc-de/features/commandline.xml?r1=1.6&r2=1.7&diff_format=u Index: phpdoc-de/features/commandline.xml diff -u phpdoc-de/features/commandline.xml:1.6 phpdoc-de/features/commandline.xml:1.7 --- phpdoc-de/features/commandline.xml:1.6 Fri Mar 21 14:22:58 2008 +++ phpdoc-de/features/commandline.xml Sun Mar 23 13:49:23 2008 @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.6 $ --> -<!-- EN-Revision: 1.48 Maintainer: hholzgra Status: ready --> +<!-- $Revision: 1.7 $ --> +<!-- EN-Revision: 1.52 Maintainer: hholzgra Status: ready --> <!-- Credits: fa --> <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>PHP auf der Kommandozeile</title> @@ -57,9 +57,9 @@ Weil sowohl <option role="configure">--enable-cli</option> als auch <option role="configure"> --enable-cgi</option> standardmäßig eingeschaltet sind, muss <option role="configure">--enable-cli</option> in Ihrem configure-Kommando - nicht zwingend bedeuten, dass das CLI während - <command>make install</command> nach - <filename>{PREFIX}/bin/php</filename> kopiert wird. + nicht zwingend bedeuten, dass das CLI während + <command>make install</command> nach + <filename>{PREFIX}/bin/php</filename> kopiert wird. </para> </note> </para> @@ -108,7 +108,7 @@ <listitem> <para> Anders als beim <literal>CGI SAPI</literal> werden keine - Header auf der Standardausgabe ausgegeben. + Header auf der Standardausgabe ausgegeben. </para> <para> Obwohl das <literal>CGI SAPI</literal> einen Weg bietet, HTTP-Header zu @@ -133,8 +133,8 @@ <listitem> <para> Es gibt bestimmte &php.ini;-Direktiven, die vom - <literal>CLI SAPI</literal> außer Kraft gesetzt werden, weil sie in - einer Kommandozeilenumgebung keinen Sinn ergeben. + <literal>CLI SAPI</literal> außer Kraft gesetzt werden, weil sie in + einer Kommandozeilenumgebung keinen Sinn ergeben. </para> <para> <table> @@ -153,9 +153,9 @@ <entry>&false;</entry> <entry> Es kann sehr schwierig sein, eine Fehlermeldung auf der - Kommandozeile zu lesen, wenn sie mit all diesen bedeutungslosen - <literal>HTML</literal>-Tags vollgestopft ist, deswegen wird - diese Direktive auf &false; gesetzt. + Kommandozeile zu lesen, wenn sie mit all diesen bedeutungslosen + <literal>HTML</literal>-Tags vollgestopft ist, deswegen wird + diese Direktive auf &false; gesetzt. </entry> </row> <row> @@ -163,11 +163,11 @@ <entry>&true;</entry> <entry> Es ist erwünscht, dass alle Ausgaben, die von - <function>print</function>, <function>echo</function> und Konsorten - kommen, sofort auf die Ausgabe geschrieben werden und nicht in - irgendeinem Puffer gecacht werden. Sie können immer noch - <link linkend="ref.outcontrol">output buffering</link> benutzen, - wenn Sie die Standardausgabe aufschieben oder manipulieren wollen. + <function>print</function>, <function>echo</function> und Konsorten + kommen, sofort auf die Ausgabe geschrieben werden und nicht in + irgendeinem Puffer gecacht werden. Sie können immer noch + <link linkend="ref.outcontrol">output buffering</link> benutzen, + wenn Sie die Standardausgabe aufschieben oder manipulieren wollen. </entry> </row> <row> @@ -176,10 +176,10 @@ <entry> Wegen der unendlichen Möglichkeiten, PHP in Kommandozeilenumgebungen zu benutzen wurde die maximale - Ausführungszeit auf unbegrenzte Zeit eingestellt. Wohingegen - Anwendungen, die für das Web geschrieben wurden, oft in sehr kurzer - Zeit ausgeführt werden, neigen Anwendungen für die Kommandozeile - dazu, eine viel längere Ausführungszeit zu beanspruchen. + Ausführungszeit auf unbegrenzte Zeit eingestellt. Wohingegen + Anwendungen, die für das Web geschrieben wurden, oft in sehr kurzer + Zeit ausgeführt werden, neigen Anwendungen für die Kommandozeile + dazu, eine viel längere Ausführungszeit zu beanspruchen. </entry> </row> <row> @@ -188,27 +188,27 @@ <entry> <para> Weil diese Einstellung auf &true; gesetzt ist, werden Sie immer - Zugriff auf <emphasis>argc</emphasis> (Anzahl der Argumente, die - der Anwendung übergeben wurden) und <emphasis>argv</emphasis> - (Array der eigentlichen Argumente) im <literal>CLI SAPI</literal> - haben. + Zugriff auf <emphasis>argc</emphasis> (Anzahl der Argumente, die + der Anwendung übergeben wurden) und <emphasis>argv</emphasis> + (Array der eigentlichen Argumente) im <literal>CLI SAPI</literal> + haben. </para> <para> Seit PHP 4.3.0 werden die PHP-Variablen - <varname>$argc</varname> und <varname>$argv</varname> registriert - und mit den entsprechenden Werten gefüllt, wenn das - <literal>CLI SAPI</literal> benutzt wird. Vor dieser Version - verhielt sich die Erzeugung dieser Variablen so wie in den - <literal>CGI</literal>- und <literal>MODULE</literal>-Versionen, - die die PHP-Direktive - <link linkend="ini.register-globals">register_globals</link> auf - <emphasis>on</emphasis> verlangen. Ungeachtet der Version oder der - Einstellung von - <link linkend="ini.register-globals">register_globals</link> + <varname>$argc</varname> und <varname>$argv</varname> registriert + und mit den entsprechenden Werten gefüllt, wenn das + <literal>CLI SAPI</literal> benutzt wird. Vor dieser Version + verhielt sich die Erzeugung dieser Variablen so wie in den + <literal>CGI</literal>- und <literal>MODULE</literal>-Versionen, + die die PHP-Direktive + <link linkend="ini.register-globals">register_globals</link> auf + <emphasis>on</emphasis> verlangen. Ungeachtet der Version oder der + Einstellung von + <link linkend="ini.register-globals">register_globals</link> können Sie immer - <link linkend="reserved.variables.server">$_SERVER</link> oder - <varname>$HTTP_SERVER_VARS</varname> benutzen. Beispiel: - <varname>$_SERVER['argv']</varname> + <link linkend="reserved.variables.server">$_SERVER</link> oder + <varname>$HTTP_SERVER_VARS</varname> benutzen. Beispiel: + <varname>$_SERVER['argv']</varname> </para> </entry> </row> @@ -225,7 +225,7 @@ durchlaufen wurden. Dennoch können die Werte zur Laufzeit verändert werden (was aber für alle diese Direktiven keinen Sinn ergibt, beispielsweise - <link linkend="ini.register-argc-argv">register_argc_argv</link>). + <link linkend="ini.register-argc-argv">register_argc_argv</link>). </para> </note> </listitem> @@ -316,8 +316,14 @@ </programlisting> Sie brauchen diese Ressourcen nicht explizit schliessen, weil sie automatisch von PHP geschlossen werden, wenn - ihr Skript endet. + ihr Skript endet. </para> + <note> + <para> + Diese Konstanten sind nicht verfügbar wenn ein PHP Skript von + <literal>stdin</literal> eingelesen wird. + </para> + </note> </listitem> <listitem> <para> @@ -351,7 +357,7 @@ </screen> <para> Dies zeigt deutlich, dass PHP das aktuelle - Verzeichnis auf das des ausgeführten Skriptes ändert. + Verzeichnis auf das des ausgeführten Skriptes ändert. </para> <para> Benutzen der <literal>CLI SAPI</literal>-Version ergibt: @@ -448,11 +454,18 @@ </informalexample> <para> Beide Arten (ob sie die Option <option>-f</option> benutzen oder - nicht) führen die Datei <filename>my_script.php</filename> aus. - Sie können eine beliebige Datei ausführen - Ihr PHP-Skript - muss nicht die Dateiendung <literal>.php</literal> haben, sie + nicht) führen die Datei <filename>my_script.php</filename> aus. + Sie können eine beliebige Datei ausführen - Ihr PHP-Skript + muss nicht die Dateiendung <literal>.php</literal> haben, sie kann einen beliebigen Namen und eine beliebige Endung haben. </para> + <note> + <para> + Wenn Sie Argumente an Ihr Skript übergeben wollen müssen Sie + <literal>--</literal> als erstes Argument übergeben wenn Sie + die <option>-f</option> Option benutzen. + </para> + </note> </listitem> <listitem> <para> @@ -640,9 +653,9 @@ <entry> <para> Mit dieser Option kann man entweder ein Verzichnis angeben, - wo nach &php.ini; gesucht werden soll, oder man kann eine - eigene <literal>INI</literal>-Datei direkt angeben (diese - muss nicht &php.ini; heissen). Zum Beispiel: + wo nach &php.ini; gesucht werden soll, oder man kann eine + eigene <literal>INI</literal>-Datei direkt angeben (diese + muss nicht &php.ini; heissen). Zum Beispiel: </para> <informalexample> <screen> @@ -683,7 +696,7 @@ </para> <informalexample> <para> - Beispiele (die Zeilen sind aus layouttechnischen Gründen umgebrochen): + Beispiele (die Zeilen sind aus layouttechnischen Gründen umgebrochen): </para> <screen> <![CDATA[ @@ -731,6 +744,13 @@ verbindlich und kann weggelassen werden. Alleinige Angabe des Dateinamens ist ausreichend. </para> + <note> + <para> + Um Argumente an das Srkipt zu übergeben muss das erste Argument + <literal>--</literal> sein, ansonsten interpretiert PHP diese + als PHP Optionen. + </para> + </note> </entry> </row> <row> @@ -748,9 +768,9 @@ Diese Kommandozeilenoption ruft <function>phpinfo</function> auf und gibt das Ergebnis aus. Wenn PHP nicht korrekt funktioniert, ist es ratsam, <command>php -i</command> - zu benutzen und nachzusehen, ob etwa Fehlermeldungen vor oder - statt der Informationstabellen ausgegeben werden. Beachten Sie, - dass die Ausgabe bei Verwendung des CGI-Modus in <literal>HTML</literal> erfolgt + zu benutzen und nachzusehen, ob etwa Fehlermeldungen vor oder + statt der Informationstabellen ausgegeben werden. Beachten Sie, + dass die Ausgabe bei Verwendung des CGI-Modus in <literal>HTML</literal> erfolgt und deswegen ziemlich umfangreich ist. </entry> </row> @@ -765,8 +785,8 @@ detected in <filename></literal> auf die Standardausgabe geschrieben und der Rückgabewert ist <literal>0</literal>. Bei Misserfolg wird der Text <literal>Errors parsing - <filename></literal> zusätzlich zur internen - Parser-Fehlermeldung auf der Standardausgabe + <filename></literal> zusätzlich zur internen + Parser-Fehlermeldung auf der Standardausgabe ausgegeben und der Rückgabewert auf <literal>255</literal> gesetzt. </para> <para> @@ -788,7 +808,7 @@ <informalexample> <para> Wird diese Option benutzt, gibt PHP die eingebauten (und geladenen) PHP- und - Zend-Module aus: + Zend-Module aus: </para> <screen> <![CDATA[ @@ -819,15 +839,15 @@ Diese Option erlaubt die Ausführung von PHP direkt aus der Kommandozeile. Die PHP-Start- und -End-Tags (<literal><?php</literal> und - <literal>?></literal>) werden - <emphasis role="strong">nicht benötigt</emphasis> und verursachen + <literal>?></literal>) werden + <emphasis role="strong">nicht benötigt</emphasis> und verursachen Parserfehler, wenn sie dennoch vorhanden sind. </para> <note> <para> Man muss bei Benutzung dieser Form von PHP - aufpassen, dass es zu keinen Kollisionen mit - Kommandozeilenvariablen kommt. + aufpassen, dass es zu keinen Kollisionen mit + Kommandozeilenvariablen kommt. </para> <informalexample> <para> @@ -855,8 +875,8 @@ </screen> <para> Der korrekte Weg wäre, einfache Anführungszeichen zu benutzen - (<literal>'</literal>). Variablen in einfachen Anführungszeichen - werden von sh/bash nicht ersetzt. + (<literal>'</literal>). Variablen in einfachen Anführungszeichen + werden von sh/bash nicht ersetzt. </para> <screen> <![CDATA[ @@ -881,8 +901,8 @@ Bugreport unter <link xlink:href="&url.php.bugs;">&url.php.bugs;</link> eintragen. Man kann dennoch leicht in Schwierigkeiten kommen, wenn man versucht, - Kommandozeilenvariablen zu verwenden oder mit Backslashes zu escapen. - Sie wurden gewarnt. <!-- :-) --> + Kommandozeilenvariablen zu verwenden oder mit Backslashes zu escapen. + Sie wurden gewarnt. <!-- :-) --> </para> </note> <note> @@ -961,15 +981,15 @@ <entry>--syntax-highlight and --syntax-highlighting</entry> <entry> <para> - Den Quelltext mit farbiger Syntaxhervorhebung anzeigen. + Den Quelltext mit farbiger Syntaxhervorhebung anzeigen. </para> <para> Diese Option benutzt den internen Mechanismus zum Analysieren der Datei, generiert eine <literal>HTML</literal>-Version mit - Syntax-Highlighting davon, und schreibt sie auf die - Standardausgabe. Beachten Sie, dass sie nur einen Block von - <literal><code> [...] </code></literal>-HTML-Tags - erzeugt, keine HTML-Header. + Syntax-Highlighting davon, und schreibt sie auf die + Standardausgabe. Beachten Sie, dass sie nur einen Block von + <literal><code> [...] </code></literal>-HTML-Tags + erzeugt, keine HTML-Header. </para> <note> <para> @@ -1021,9 +1041,9 @@ dem momentanen Standard-Bibliotheken-Pfad auf Ihrem System zu laden (auf Linux-Systemen normalerweise in <filename>/etc/ld.so.conf</filename> angegeben). Wenn ein Dateiname mit - absoluter Pfadinformation übergeben wird, wird der Bibliotheken-Pfad - des Systems nicht benutzt. Ein relativer Dateiname mit - Pfadinformationen wird PHP nur veranlassen, + absoluter Pfadinformation übergeben wird, wird der Bibliotheken-Pfad + des Systems nicht benutzt. Ein relativer Dateiname mit + Pfadinformationen wird PHP nur veranlassen, zu versuchen, die Erweiterung in einem Pfad relativ zum aktuellen Verzeichnis zu laden. </para> @@ -1097,6 +1117,41 @@ <link linkend="language.oop5.reflection">Reflection</link> Unterstützung kompiliert wurde. </para> + <para> + <example> + <title><literal>--rc</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --rc Directory +Class [ <internal:standard> class Directory ] { + + - Constants [0] { + } + + - Static properties [0] { + } + + - Static methods [0] { + } + + - Properties [0] { + } + + - Methods [3] { + Method [ <internal> public method close ] { + } + + Method [ <internal> public method rewind ] { + } + + Method [ <internal> public method read ] { + } + } +} +]]> + </programlisting> + </example> + </para> </entry> </row> <row> @@ -1113,16 +1168,60 @@ <link linkend="language.oop5.reflection">Reflection</link> Unterstützung kompiliert wurde. </para> + <para> + <example> + <title><literal>--re</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --re json +Extension [ <persistent> extension #19 json version 1.2.1 ] { + + - Functions { + Function [ <internal> function json_encode ] { + } + Function [ <internal> function json_decode ] { + } + } +} +]]> + </programlisting> + </example> + </para> </entry> </row> <row> - <entry>-ri</entry> + <entry>--ri</entry> <entry>--rextinfo</entry> <entry> <para> Zeigt die Konfiguration der gegebenen Extension (entspricht der von <function>phpinfo</function> zurückgegebenen Information). - Verfügbar seit PHP 5.2.2. + Verfügbar seit PHP 5.2.2. Die Konfiguration des Sprachkerns können + über den speziellen Extension Namen "main" ermittelt werden. + </para> + <para> + <example> + <title><literal>--ri</literal> example</title> + <programlisting role="shell"> +<![CDATA[ +$ php --ri date + +date + +date/time support => enabled +"Olson" Timezone Database Version => 2007.5 +Timezone Database => internal +Default timezone => Europe/Oslo + +Directive => Local Value => Master Value +date.timezone => Europe/Oslo => Europe/Oslo +date.default_latitude => 59.22482 => 59.22482 +date.default_longitude => 11.018084 => 11.018084 +date.sunset_zenith => 90.583333 => 90.583333 +date.sunrise_zenith => 90.583333 => 90.583333 +]]> + </programlisting> + </example> </para> </entry> </row> http://cvs.php.net/viewvc.cgi/phpdoc-de/features/cookies.xml?r1=1.10&r2=1.11&diff_format=u Index: phpdoc-de/features/cookies.xml diff -u phpdoc-de/features/cookies.xml:1.10 phpdoc-de/features/cookies.xml:1.11 --- phpdoc-de/features/cookies.xml:1.10 Sat Jun 23 13:21:28 2007 +++ phpdoc-de/features/cookies.xml Sun Mar 23 13:49:23 2008 @@ -1,16 +1,18 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.14 Maintainer: tom Status: ready --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.22 Maintainer: hholzgra Status: ready --> +<!-- Credits: tom --> <chapter xml:id="features.cookies" xmlns="http://docbook.org/ns/docbook"> <title>Cookies</title> <para> - PHP unterstützt HTTP-Cookies. Hierbei handelt es sich um einen + PHP unterstützt <acronym>HTTP</acronym>-Cookies. Hierbei handelt es sich um einen Mechanismus, um Informationen beim Client zu speichern und somit wiederkehrende Besucher zu identifizieren oder ihren Weg innerhalb - des Angebotes nachzuvollziehen. Cookies können durch die Funktion - <function>setcookie</function> gesetzt werden. Sie sind Bestandteil - des HTTP-Headers, was bedeutet, dass die Funktion + des Angebotes nachzuvollziehen. Cookies können durch die Funktionen + <function>setcookie</function> und <function>setrawcookie</function> + gesetzt werden. Sie sind Bestandteil + des <acronym>HTTP</acronym>-Headers, was bedeutet, dass die Funktion <function>setcookie</function> aufgerufen werden muss, bevor irgendeine Ausgabe an den Browser erfolgt. Dies ist die gleiche Einschränkung, der auch die Funktion <function>header</function> unterliegt. Sie können @@ -20,26 +22,31 @@ </para> <para> - Vom Client gesendete Cookies werden - abhängig von den - Konfigurationsvariablen <literal>register_globals</literal> und - <literal>variables_order</literal> - automatisch in eine Variable - geschrieben, wie es auch bei mittels GET oder POST gesendeten Daten - geschieht. Sollen einem Cookie mehrere Werte zugewiesen werden, so - muss dem Cookienamen lediglich <emphasis>[]</emphasis> angefügt + Vom Client gesendete Cookies werden automatisch im auto-globalen + Array + <link linkend="reserved.variables.cookies">$_COOKIE</link> + abgelegt wenn die <link linkend="ini.variables-order">variables_order</link> + Konfigurationsvariable den Kennbuchstaben "C" enthält. + Sollen einem Cookie mehrere Werte zugewiesen werden, so + muss dem Cookienamen lediglich <literal>[]</literal> angefügt werden. </para> <para> - Seit PHP 4.1.0 werden alle vom Client gesendeten Cookies in dem - auto-globalen Array <varname>$_COOKIE</varname> gespeichert. In - älteren PHP-Versionen stehen diese Daten in + Abhängig von Ihrer <link linkend="ini.register-globals">register_globals</link> + Konfiguration können Cookie-Inhalte auch in regulären Variablen + abgelegt werden. Es wird aber empfohlen sich nicht hierauf zu + verlassen da dies oft aus Sicherheitsgründen deaktiviert ist. + In älteren PHP-Versionen stehen diese Daten in <varname>$HTTP_COOKIE_VARS</varname> gespeichert, sofern die - Konfigurationsvariable <literal>track_vars</literal> gesetzt ist. + Konfigurationsvariable <literal>track_vars</literal> gesetzt ist + (diese Konfigurationsvariable ist seit PHP 4.0.3 verfügbar). </para> <para> Weitere Informationen sowie Anmerkungen zu Browser-Bugs finden - Sie im Abschnitt <function>setcookie</function>. + Sie im Abschnitt <function>setcookie</function> und + <function>setrawcookie</function>. </para> </chapter> http://cvs.php.net/viewvc.cgi/phpdoc-de/language/oop5/paamayim-nekudotayim.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/language/oop5/paamayim-nekudotayim.xml diff -u phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.2 phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.3 --- phpdoc-de/language/oop5/paamayim-nekudotayim.xml:1.2 Sat Jun 23 13:21:28 2007 +++ phpdoc-de/language/oop5/paamayim-nekudotayim.xml Sun Mar 23 13:49:23 2008 @@ -1,6 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.8 Maintainer: simp Status: ready --> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.14 Maintainer: hholzgra Status: ready --> +<!-- Credits: simp --> <sect1 xml:id="language.oop5.paamayim-nekudotayim" xmlns="http://docbook.org/ns/docbook"> <title>Gültigkeitsbereichsoperator (::)</title> @@ -18,6 +19,12 @@ </para> <para> + Beginnend mit PHP 5.3.0 ist es möglich eine Variable als Klassenreferenz + zu nutzen. Der Variablenwert kann kein Schlüsselwort (wie <literal>self</literal>, + <literal>parent</literal> oder <literal>static</literal>) sein. + </para> + + <para> Paamayim Nekudotayim scheint auf den ersten Blick eine eigenartige Wahl für die Benennung eines Doppel-Doppelpunktes zu sein. Jedoch entschied sich das Zend Team ihn so zu nennen, während Sie die Zend Engine 0.5 schrieben @@ -34,6 +41,9 @@ const CONST_VALUE = 'Ein konstanter Wert'; } +$classname = 'MyClass'; +echo $classname::CONST_VALUE; // Ab PHP 5.3.0 + echo MyClass::CONST_VALUE; ?> ]]> @@ -61,6 +71,9 @@ } } +$classname = 'OtherClass'; +echo $classname::doubleColon(); // Ab PHP 5.3.0 + OtherClass::doubleColon(); ?> ]]> http://cvs.php.net/viewvc.cgi/phpdoc-de/language/oop5/reflection.xml?r1=1.8&r2=1.9&diff_format=u Index: phpdoc-de/language/oop5/reflection.xml diff -u phpdoc-de/language/oop5/reflection.xml:1.8 phpdoc-de/language/oop5/reflection.xml:1.9 --- phpdoc-de/language/oop5/reflection.xml:1.8 Thu Nov 22 21:38:41 2007 +++ phpdoc-de/language/oop5/reflection.xml Sun Mar 23 13:49:23 2008 @@ -1,8 +1,25 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.8 $ --> -<!-- EN-Revision: 1.22 Maintainer: simp Status: ready --> +<!-- $Revision: 1.9 $ --> +<!-- EN-Revision: 1.34 Maintainer: hartmut Status: ready --> +<!-- Credits: simp --> <sect1 xml:id="language.oop5.reflection" xmlns="http://docbook.org/ns/docbook"> <title>Reflection</title> + <sect2 xml:id="language.oop5.reflection.toc"> + <title>Table of Contents</title> + <simplelist> + <member><link linkend="language.oop5.reflection.introduction">Einleitung</link></member> + <member><link linkend="language.oop5.reflection.reflector">Die Reflector Interface</link></member> + <member><link linkend="language.oop5.reflection.reflectionexception">Die ReflectionException Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionfunction">Die ReflectionFunction Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionparameter">Die ReflectionParameter Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionclass">Die Reflection Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionobject">Die ReflectionObject Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionmethod">Die ReflectionMethod Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionproperty">Die ReflectionProperty Klasse</link></member> + <member><link linkend="language.oop5.reflection.reflectionextension">Die ReflectionExtension Klasse</link></member> + <member><link linkend="language.oop5.reflection.extending">Erweitern der Reflection Klassen</link></member> + </simplelist> + </sect2> <sect2 xml:id="language.oop5.reflection.introduction"> <title>Einleitung</title> <para> @@ -77,11 +94,11 @@ Method [ <internal> final private method __clone ] { } - Method [ <internal> <ctor> public method __construct ] { + Method [ <internal, ctor> public method __construct ] { - Parameters [2] { - Parameter #0 [ <required> $message ] - Parameter #1 [ <required> $code ] + Parameter #0 [ <optional> $message ] + Parameter #1 [ <optional> $code ] } } @@ -113,6 +130,27 @@ </para> </sect2> + <sect2 xml:id="language.oop5.reflection.reflector"> + <title><classname>Reflector</classname></title> + <para> + <classname>Reflector</classname> ist ein von allen Reflektionsklassen + implementiertes Interface. + </para> + <informalexample> + <programlisting role="php"> +<![CDATA[ +<?php +interface Reflector +{ + public string __toString() + public static string export() +} +?> +]]> + </programlisting> + </informalexample> + </sect2> + <sect2 xml:id="language.oop5.reflection.reflectionexception"> <title><classname>ReflectionException</classname></title> <para> @@ -136,18 +174,19 @@ class ReflectionFunction extends ReflectionFunctionAbstract implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export(string name, bool return) public string getName() public bool isInternal() + public bool isDisabled() public bool isUserDefined() public string getFileName() public int getStartLine() public int getEndLine() public string getDocComment() public array getStaticVariables() - public mixed invoke(mixed args) + public mixed invoke([mixed args [, ...]]) public mixed invokeArgs(array args) public bool returnsReference() public ReflectionParameter[] getParameters() @@ -158,6 +197,12 @@ ]]> </programlisting> </informalexample> + <para> + Die Elternklasse <classname>ReflectionFunctionAbstract</classname> hat die + gleichen Methoden mit Ausnahme von <function>invoke</function>, + <function>invokeArgs</function>, <function>export</function> und + <function>isDisabled</function>. + </para> <note> <simpara> <function>getNumberOfParameters</function> und @@ -245,7 +290,7 @@ class ReflectionParameter implements Reflector { final private __clone() - public object __construct(string function, string parameter) + public void __construct(string function, string parameter) public string __toString() public static string export(mixed function, mixed parameter, bool return) public string getName() @@ -269,9 +314,8 @@ <function>isDefaultValueAvailable</function> und <function>isOptional</function> wurden in PHP 5.0.3 hinzugefügt, während <function>isArray</function> in PHP 5.1.0 neu ist. - <!-- Momentan auskommentiert <function>getDeclaringFunction</function> und - <function>getPosition</function> wurden in PHP 5.1.3 hinzugefügt. --> + <function>getPosition</function> wurden in PHP 5.1.3 hinzugefügt. </para> </note> <para> @@ -323,7 +367,7 @@ <title><classname>ReflectionClass</classname></title> <para> Die <classname>ReflectionClass</classname> Klasse erlaubt es, Klassen - zurückzuentwickeln. + und Interfaces zurückzuentwickeln. </para> <informalexample> <programlisting role="php"> @@ -332,7 +376,7 @@ class ReflectionClass implements Reflector { final private __clone() - public object __construct(string name) + public void __construct(string name) public string __toString() public static string export(mixed class, bool return) public string getName() @@ -503,7 +547,7 @@ class ReflectionObject extends ReflectionClass { final private __clone() - public object __construct(mixed object) + public void __construct(mixed object) public string __toString() public static string export(mixed object, bool return) } @@ -528,7 +572,7 @@ public __construct(mixed class, string name) public string __toString() public static string export(mixed class, string name, bool return) - public mixed invoke(stdclass object, mixed args) + public mixed invoke(stdclass object [, mixed args [, ...]]) public mixed invokeArgs(stdclass object, array args) public bool isFinal() public bool isAbstract() @@ -541,7 +585,7 @@ public int getModifiers() public ReflectionClass getDeclaringClass() - // Ererbt von ReflectionFunction + // Ererbt von ReflectionFunctionAbstract final private __clone() public string getName() public bool isInternal() @@ -763,6 +807,7 @@ public array getINIEntries() public ReflectionClass[] getClasses() public array getClassNames() + public string info() } ?> ]]> @@ -827,7 +872,7 @@ */ class My_Reflection_Method extends ReflectionMethod { - public $visibility = ''; + public $visibility = array(); public function __construct($o, $m) {