cvs: phpdoc-de /reference/sockets book.xml errors.xml examples.xml functions.xml setup.xml

From: Date: Wed, 26 Dec 2007 23:22:15 +0000
Subject: cvs: phpdoc-de /reference/sockets book.xml errors.xml examples.xml functions.xml setup.xml
Groups: php.doc.de 
Request: Send a blank email to doc-de+get-2336@lists.php.net to get a copy of this message
conni Wed Dec 26 23:22:15 2007 UTC Added files: /phpdoc-de/reference/sockets book.xml errors.xml examples.xml setup.xml Modified files: /phpdoc-de/reference/sockets functions.xml Log: adding files to repository

http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/functions.xml?r1=1.2&r2=1.3&diff_format=u Index: phpdoc-de/reference/sockets/functions.xml diff -u /dev/null phpdoc-de/reference/sockets/functions.xml:1.3 --- /dev/null Wed Dec 26 23:22:15 2007 +++ phpdoc-de/reference/sockets/functions.xml Wed Dec 26 23:22:15 2007 @@ -0,0 +1,25 @@ +&reference.sockets.functions.socket-accept; +&reference.sockets.functions.socket-bind; +&reference.sockets.functions.socket-clear-error; +&reference.sockets.functions.socket-close; +&reference.sockets.functions.socket-connect; +&reference.sockets.functions.socket-create-listen; +&reference.sockets.functions.socket-create-pair; +&reference.sockets.functions.socket-create; +&reference.sockets.functions.socket-get-option; +&reference.sockets.functions.socket-getpeername; +&reference.sockets.functions.socket-getsockname; +&reference.sockets.functions.socket-last-error; +&reference.sockets.functions.socket-listen; +&reference.sockets.functions.socket-read; +&reference.sockets.functions.socket-recv; +&reference.sockets.functions.socket-recvfrom; +&reference.sockets.functions.socket-select; +&reference.sockets.functions.socket-send; +&reference.sockets.functions.socket-sendto; +&reference.sockets.functions.socket-set-block; +&reference.sockets.functions.socket-set-nonblock; +&reference.sockets.functions.socket-set-option; +&reference.sockets.functions.socket-shutdown; +&reference.sockets.functions.socket-strerror; +&reference.sockets.functions.socket-write; http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/book.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/sockets/book.xml +++ phpdoc-de/reference/sockets/book.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> <!-- Purpose: remote.other --> <!-- Membership: bundled --> <book xml:id="book.sockets" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Sockets</title> <!-- {{{ preface --> <preface xml:id="intro.sockets"> &reftitle.intro; <para> Die Socket-Erweiterung stellt eine hardwarenahe Schnittstelle zu den Datenaustauschfunktionen über eine Socket-Verbindung zur Verfügung. Diese bauen auf den bekannten BSD Sockets auf, und bieten die Möglichkeit, entweder als Socket-Server oder als Client zu agieren. </para> <para> Allgemeinere clientseitige Socket-Schnittstelle bieten die Funktionen <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> Wem Socketprogrammierung fremd ist, der findet eine grosse Menge nützlicher Materialien in den entsprechenden Unix-manpages und es gibt jede Menge Tutorials und Informationen über Socketprogrammierung mit C im Internet. Vieles davon kann mit leichten Änderungen für die Socketprogrammierung mit PHP verwendet werden. Die <link xlink:href="&url.socket.faq;">UNIX Socket FAQ</link> ist dafür ein guter Startpunkt. </para> <note> <para> &pecl.moved-ver;5.3.0. </para> </note> </preface> <!-- }}} --> &reference.sockets.setup; &reference.sockets.constants; &reference.sockets.examples; &reference.sockets.errors; &reference.sockets.reference; </book> <!-- 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:"../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/errors.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/sockets/errors.xml +++ phpdoc-de/reference/sockets/errors.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> <chapter xml:id="sockets.errors" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <title>Socket Errors</title> <para> Die Socket-Erweiterung wurde geschrieben, um eine brauchbare Schnittstelle zu den mächtigen BSD-Sockets 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. Manchmal geschieht dies nicht so, wie sich Entwickler das wünschen. Zum Beispiel kann die Funktion <function>socket_read</function> plötzlich eine <constant>E_WARNING</constant>-Meldung ausgeben, weil die Verbindung unerwartet beendet wurde. Üblicherweise 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. Nähere Informationen finden Sie bei diesen beiden Funktionen. </para> <note> <para> Die <constant>E_WARNING</constant>-Meldungen, die von der Socket-Erweiterung generiert werden, sind in Englisch, aber die Meldungen, die Sie extra abfragen können, erscheinen in der 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> </chapter> <!-- 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:"../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/examples.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/sockets/examples.xml +++ phpdoc-de/reference/sockets/examples.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> <chapter xml:id="sockets.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &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, SOL_TCP)) === false) { echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror(socket_last_error()) . "\n"; } if (socket_bind($sock, $address, $port) === false) { echo "socket_bind() fehlgeschlagen: Grund: " . socket_strerror(socket_last_error($sock)) . "\n"; } if (socket_listen($sock, 5) === false) { echo "socket_listen() fehlgeschlagen: Grund: " . ocket_strerror(socket_last_error($sock)) . "\n"; } do { if (($msgsock = socket_accept($sock)) === false) { echo "socket_accept() fehlgeschlagen: Grund: " . socket_strerror(socket_last_error($sock)) . "\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, PHP_NORMAL_READ))) { echo "socket_read() fehlgeschlagen: Grund: " . socket_strerror(socket_last_error($msgsock)) . "\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 für eine einmalige Verbidung. Es wird eine Verbindung zu einer Seite geöffnet, ein HEAD-Request gesendet, die Antwort zurück übertragen und die Verbindung wieder geschlossen. </para> <programlisting role="php"> <![CDATA[ <?php error_reporting(E_ALL); echo "<h2>TCP/IP Verbindung</h2>\n"; /* Den Port für den WWW-Dienst ermitteln. */ $service_port = getservbyname('www', 'tcp'); /* Die IP-Adresse des Zielrechners ermitteln. */ $address = gethostbyname('www.example.com'); /* Einen TCP/IP Socket erzeugen. */ $socket = socket_create(AF_INET, SOCK_STREAM, SOL_TCP); if ($socket === false) { echo "socket_create() fehlgeschlagen: Grund: " . socket_strerror(socket_last_error()) . "\n"; } else { echo "OK.\n"; } echo "Versuche, zu '$address' auf Port '$service_port' zu verbinden ..."; $result = socket_connect($socket, $address, $service_port); if ($result === false) { echo "socket_connect() fehlgeschlagen.\nGrund: ($result) " . socket_strerror(socket_last_error($socket)) . "\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 "HTTP HEAD request senden ..."; socket_write($socket, $in, strlen($in)); echo "OK.\n"; echo "Serverantwort lesen:\n\n"; while ($out = socket_read($socket, 2048)) { echo $out; } echo "Socket schliessen ..."; socket_close($socket); echo "OK.\n\n"; ?> ]]> </programlisting> </example> </para> </chapter> <!-- 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:"../../../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 --> http://cvs.php.net/viewvc.cgi/phpdoc-de/reference/sockets/setup.xml?view=markup&rev=1.1 Index: phpdoc-de/reference/sockets/setup.xml +++ phpdoc-de/reference/sockets/setup.xml <?xml version="1.0" encoding="utf-8"?> <!-- $Revision: 1.1 $ --> <!-- EN-Revision: 1.2 Maintainer: conni Status: ready --> <chapter xml:id="sockets.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> &reftitle.setup; <!-- {{{ Requirements --> <section xml:id="sockets.requirements"> &reftitle.required; &no.requirement; </section> <!-- }}} --> <!-- {{{ Installation --> &reference.sockets.configure; <!-- }}} --> <!-- {{{ Configuration --> <section xml:id="sockets.configuration"> &reftitle.runtime; &no.config; </section> <!-- }}} --> <!-- {{{ Resources --> <section xml:id="sockets.resources"> &reftitle.resources; <para> <function>socket_accept</function>, <function>socket_create_listen</function> und <function>socket_create</function> geben Socket-Ressourcen zurück. </para> </section> <!-- }}} --> </chapter> <!-- 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:"../../../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 -->
« previous php.doc.de (#2336) next »