socket_connect
(PHP 4 >= 4.1.0, PHP 5, PHP 7)
socket_connect — ソケット上の接続を初期化する
説明
socket_connect
( resource $socket
, string $address
[, int $port
= 0
] ) : bool
ソケットリソース socket
を用いて、
address
への接続を初期化します。
このリソースは、socket_create()
で作成した有効なソケットリソースである必要があります。
パラメータ
socket
address
- パラメータ
address
には、socket
の種類がAF_INET
の場合はドット区切り表記の IPv4 アドレス (例:127.0.0.1
)、 IPv6 サポートが有効でsocket
の種類がAF_INET6
の場合は IPv6 アドレス (例:::1
)、AF_UNIX
の場合は Unix ドメインソケットのパス名を指定します。 port
- パラメータ
port
はAF_INET
ソケット あるいはAF_INET6
に接続する場合にのみ必須となり、 接続するリモートホストのポートを指定します。
返り値
成功した場合に true
を、失敗した場合に false
を返します。 エラーコードは、
socket_last_error() により取得できます。
このコードを socket_strerror() に渡すことにより、
エラー内容を表すテキストを得ることができます。
注意:
ソケットが非ブロッキングモードの場合、この関数は
false
を返し、エラーOperation now in progress
を発生させます。
参考
- socket_bind() - ソケットに名前をバインドする
- socket_listen() - ソケット上で接続待ち(listen)する
- socket_create() - ソケット(通信時の終端)を作成する
- socket_last_error() - ソケットの直近のエラーを返す
- socket_strerror() - ソケットエラーの内容を文字列として返す