fsockopen
インターネット接続もしくは Unix ドメインソケット接続をオープンする
&reftitle.description;
resourcefalsefsockopen
stringhostname
intport-1
interror_code&null;
stringerror_message&null;
floatnulltimeout&null;
hostname で指定したリソースへのソケット接続を開始します。
に記述されているように、PHP は
Internet ドメインまたは Unix ドメインをサポートします。
サポートされるトランスポートのリストは、stream_get_transports
を使って取得することもできます。
ソケットはデフォルトでブロックモードで開かれます。
socket_set_blocking を使用して、
非ブロックモードに切換えることができます。
stream_socket_client 関数もこれと似ていますがより豊富なオプションを持っており、
非ブロック接続をしたりストリームコンテキストを提供したりする機能があります。
&reftitle.parameters;
hostname
OpenSSL サポートが インストール
されている場合、
hostname の前に ssl:// または
tls:// を付加することにより、TCP/IP
経由でリモートホストに接続する際に SSL または
TLS クライアント接続を使用することができます。
port
ポート番号。
unix:// のようにポートを使わないトランスポートの場合は、
-1 で無視してスキップさせることができます。
error_code
指定した場合は、システムコール connect()
で発生したエラーのエラー番号が格納されます。
error_code は 0 なのに関数が
&false; を返す場合、connect()
をコールする前にエラーを発生したことを示します。
この場合、おそらくはソケットの初期化に原因があります。
error_message
エラーメッセージを表す文字列。
timeout
接続タイムアウト秒数。
&null; の場合は、
&php.ini; の
default_socket_timeout
設定を使います。
ソケット経由でデータを読み書きする際のタイムアウトを設定する必要がある場合、
fsockopen の timeout パラメータは、
ソケットに接続する間にだけ適用されるため、
socket_set_timeout を使用してください。
&reftitle.returnvalues;
fsockopenは、ファイルポインタを返します。
このファイルポインタは、
(fgets, fgetss,
fputs, fclose,
feof のような)
他のファイル関数で使用可能です。
失敗した場合は &false; を返します。
&reftitle.errors;
hostname が有効なドメインでない場合は
E_WARNING をスローします。
&reftitle.changelog;
&Version;
&Description;
8.0.0
timeout は、nullable になりました。
&reftitle.examples;
fsockopen の例
\n";
} else {
$out = "GET / HTTP/1.1\r\n";
$out .= "Host: www.example.com\r\n";
$out .= "Connection: Close\r\n\r\n";
fwrite($fp, $out);
while (!feof($fp)) {
echo fgets($fp, 128);
}
fclose($fp);
}
?>
]]>
UDP 接続の使用法
以下の例は、自分のマシンの UDP サービス "daytime" (ポート13)
から日付と時間を取得する方法を示すものです。
\n";
} else {
fwrite($fp, "\n");
echo fread($fp, 26);
fclose($fp);
}
?>
]]>
&reftitle.notes;
環境によっては Unix ドメインまたは
オプションの接続タイムアウトが利用できないこともあります。
UDPソケットは、リモートホストとの接続が確立されていない場合でも、
エラーを発生せずにオープンされたように見えることが時々あります。
このエラーは、そのソケットでデータを読み書きした際にのみ明らかになります。
この原因は、UDPが"コネクションレス"のプロトコルであり、
実際にデータを送受信する必要が生じるまで、
オペレーションシステムがソケット用のリンクを確立しようとしないためです。
&ipv6.brackets;
&reftitle.seealso;
pfsockopen
stream_socket_client
stream_set_blocking
stream_set_timeout
fgets
fgetss
fwrite
fclose
feof
socket_connect
Curl 拡張モジュール