PHP Stream_socket_client() 函数 - 易学教程，面试笔记经验！

PHP stream_socket_client() 函数打开 Internet 或 Unix 域套接字连接。

该函数启动一个到remote_socket指定的目标的流或数据报连接。创建的套接字类型由使用标准 URL 格式指定的传输确定:transport://target。对于 Internet 域套接字 (AF_INET)（例如 TCP 和 UDP），remote_socket 参数的目标部分应包含主机名或 IP 地址，后跟冒号和端口号。对于 Unix 域套接字，目标部分应指向文件系统上的套接字文件。

默认情况下，套接字以阻塞模式打开。可以使用 stream_set_blocking() 切换到非阻塞模式。

语法

stream_socket_client(remote_socket, errno, errstr, 
                     timeout, flags, context)

参数

`remote_socket`	`必填。` 指定要连接的套接字的地址。
`errno`	`可选。` 如果连接失败，将设置为系统级错误号。
`errstr`	`可选。` 如果连接失败，将设置为系统级错误消息。
timeout	`可选。` 指定连接超时（以秒为单位）。当为 null 时，使用 php.ini 设置的 default_socket_timeout。
`flags`	`可选。` 指定位掩码字段，可以设置为连接标志的任意组合。它可以是以下内容: STREAM_CLIENT_CONNECT（默认） STREAM_CLIENT_ASYNC_CONNECT STREAM_CLIENT_PERSISTENT
`context`	`可选。` 指定使用 stream_context_create() 函数创建的上下文资源。

返回值

返回一个文件指针，可以与其他文件函数一起使用，例如fgets(), fgetss(), fwrite()、fclose() 和 feof()，或失败时为 false。

异常

失败时 errno 和 errstr 参数将填充系统级 connect() 调用中发生的实际系统级错误。如果errno中返回的值为0并且函数返回false，则表明在connect()调用之前发生了错误。这很可能是由于初始化套接字时出现问题造成的。请注意，errno 和 errstr 参数始终通过引用传递。

示例:stream_socket_client() 示例

下面的示例显示了stream_socket_client()函数的用法。

<?php
$fp = stream_socket_client("tcp://www.example.com:80", $errno, $errstr, 20);
if (!$fp) {
  echo "$errstr ($errno)<br>\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);
}
?>

上述代码的输出将类似于:

HTTP/1.1 200 OK
Age: 256541
Cache-Control: max-age=604800
Content-Type: text/html; charset=UTF-8
Date: Mon, 08 Nov 2021 06:35:57 GMT
Etag: "3147526947+gzip+ident"
Expires: Mon, 15 Nov 2021 06:35:57 GMT
Last-Modified: Thu, 17 Oct 2019 07:18:26 GMT
Server: ECS (dna/63A8)
Vary: Accept-Encoding
X-Cache: HIT
Content-Length: 1256
Connection: close

<!doctype html>
<html>
<head>
    <title>Example Domain</title>

    <meta charset="utf-8" />
    <meta http-equiv="Content-type" content="text/html; charset=utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1" />
    <style type="text/css">
    body {
        background-color: #f0f0f2;
        margin: 0;
        padding: 0;
        font-family: -apple-system, system-ui, BlinkMacSystemFont, "Segoe UI", 
                     "Open Sans", "Helvetica Neue", Helvetica, Arial, sans-serif;
        
    }
    div {
        width: 600px;
        margin: 5em auto;
        padding: 2em;
        background-color: #fdfdff;
        border-radius: 0.5em;
        box-shadow: 2px 3px 7px 2px rgba(0,0,0,0.02);
    }
    a:link, a:visited {
        color: #38488f;
        text-decoration: none;
    }
    @media (max-width: 700px) {
        div {
            margin: 0 auto;
            width: auto;
        }
    }
    </style>    
</head>

<body>
<div>
    <h1>Example Domain</h1>
    <p>This domain is for use in illustrative examples in documents. You may use this
    domain in literature without prior coordination or asking for permission.</p>
    <p><a href="https://www.iana.org/domains/example">More Informations...</a></p>
</div>
</body>
</html>

示例:使用 UDP 连接

在下面的示例中，stream_socket_client() 函数用于 UDP 连接。

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

注意:指定数字 IPv6 地址时（例如fe80::1)，IP 必须括在方括号中，例如 - tcp://[fe80::1]:80。