stream_socket_enable_crypto
(PHP 5 >= 5.1.0, PHP 7, PHP 8)
stream_socket_enable_crypto — Turns encryption on/off on an already connected socket
说明
resource
$stream,bool
$enable,?int
$crypto_method = null,?resource
$session_stream = null): int|bool
Enable or disable encryption on the stream.
Once the crypto settings are established, cryptography can be turned
on and off dynamically by passing true or false in the
enable parameter.
参数
stream
The stream resource.
enable
Enable/disable cryptography on the stream.
crypto_method
Setup encryption on the stream. Valid methods are
STREAM_CRYPTO_METHOD_TLSv1_3_CLIENT(as of PHP 7.4.0)STREAM_CRYPTO_METHOD_TLSv1_3_SERVER(as of PHP 7.4.0)
If omitted, the crypto_method context option on
the stream's SSL context will be used instead.
session_stream
Seed the stream with settings from session_stream.
返回值
Returns true on success, false if negotiation has failed or
0 if there isn't enough data and you should try again
(only for non-blocking sockets).
错误/异常
Throws a ValueError if enable is true,
crypto_method is omitted and the stream has no
crypto_method SSL context option.
更新日志
| 版本 | 说明 |
|---|---|
| 8.0.0 |
Now throws a ValueError if crypto_method is needed but
not given.
Previously, an E_WARNING was raised and false was returned.
|
| 8.0.0 |
session_stream is now nullable.
|
示例
示例 #1 stream_socket_enable_crypto() example
<?php
$fp = stream_socket_client("tcp://myproto.example.com:31337", $errno, $errstr, 30);
if (!$fp) {
die("Unable to connect: $errstr ($errno)");
}
/* Turn on encryption for login phase */
stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_SSLv23_CLIENT);
fwrite($fp, "USER god\r\n");
fwrite($fp, "PASS secret\r\n");
/* Turn off encryption for the rest */
stream_socket_enable_crypto($fp, false);
while ($motd = fgets($fp)) {
echo $motd;
}
fclose($fp);
?>以上示例的输出类似于:
来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。
