fsockopen

PHP マニュアル
前のページ		次のページ

説明

resource fsockopen ( string target [, int port [, int &errno [, string &errstr [, float timeout]]]] )

targetに指定されたリソースへのソケット接続を初期化します。 PHPは付録Qに記述されているように Internetドメインまたは Unixドメインの中のターゲットをサポートします。サポートされるトランスポートのリストは、stream_get_transports() を使って取得することもできます。

注意: ソケット経由でデータを読み書きする際のタイムアウトを設定する必要がある場合、 fsockopen() の timeout パラメータは、ソケットに接続する間にだけ適用されるため、 socket_set_timeout()を使用してください。

PHP 4.3.0以降、OpenSSLサポートを有効にしてコンパイルした場合、 hostnameの前に'ssl://' または 'tls://' を付加することにより、TCP/IP経由でリモートホストに接続する際にSSLまたはTLSクライアント接続を使用することができます。

fsockopen()は、ファイルポインタを返します。このファイルポインタは、 (fgets(),fgetss(), fputs(), fclose(), feof()のような) 他のファイル関数で使用可能です。

コールに失敗した場合にはFALSEが返され、オプションの引数 errnoおよびerrstr が指定されている場合、システムコールconnect() で生じた実際のシステムレベルエラーを示すように設定されます。 errnoは0なのに関数が FALSEを返す場合、connect() をコールする前にエラーを発生したことを示します。この場合、おそらくはソケットの初期化に原因があります。引数 errno および errstr は常に参照渡しであることに注意してください。

環境によってはUNIXドメインまたはオプションの接続タイムアウトは利用できません。

ソケットはデフォルトでブロックモードで開かれます。 socket_set_blocking()を使用して、非ブロックモードに切換えることができます。

例 1. fsockopen()の例


<?php
$fp = fsockopen("www.example.com", 80, $errno, $errstr, 30);
if (!$fp) {
    echo "$errstr ($errno)<br />\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サービス "daytime" (ポート13)から日付と時間を取得する方法を示すものです。

例 2. UDP接続の使用法


<?php
$fp = fsockopen("udp://127.0.0.1", 13, $errno, $errstr);
if (!$fp) {
    echo "ERROR: $errno - $errstr<br />\n";
} else {
    fwrite($fp, "\n");
    echo fread($fp, 26);
    fclose($fp);
}
?>

警告

UDPソケットは、リモートホストとの接続が確立されていない場合でも、エラーを発生せずにオープンされたように見えることが時々あります。このエラーは、そのソケットでデータを読み書きした際にのみ明らかになります。この原因は、UDPが"コネクションレス"のプロトコルであり、実際にデータを送受信する必要が生じるまで、オペレーションシステムがソケット用のリンクを確立しようとしないためです。

注意: timeout は PHP 3.0.9 でサポートされました。また、UDP のサポートは PHP 4で追加されました。

pfsockopen(), socket_set_blocking(), socket_set_timeout(), fgets(), fgetss(), fputs(), fclose(), feof(), Curl拡張モジュールも参照ください。

前のページ	ホーム	次のページ
dns_get_record	上に戻る	gethostbyaddr