導入

ソケット拡張モジュールは、一般的な BSD ソケットに基づくソケット通信に 関する低レベルインターフェースを実装し、クライアントだけでなく、 ソケットサーバとして動作させることが可能となります。

より一般的なクライアントサイドのソケットインターフェースについては、 stream_socket_client()、 stream_socket_server()、 fsockopen() および pfsockopen() を参照ください。

ここで説明するソケット関数を使用する場合、多くの関数は、C 言語に同じ 名前の関数が存在しますが、しばしば定義が異なっていることに注意してください。 混乱を避けるには、説明をよく読んでください。

このようにソケットプログラミングと異なっている点はありますが、 それでも有用な多くの Unix man ページを参照することができます。 Web 上に C 言語のソケットプログラミングのチュートリアル情報が存在し、 その多くは、若干の修正により、PHP におけるソケットプログラミングに 適用することが可能です。 Unix Socket FAQ が、手始めと して適しているでしょう。

要件

外部ライブラリを必要としません。

インストール手順

ここに既述されたソケット関数は PHP 拡張モジュールの一部であり、 コンパイル時に configure にオプション --enable-sockets を指定することにより 使用可能となります。

実行時設定

設定ディレクティブは定義されていません。

リソース型

リソース型は定義されていません。

定義済み定数

以下の定数が定義されています。 この関数の拡張モジュールが PHP 組み込みでコンパイルされているか、 実行時に動的にロードされている場合のみ使用可能です。

ソケットのエラー

ソケット拡張モジュールは、強力な BSD ソケットへの有用なインターフェースを 提供するために作成されました。 関数は、Win32 および Unix の実装において等しく動作するように注意が 払われています。ソケット関数の多くは特定の条件で失敗し、エラーを記述する E_WARNING メッセージを出力します。 これは、時々開発者が望まない時に発生することがあります。例えば、 関数 socket_read() は突然 E_WARNING メッセージを出力する可能性があります。 これは、予測しない接続断が発生したためです。 @ 演算子により警告出力を抑制し、 socket_last_error() 関数によりアプリケーション内で エラーコードを取得することが一般に行われています。 エラーを記述する文字列を取得するためにこのエラーコードを指定して socket_strerror() 関数をコールすることが可能です。 詳細は、この関数の説明を参照してください。

例

例 1. ソケットの例: 簡易 TCP/IP サーバ この例は、簡単な応答サーバです。変数 address と port を設定と実行環境に合うように変更して ください。このサーバーに次のようなコマンドで接続することが可能です。 : telnet 192.168.1.53 10000 (ただし、アドレス とポートは設定に合わせます)入力したものは、サーバ側の出力となり、 エコーバックされます。接続を閉じるには、'quit' を入力します。 #!/usr/local/bin/php -q <?php error_reporting(E_ALL); /* Allow the script to hang around waiting for connections. */ set_time_limit(0); /* Turn on implicit output flushing so we see what we're getting * as it comes in. */ ob_implicit_flush(); $address = '192.168.1.53'; $port = 10000; if (($sock = socket_create(AF_INET, SOCK_STREAM, 0)) < 0) {     echo "socket_create() failed: reason: " . socket_strerror ($sock) . "\n"; } if (($ret = socket_bind($sock, $address, $port)) < 0) {     echo "socket_bind() failed: reason: " . socket_strerror ($ret) . "\n"; } if (($ret = socket_listen($sock, 5)) < 0) {     echo "socket_listen() failed: reason: " . socket_strerror($ret) . "\n"; } do {     if (($msgsock = socket_accept($sock)) < 0) {         echo "socket_accept() failed: reason: " . socket_strerror($msgsock) . "\n";         break;     }     /* Send instructions. */     $msg = "\nWelcome to the PHP Test Server. \n" .         "To quit, type 'quit'. To shut down the server type 'shutdown'.\n";     socket_write($msgsock, $msg, strlen($msg));     do {         if (FALSE === ($buf = socket_read($msgsock, 2048, PHP_NORMAL_READ))) {             echo "socket_read() failed: reason: " . 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: You said '$buf'.\n";         socket_write($msgsock, $talkback, strlen ($talkback));         echo "$buf\n";     } while (true);     socket_close($msgsock); } while (true); socket_close($sock); ?>

例 2. ソケットの例: 簡易 TCP/IP クライアント この例は、簡単な一回限りの HTTP クライアントです。ここでは、ある ページに接続し、HEAD リクエストを送信し、応答を出力た後、終了します。 <?php error_reporting(E_ALL); echo "<h2>TCP/IP Connection</h2>\n"; /* Get the port for the WWW service. */ $service_port = getservbyname('www', 'tcp'); /* Get the IP address for the target host. */ $address = gethostbyname('www.example.com'); /* Create a TCP/IP socket. */ $socket = socket_create(AF_INET, SOCK_STREAM, 0); if ($socket < 0) {     echo "socket_create() failed: reason: " . socket_strerror($socket) . "\n"; } else {     echo "OK.\n"; } echo "Attempting to connect to '$address' on port '$service_port'..."; $result = socket_connect($socket, $address, $service_port); if ($result < 0) {     echo "socket_connect() failed.\nReason: ($result) " . socket_strerror($result) . "\n"; } else {     echo "OK.\n"; } $in = "HEAD / HTTP/1.0\r\n"; $in .= "Host: www.example.com\r\n"; $in .= "Connection: Close\r\n\r\n"; $out = ''; echo "Sending HTTP HEAD request..."; socket_write($socket, $in, strlen ($in)); echo "OK.\n"; echo "Reading response:\n\n"; while ($out = socket_read($socket, 2048)) {     echo $out; } echo "Closing socket..."; socket_close($socket); echo "OK.\n\n"; ?>