ソケット拡張モジュールは、一般的なBSDソケットに基づくソケット通信
に関する低レベルインターフェースを実装し、クライアントだけでなく、
ソケットサーバーとして動作させることが可能となります。
より一般的なクライアントサイドのソケットインターフェースについては、
stream_socket_client(),
stream_socket_server(),
fsockopen() および
pfsockopen()を参照下さい。
ここで説明するソケット関数を使用する場合、多くの関数は、C言語に同
じ名前の関数が存在しますが、しばしば定義が異なっていることに注意して下さい。
混乱を避けるには、説明をよく読んで下さい。
このようにソケットプログラミングと異なっている点はあります
が、それでも有用な多くのUNIX man ページを参照することができます。
Web上にC言語のソケットプログラミングのチュートリアル情報が存在し、
その多くは、若干の修正により、PHPにおけるソケットプログラミングに
適当することが可能です。
UNIX Socket FAQが、手始めと
して適しているでしょう。
警告 |
このモジュールは、
実験的なものです。これは、これらの関数の動作、関
数名は、このドキュメントに書かれて事項と同様に告知なく将来的なPHPのリ
リースで変更される可能性があります。注意を喚起するとともに、このモジュー
ルは使用者のリスクで使用して下さい。 |
これらの関数は、標準モジュールの一部として利用可能であり、常に使用できます。
ここに既述されたソケット関数はPHP拡張モジュールの一部であり、コン
パイル時にconfigureにオプション--enable-socketsを指定することにより使用
可能となります。
この拡張モジュールは設定ディレクティブを全く定義しません。
この拡張モジュールはリソース型を全く定義しません。
これらの定数は、この拡張モジュールで定義されており、
この拡張モジュールがPHP内部にコンパイルされているか実行時に動的にロー
ドされるかのどちらかの場合のみ使用可能です。
ソケット拡張モジュールは、強力なBSDソケットへの有用なインターフェ
イスを提供するために作成されました。
関数は、Win32およびUNIXの実装において等しく動作するように注意が払
われています。ソケット関数の多くは特定の条件で失敗し、エラーを記
述するE_WARNINGメッセージを出力します。
これは、時々開発者が望まない時に発生することがあります。例えば、
関数 socket_read() は突然
E_WARNING メッセージを出力する可能性がありま
す。これは、予測しない接続断が発生したためです。
@演算子により警告出力を抑制し、
socket_last_error()関数によりアプリケーション
内でエラーコードを取得することが一般に行われています。
エラーを記述する文字列を取得するためにこのエラーコードを指定して
socket_strerror()関数をコールすることが可能で
す。詳細は、この関数の説明を参照して下さい。
注意:
E_WARNINGメッセージは、ソケット拡張モジュー
ルにより英語で生成されますが、取得されるエラーメッセージは、カレ
ントのロケール(LC_MESSAGES)に依存します。
Warning - socket_bind() unable to bind address [98]: Die Adresse wird bereits verwendet
|
例 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"; ?>
|
|