targetに指定されたリソースへのソケット接続を初期化します。 PHPは付録Oに記述されているように 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()を使用して、 非ブロックモードに切換えることができます。
警告 |
UDPソケットは、リモートホストとの接続が確立されていない場合でも、 エラーを発生せずにオープンされたように見えることが時々あります。 このエラーは、そのソケットでデータを読み書きした際にのみ明らかに なります。この原因は、UDPが"コネクションレス"のプロトコルであり、 実際にデータを送受信する必要が生じるまで、オペレーションシステムが ソケット用のリンクを確立しようとしないためです。 |
注意: timeout は PHP 3.0.9 でサポートされまし た。また、UDP のサポートは PHP 4で追加されました。