cvs: phpdoc-de /reference/sockets constants.xml reference.xml
| From: | Cornelia Boenigk | Date: | Wed, 26 Dec 2007 23:18:28 +0000 |
| Subject: | cvs: phpdoc-de /reference/sockets constants.xml reference.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-2334@lists.php.net to get a copy of this message | ||
conni Wed Dec 26 23:18:28 2007 UTC
Modified files:
/phpdoc-de/reference/sockets constants.xml reference.xml
Log:
sync to en
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/constants.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/sockets/constants.xml diff -u phpdoc-de/reference/sockets/constants.xml:1.2 phpdoc-de/reference/sockets/constants.xml:1.3 --- phpdoc-de/reference/sockets/constants.xml:1.2 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/constants.xml Wed Dec 26 23:18:28 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.4 Maintainer: conni Status: ready --> -<section xml:id="sockets.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<appendix xml:id="sockets.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -137,6 +137,29 @@ </simpara> </listitem> </varlistentry> + </varlistentry> + <varlistentry> + <term> + <constant>MSG_EOR</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>MSG_EOF</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> <varlistentry> <term> <constant>SO_DEBUG</constant> @@ -358,7 +381,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/reference.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/sockets/reference.xml diff -u phpdoc-de/reference/sockets/reference.xml:1.9 phpdoc-de/reference/sockets/reference.xml:1.10 --- phpdoc-de/reference/sockets/reference.xml:1.9 Mon Dec 10 17:09:04 2007 +++ phpdoc-de/reference/sockets/reference.xml Wed Dec 26 23:18:28 2007 @@ -1,250 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.21 Maintainer: conni Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.28 Maintainer: conni Status: ready --> <!-- Purpose: remote.other --> <!-- Membership: bundled --> <reference xml:id="ref.sockets" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Socket Funktionen</title> - <titleabbrev>Sockets</titleabbrev> - - <partintro> - - <section xml:id="sockets.intro"> - &reftitle.intro; - <para> - Die Socket-Erweiterung stellt eine hardwarenahe Schnittstelle - zu den Datenaustauschfunktionen über eine Socket-Verbindung zur - Verfügung, die auf den bekannten BSD Sockets aufbaut, und bietet - die Möglichkeit, entweder als Socket-Server oder als Client zu - agieren. - </para> - <para> - Für eine allgemeinere clientseitige Socket Schnittstelle siehe <function>stream_socket_client</function>, <function>stream_socket_server</function>, - <function>fsockopen</function> und <function>pfsockopen</function>. - </para> - <para> - Wenn man diese Funktionen benutzt, darf man nicht vergessen, - dass, obwohl viele der Funktionen gleichlautende Namen wie ihre - Entsprechungen in C haben, sie dennoch oft unterschiedliche - Deklarationen haben. Bitte lesen Sie die Beschreibungen, um - Verwirrung zu vermeiden. - </para> - <para> - Das heisst, wem Socketprogrammierung fremd ist, der findet eine - grosse Menge nützlicher Materialien in den entsprechenden Unix - manpages und es gibt jede Menge von Tutorials und Informationen - über Socketprogrammierung in C im Internet. Vieles davon kann mit - leichten Änderungen für die Socketprogrammierung mit PHP benutzt - werden. Die <link xlink:href="&url.socket.faq;">UNIX Socket FAQ</link> ist - dafür ein guter Anfang. - </para> - </section> - - <section xml:id="sockets.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.sockets.configure; - - <section xml:id="sockets.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="sockets.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.sockets.constants; - - <section xml:id="sockets.errors"> - <title>Socket Fehler</title> - <para> - Die Socket-Erweiterung wurde geschrieben, um eine nützliche - Schnittstelle zu den mächtigen BSD-Funktionen zur Verfügung zu - stellen. Es wurde darauf geachtet, dass die Funktionen sowohl - unter Win32 als auch unter Unix-Implementierungen arbeiten. Fast - alle Socket-Funktionen können unter bestimmten Umständen - fehlschlagen und deshalb eine <constant>E_WARNING</constant>- - Meldung ausgeben, die den aufgetretenen Fehler beschreibt. Dies - ist manchmal nicht wünschenswert für den Entwickler. Zum Beispiel - kann die Funktion <function>socket_read</function> plötzlich eine - <constant>E_WARNING</constant>-Meldung ausgeben, weil die - Verbindung unerwartet beendet wurde. Normalerweise werden solche - Meldungen mit dem <literal>@</literal>-Operator unterdrückt und - der Fehlercode innerhalb der Anwendung mit der Funktion - <function>socket_last_error</function> aufgefangen. Sie können - auch die Funktion <function>socket_strerror</function> mit diesem - Fehlercode aufrufen, um eine Fehlerbeschreibung zu erhalten. - zu erhalten. Nähere Informationen finden Sie bei diesen beiden - Funktionen. - </para> - <note> - <para> - Die <constant>E_WARNING</constant>-Meldungen, die von der - Socket-Extension generiert werden, sind auf Englisch, aber die - Meldungen, die Sie extra abfragen können, erscheinen in der - entsprechenden Sprache, die Sie eingestellt haben - (<constant>LC_MESSAGES</constant>): - <programlisting role="php"> -<![CDATA[ -Warning - socket_bind() unable to bind address [98]: Die Adresse wird bereits verwendet -]]> - </programlisting> - </para> - </note> - </section> - - <section xml:id="sockets.examples"> - &reftitle.examples; - <para> - <example> - <title>Socket Beispiel: Einfacher TCP/IP Server</title> - <para> - Dieses Beispiel zeigt einen einfachen Echo-Server. Passen Sie - die Variablen <varname>address</varname> und - <varname>port</varname> an Ihre Systemumgebung an und führen - Sie das Skript aus. Dann können Sie sich mit einem Befehl wie: - <command>telnet 192.168.1.53 10000</command> (bei dem adress - und port an Ihre Umgebung angepasst ist) mit dem Server - verbinden. Alles, was Sie eingeben, wird an den Server geschickt - und von diesem wieder an Sie zurückgegeben. Um die Verbindung - zu trennen, geben sie 'quit' ein. - </para> - <programlisting role="php"> -<![CDATA[ -#!/usr/local/bin/php -q -<?php -error_reporting (E_ALL); - -/* Das Skript wartet auf hereinkommende Verbindungsanforderungen. */ -set_time_limit (0); - -/* Die implizite Ausgabe wird eingeschaltet, so dass man sieht, was gesendet wurde. */ -ob_implicit_flush (); - -$address = '192.168.1.53'; -$port = 10000; - -if (($sock = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) { - echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror ($sock) . "\n"; -} - -if (($ret = socket_bind ($sock, $address, $port)) < 0) { - echo "socket_bind() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; -} - -if (($ret = socket_listen ($sock, 5)) < 0) { - echo "socket_listen() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; -} - -do { - if (($msgsock = socket_accept($sock)) < 0) { - echo "socket_accept() fehlgeschlagen: Grund: " . socket_strerror ($msgsock) . "\n"; - break; - } - /* Anweisungen senden. */ - $msg = "\nWillkommen auf dem PHP Testserver. \n" . - "Um zu beenden, geben Sie 'quit' ein. Um den Server herunterzufahren, geben Sie 'shutdown' ein.\n"; - socket_write($msgsock, $msg, strlen($msg)); - - do { - if (FALSE === ($buf = socket_read ($msgsock, 2048))) { - echo "socket_read() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; - break 2; - } - if (!$buf = trim ($buf)) { - continue; - } - if ($buf == 'quit') { - break; - } - if ($buf == 'shutdown') { - socket_close ($msgsock); - break 2; - } - $talkback = "PHP: Sie haben '$buf' eingegeben.\n"; - socket_write ($msgsock, $talkback, strlen ($talkback)); - echo "$buf\n"; - } while (true); - socket_close ($msgsock); -} while (true); - -socket_close ($sock); -?> -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Socket Beispiel: Einfacher TCP/IP Client</title> - <para> - Dieses Beispiel zeigt einen einfachen HTTP-Client, der einen - einzelnen Request absetzen kann. Er verbindet sich mit einer - Seite, setzt einen HEAD-Request ab, gibt die Antwort zurück und - wird beendet. - </para> - <programlisting> -<![CDATA[ -<?php -error_reporting (E_ALL); - -echo "<h2>TCP/IP Verbindung</h2>\n"; - -/* Den Port des WWW-Dienstes holen. */ -$service_port = getservbyname ('www', 'tcp'); - -/* Die IP-Adresse des Zielhosts holen. */ -$address = gethostbyname ('www.example.com'); - -/* einen TCP/IP Socket erzeugen. */ -$socket = socket_create (AF_INET, SOCK_STREAM, SOL_TCP); -if ($socket < 0) { - echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror ($socket) . "\n"; -} else { - echo "OK.\n"; -} - -echo "Versuche, eine Verbindung zu '$address' auf Port '$service_port' aufzubauen ..."; -$result = socket_connect ($socket, $address, $service_port); -if ($result < 0) { - echo "socket_connect() fehlgeschlagen.\nGrund: ($result) " . socket_strerror($result) . "\n"; -} else { - echo "OK.\n"; -} - -$in = "HEAD / HTTP/1.1\r\n"; -$in .= "Host: www.example.com\r\n"; -$in .= "Connection: Close\r\n\r\n"; -$out = ''; - -echo "Einen HTTP HEAD Request senden ..."; -socket_write ($socket, $in, strlen ($in)); -echo "OK.\n"; - -echo "Die Antwort lesen:\n\n"; -while ($out = socket_read ($socket, 2048)) { - echo $out; -} - -echo "Den Socket schliessen ..."; -socket_close ($socket); -echo "OK.\n\n"; -?> -]]> - </programlisting> - </example> - </para> - </section> - </partintro> - -&reference.sockets.entities.functions; - + &reference.sockets.entities.functions; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml
http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/constants.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/sockets/constants.xml diff -u phpdoc-de/reference/sockets/constants.xml:1.2 phpdoc-de/reference/sockets/constants.xml:1.3 --- phpdoc-de/reference/sockets/constants.xml:1.2 Sat Jun 23 13:21:49 2007 +++ phpdoc-de/reference/sockets/constants.xml Wed Dec 26 23:18:28 2007 @@ -1,7 +1,7 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.2 $ --> -<!-- EN-Revision: 1.4 Maintainer: conni Status: ready --> -<section xml:id="sockets.constants" xmlns="http://docbook.org/ns/docbook"> +<!-- $Revision: 1.3 $ --> +<!-- EN-Revision: 1.8 Maintainer: conni Status: ready --> +<appendix xml:id="sockets.constants" xmlns="http://docbook.org/ns/docbook"> &reftitle.constants; &extension.constants; <variablelist> @@ -137,6 +137,29 @@ </simpara> </listitem> </varlistentry> + </varlistentry> + <varlistentry> + <term> + <constant>MSG_EOR</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> + <varlistentry> + <term> + <constant>MSG_EOF</constant> + (<type>integer</type>) + </term> + <listitem> + <simpara> + + </simpara> + </listitem> + </varlistentry> <varlistentry> <term> <constant>SO_DEBUG</constant> @@ -358,7 +381,7 @@ </listitem> </varlistentry> </variablelist> -</section> +</appendix> <!-- Keep this comment at the end of the file Local variables: http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/reference.xml?r1=1.9&r2=1.10&diff_format=u Index: phpdoc-de/reference/sockets/reference.xml diff -u phpdoc-de/reference/sockets/reference.xml:1.9 phpdoc-de/reference/sockets/reference.xml:1.10 --- phpdoc-de/reference/sockets/reference.xml:1.9 Mon Dec 10 17:09:04 2007 +++ phpdoc-de/reference/sockets/reference.xml Wed Dec 26 23:18:28 2007 @@ -1,250 +1,14 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.9 $ --> -<!-- EN-Revision: 1.21 Maintainer: conni Status: ready --> +<!-- $Revision: 1.10 $ --> +<!-- EN-Revision: 1.28 Maintainer: conni Status: ready --> <!-- Purpose: remote.other --> <!-- Membership: bundled --> <reference xml:id="ref.sockets" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Socket Funktionen</title> - <titleabbrev>Sockets</titleabbrev> - - <partintro> - - <section xml:id="sockets.intro"> - &reftitle.intro; - <para> - Die Socket-Erweiterung stellt eine hardwarenahe Schnittstelle - zu den Datenaustauschfunktionen über eine Socket-Verbindung zur - Verfügung, die auf den bekannten BSD Sockets aufbaut, und bietet - die Möglichkeit, entweder als Socket-Server oder als Client zu - agieren. - </para> - <para> - Für eine allgemeinere clientseitige Socket Schnittstelle siehe <function>stream_socket_client</function>, <function>stream_socket_server</function>, - <function>fsockopen</function> und <function>pfsockopen</function>. - </para> - <para> - Wenn man diese Funktionen benutzt, darf man nicht vergessen, - dass, obwohl viele der Funktionen gleichlautende Namen wie ihre - Entsprechungen in C haben, sie dennoch oft unterschiedliche - Deklarationen haben. Bitte lesen Sie die Beschreibungen, um - Verwirrung zu vermeiden. - </para> - <para> - Das heisst, wem Socketprogrammierung fremd ist, der findet eine - grosse Menge nützlicher Materialien in den entsprechenden Unix - manpages und es gibt jede Menge von Tutorials und Informationen - über Socketprogrammierung in C im Internet. Vieles davon kann mit - leichten Änderungen für die Socketprogrammierung mit PHP benutzt - werden. Die <link xlink:href="&url.socket.faq;">UNIX Socket FAQ</link> ist - dafür ein guter Anfang. - </para> - </section> - - <section xml:id="sockets.requirements"> - &reftitle.required; - &no.requirement; - </section> - - &reference.sockets.configure; - - <section xml:id="sockets.configuration"> - &reftitle.runtime; - &no.config; - </section> - - <section xml:id="sockets.resources"> - &reftitle.resources; - &no.resource; - </section> - - &reference.sockets.constants; - - <section xml:id="sockets.errors"> - <title>Socket Fehler</title> - <para> - Die Socket-Erweiterung wurde geschrieben, um eine nützliche - Schnittstelle zu den mächtigen BSD-Funktionen zur Verfügung zu - stellen. Es wurde darauf geachtet, dass die Funktionen sowohl - unter Win32 als auch unter Unix-Implementierungen arbeiten. Fast - alle Socket-Funktionen können unter bestimmten Umständen - fehlschlagen und deshalb eine <constant>E_WARNING</constant>- - Meldung ausgeben, die den aufgetretenen Fehler beschreibt. Dies - ist manchmal nicht wünschenswert für den Entwickler. Zum Beispiel - kann die Funktion <function>socket_read</function> plötzlich eine - <constant>E_WARNING</constant>-Meldung ausgeben, weil die - Verbindung unerwartet beendet wurde. Normalerweise werden solche - Meldungen mit dem <literal>@</literal>-Operator unterdrückt und - der Fehlercode innerhalb der Anwendung mit der Funktion - <function>socket_last_error</function> aufgefangen. Sie können - auch die Funktion <function>socket_strerror</function> mit diesem - Fehlercode aufrufen, um eine Fehlerbeschreibung zu erhalten. - zu erhalten. Nähere Informationen finden Sie bei diesen beiden - Funktionen. - </para> - <note> - <para> - Die <constant>E_WARNING</constant>-Meldungen, die von der - Socket-Extension generiert werden, sind auf Englisch, aber die - Meldungen, die Sie extra abfragen können, erscheinen in der - entsprechenden Sprache, die Sie eingestellt haben - (<constant>LC_MESSAGES</constant>): - <programlisting role="php"> -<![CDATA[ -Warning - socket_bind() unable to bind address [98]: Die Adresse wird bereits verwendet -]]> - </programlisting> - </para> - </note> - </section> - - <section xml:id="sockets.examples"> - &reftitle.examples; - <para> - <example> - <title>Socket Beispiel: Einfacher TCP/IP Server</title> - <para> - Dieses Beispiel zeigt einen einfachen Echo-Server. Passen Sie - die Variablen <varname>address</varname> und - <varname>port</varname> an Ihre Systemumgebung an und führen - Sie das Skript aus. Dann können Sie sich mit einem Befehl wie: - <command>telnet 192.168.1.53 10000</command> (bei dem adress - und port an Ihre Umgebung angepasst ist) mit dem Server - verbinden. Alles, was Sie eingeben, wird an den Server geschickt - und von diesem wieder an Sie zurückgegeben. Um die Verbindung - zu trennen, geben sie 'quit' ein. - </para> - <programlisting role="php"> -<![CDATA[ -#!/usr/local/bin/php -q -<?php -error_reporting (E_ALL); - -/* Das Skript wartet auf hereinkommende Verbindungsanforderungen. */ -set_time_limit (0); - -/* Die implizite Ausgabe wird eingeschaltet, so dass man sieht, was gesendet wurde. */ -ob_implicit_flush (); - -$address = '192.168.1.53'; -$port = 10000; - -if (($sock = socket_create (AF_INET, SOCK_STREAM, 0)) < 0) { - echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror ($sock) . "\n"; -} - -if (($ret = socket_bind ($sock, $address, $port)) < 0) { - echo "socket_bind() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; -} - -if (($ret = socket_listen ($sock, 5)) < 0) { - echo "socket_listen() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; -} - -do { - if (($msgsock = socket_accept($sock)) < 0) { - echo "socket_accept() fehlgeschlagen: Grund: " . socket_strerror ($msgsock) . "\n"; - break; - } - /* Anweisungen senden. */ - $msg = "\nWillkommen auf dem PHP Testserver. \n" . - "Um zu beenden, geben Sie 'quit' ein. Um den Server herunterzufahren, geben Sie 'shutdown' ein.\n"; - socket_write($msgsock, $msg, strlen($msg)); - - do { - if (FALSE === ($buf = socket_read ($msgsock, 2048))) { - echo "socket_read() fehlgeschlagen: Grund: " . socket_strerror ($ret) . "\n"; - break 2; - } - if (!$buf = trim ($buf)) { - continue; - } - if ($buf == 'quit') { - break; - } - if ($buf == 'shutdown') { - socket_close ($msgsock); - break 2; - } - $talkback = "PHP: Sie haben '$buf' eingegeben.\n"; - socket_write ($msgsock, $talkback, strlen ($talkback)); - echo "$buf\n"; - } while (true); - socket_close ($msgsock); -} while (true); - -socket_close ($sock); -?> -]]> - </programlisting> - </example> - </para> - <para> - <example> - <title>Socket Beispiel: Einfacher TCP/IP Client</title> - <para> - Dieses Beispiel zeigt einen einfachen HTTP-Client, der einen - einzelnen Request absetzen kann. Er verbindet sich mit einer - Seite, setzt einen HEAD-Request ab, gibt die Antwort zurück und - wird beendet. - </para> - <programlisting> -<![CDATA[ -<?php -error_reporting (E_ALL); - -echo "<h2>TCP/IP Verbindung</h2>\n"; - -/* Den Port des WWW-Dienstes holen. */ -$service_port = getservbyname ('www', 'tcp'); - -/* Die IP-Adresse des Zielhosts holen. */ -$address = gethostbyname ('www.example.com'); - -/* einen TCP/IP Socket erzeugen. */ -$socket = socket_create (AF_INET, SOCK_STREAM, SOL_TCP); -if ($socket < 0) { - echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror ($socket) . "\n"; -} else { - echo "OK.\n"; -} - -echo "Versuche, eine Verbindung zu '$address' auf Port '$service_port' aufzubauen ..."; -$result = socket_connect ($socket, $address, $service_port); -if ($result < 0) { - echo "socket_connect() fehlgeschlagen.\nGrund: ($result) " . socket_strerror($result) . "\n"; -} else { - echo "OK.\n"; -} - -$in = "HEAD / HTTP/1.1\r\n"; -$in .= "Host: www.example.com\r\n"; -$in .= "Connection: Close\r\n\r\n"; -$out = ''; - -echo "Einen HTTP HEAD Request senden ..."; -socket_write ($socket, $in, strlen ($in)); -echo "OK.\n"; - -echo "Die Antwort lesen:\n\n"; -while ($out = socket_read ($socket, 2048)) { - echo $out; -} - -echo "Den Socket schliessen ..."; -socket_close ($socket); -echo "OK.\n\n"; -?> -]]> - </programlisting> - </example> - </para> - </section> - </partintro> - -&reference.sockets.entities.functions; - + &reference.sockets.entities.functions; </reference> + <!-- Keep this comment at the end of the file Local variables: mode: sgml