socket_bind
(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)
socket_bind — 给套接字绑定名字
说明
绑定 address 到 socket。
该操作必须是在使用 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套接字连接的时候，并且指定连接中需要监听的端口号。
返回值
使用 socket_last_error() 检索错误代码，如果将此代码传入 socket_strerror() 则可以得到错误的文字说明。
示例
示例 #1 使用 socket_bind() 来设置源地址
<?php
// 创建新的套接字
$sock = socket_create(AF_INET, SOCK_STREAM, SOL_TCP);
// 计算机拥有的 IP 地址示例列表
$sourceips['kevin'] = '127.0.0.1';
$sourceips['madcoder'] = '127.0.0.2';
// 绑定源地址
socket_bind($sock, $sourceips['madcoder']);
// 连接到目标地址
socket_connect($sock, '127.0.0.1', 80);
// 写入
$request = 'GET / HTTP/1.1' . "\r\n" .
'Host: example.com' . "\r\n\r\n";
socket_write($sock, $request);
// 关闭
socket_close($sock);
?>注释
注意:
该函数必须在 socket_connect() 之前使用。
参见
- socket_connect() - 开启一个套接字连接
- socket_listen() - 监听套接字的连接
- socket_create() - 创建一个套接字（通讯节点）
- socket_last_error() - 返回套接字上的最后一个错误
- socket_strerror() - 返回描述套接字错误的字符串
＋添加备注
用户贡献的备注 6 notes
keksov[at]gmx.de ¶
22 years ago
If you want to reuse address and port, and get rid of error: unable to bind, address already in use, you have to use socket_setopt (check actual spelling for this function in you PHP verison) before calling bind:
<?php
if (!socket_set_option($sock, SOL_SOCKET, SO_REUSEADDR, 1)) {
echo socket_strerror(socket_last_error($sock));
exit;
}
?>
This solution was found by
Christophe Dirac. Thank you Christophe!
dresende at thinkdigital dot pt ¶
13 years ago
Regarding previous post:
"0" has address is no different from "0.0.0.0"
127.0.0.1 -> accept only from local host
w.x.y.z (valid local IP) -> accep only from this network
0.0.0.0 -> accept from anywhere
php50613160534 dot 3 dot korkman at spamgourmet dot org ¶
19 years ago
Use 0 for port to bind a random (free) port for incoming connections:
socket_bind ($socket, $bind_address, 0);
socket_getsockname($socket, $socket_address, $socket_port);
socket_listen($socket);
...
$socket_port contains the assigned port, you might want to send it to a remote client connecting. Tested with php 5.03.
ealexs at gmail dot com ¶
3 years ago
I am posting this as I've spent a few hours debugging this.
If you use socket_create / socket_bind with Unix domain sockets, then using socket_close at the end is not sufficient. You will get "address already in use" the second time you run your script. Call unlink on the file that is used for Unix domain sockets, preferably before you start to create the socket.
<?php
$socket_file = "./test.sock";
if (file_exists($socket_file))
unlink($socket_file);
# optional file lock
$socket = socket_create(AF_UNIX, SOCK_STREAM, 0);
# ... socket_set_option ...
socket_bind($socket, $socket_file);
# ...
socket_close($socket);
# optional : release lock
unlink($socket_file);
?>
gasket at cekkent dot net ¶
21 years ago
The aforementioned tidbit about using NULL to bind to all addresses did not work for me, as I would receive an error about unknown address. Using a 0 worked for me:
socket_bind ($socket, 0, $port)
This also allows you to receive UDP broadcasts, which is what I had been trying to figure out.
gabriel at plenitech dot fr ¶
11 years ago
When doing Unix sockets, it might be necessary to chmod the socket file so as to give Write permission to Group and/or Others. Otherwise, only the owner is allowed to write data into the stream.
Example:
<?php
$sockpath = '/tmp/my.sock';
socket_bind($socket, $sockpath);
//here: write-only (socket_send) to others, only owner can fetch data.
chmod($sockpath, 0702);
?>