socket_bind

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

socket_bind给套接字绑定名字

说明

socket_bind(Socket $socket, string $address, int $port = 0): bool

绑定 addresssocket。 该操作必须是在使用 socket_connect() 或者 socket_listen() 建立一个连接之前。

参数

socket

socket_create() 创建的 Socket 实例。

address

如果套接字是 AF_INET 族,那么 address 必须是一个四点分法的 IP 地址(例如 127.0.0.1 )。

如果套接字是 AF_UNIX 族,那么 address 是 Unix 套接字一部分(例如 /tmp/my.sock )。

port (可选)

参数 port 仅仅用于 AF_INET 套接字连接的时候,并且指定连接中需要监听的端口号。

返回值

成功时返回 true, 或者在失败时返回 false

错误代码会传入 socket_last_error() ,如果将此参数传入 socket_strerror() 则可以得到错误的文字说明。

更新日志

版本 说明
8.0.0 socket is a Socket instance now; previously, it was a resource.

范例

示例 #1 使用 socket_bind() 来设置套接字资源地址

<?php
// Create a new socket
$sock socket_create(AF_INETSOCK_STREAMSOL_TCP);

// An example list of IP addresses owned by the computer
$sourceips['kevin']    = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';

// Bind the source address
socket_bind($sock$sourceips['madcoder']);

// Connect to destination address
socket_connect($sock'127.0.0.1'80);

// Write
$request 'GET / HTTP/1.1' "\r\n" .
           
'Host: example.com' "\r\n\r\n";
socket_write($sock$request);

// Close
socket_close($sock);

?>

注释

注意:

该函数必须在 socket_connect() 之前使用。

注意:

Windows 9x/ME 兼容性注意点: 如果尝试绑定套接字资源到一个错误的地址,而这个地址不是本机的地址,那么 socket_last_error() 可能会返回一个无效的错误代码。

参见