トップページ　→関数リファレンス　→その他のサービス　→ネットワーク　→ネットワーク関数

関数・クラス解説

fsockopen

version:PHP 4, PHP 5, PHP 7 (公式)

インターネット接続もしくは Unix ドメインソケット接続をオープンする

公式リファレンス

書式

fsockopen ( string $hostname [, int $port = -1 [, int &$errno [, string &$errstr [, float $timeout = ini_get("default_socket_timeout") ]]]] ) : resource

説明

hostname で指定したリソースへのソケット接続を開始します。

サポートされるソケットトランスポートのリストに記述されているように、PHP は Internet ドメインまたは Unix ドメインをサポートします。サポートされるトランスポートのリストは、stream_get_transports() を使って取得することもできます。

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

stream_socket_client() 関数もこれと似ていますがより豊富なオプションを持っており、非ブロック接続をしたりストリームコンテキストを提供したりする機能があります。

パラメータ

hostname: OpenSSL サポートがインストールされている場合、 hostname の前に ssl:// または tls:// を付加することにより、TCP/IP 経由でリモートホストに接続する際に SSL または TLS クライアント接続を使用することができます。
port: ポート番号。 unix:// のようにポートを使わないトランスポートの場合は、 -1 で無視してスキップさせることができます。
errno: 指定した場合は、システムコール connect() で発生したエラーのエラー番号が格納されます。 errno は 0 なのに関数が FALSE を返す場合、connect() をコールする前にエラーを発生したことを示します。この場合、おそらくはソケットの初期化に原因があります。
errstr: エラーメッセージを表す文字列。
timeout: 接続タイムアウト秒数。
注意: ソケット経由でデータを読み書きする際のタイムアウトを設定する必要がある場合、 fsockopen() の timeout パラメータは、ソケットに接続する間にだけ適用されるため、 socket_set_timeout() を使用してください。

返値

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

エラー

hostname が有効なドメインでない場合は E_WARNING をスローします。

注意

注意: 環境によっては Unix ドメインまたはオプションの接続タイムアウトが利用できないこともあります。

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

注意: 数値で IPv6 アドレスを指定するときは、(例 fe80::1) アドレスを角カッコでくくらなくてはなりません。たとえば、tcp://[fe80::1]:80.

サンプル

例1 fsockopen() の例 

$fp = fsockopen("www.example.com", 80, $errno, $errstr, 30);
if (!$fp) {
    echo "$errstr ($errno)\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);
}

 例2 UDP 接続の使用法
  以下の例は、自分のマシンの UDP サービス "daytime" (ポート13) から日付と時間を取得する方法を示すものです。  

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

参考

pfsockopen() - 持続的な Internet または Unix ドメインソケット接続をオープンする

stream_socket_client() - インターネットドメインまたは Unix ドメインのソケット接続を開く

stream_set_blocking() - ストリームのブロックモードを有効にする / 解除する

stream_set_timeout() - ストリームにタイムアウトを設定する

fgets() - ファイルポインタから 1 行取得する

fgetss() - ファイルポインタから 1 行取り出し、HTML タグを取り除く

fwrite() - バイナリセーフなファイル書き込み処理

fclose() - オープンされたファイルポインタをクローズする

feof() - ファイルポインタがファイル終端に達しているかどうか調べる

socket_connect() - ソケット上の接続を初期化する

Curl 拡張モジュール

ワード検索

※入力キーワードが、関数名・説明文・タグに含まれるものを検索

関数名アルファベット別

A	B	C	D	E	F	G	H	I	J
K	L	M	N	O	P	Q	R	S	T
U	V	W	X	Y	Z	_

最終更新一覧

●stristr
　大文字小文字を区別せず文字列を検索し、ヒット箇所以降（あるいは以前）の文字列を返却

●stripslashes
　バックスラッシュでエスケープされた文字列から、バックスラッシュを取り除く

●stripos
　大文字小文字を区別せずに文字列が最初に現れる位置を取得する

●stripcslashes
　addcslashes() でクォートされた文字列をアンクォートする

●strip_tags
　文字列から HTML と PHP のタグを除去して返却

●strcspn
　指定した文字が最初に現れる位置を調べる

●strcoll
　ロケールに基づいて2つの文字列を比較し同じか（あるいは大小）を判定する

●strcmp
　2つの文字列を比較し同じか（あるいは大小）を判定する

●strchr
　strstr() のエイリアス

●strcasecmp
　2つの文字列を比較（大文字小文字を区別せず同じとみなす）

カテゴリー一覧

PHP の振る舞いの変更
 音声フォーマットの操作
 認証サービス
 コマンドライン関連
 圧縮およびアーカイブ
 暗号
 データベース関連
 日付および時刻関連
 ファイルシステム
 自然言語および文字エンコーディング
 画像処理および作成
 メール関連
 数学
 テキスト以外の MIME 型
 プロセス制御
 その他の基本モジュール
 その他のサービス
 検索エンジン用の拡張モジュール
 サーバー固有のモジュール
 セッション関連
 テキスト処理
 変数・データ型関連
 ウェブサービス
 Windows 用のモジュール
 XML 操作
 GUI用の拡張モジュール