stream_socket_enable_crypto
(PHP 5 >= 5.1.0)
stream_socket_enable_crypto — Turns encryption on/off on an already connected socket
说明
$stream
, bool $enable
[, int $crypto_type
[, resource $session_stream
]] )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_type -
Setup encryption on the stream. Valid methods are
-
STREAM_CRYPTO_METHOD_SSLv2_CLIENT -
STREAM_CRYPTO_METHOD_SSLv3_CLIENT -
STREAM_CRYPTO_METHOD_SSLv23_CLIENT -
STREAM_CRYPTO_METHOD_TLS_CLIENT -
STREAM_CRYPTO_METHOD_SSLv2_SERVER -
STREAM_CRYPTO_METHOD_SSLv3_SERVER -
STREAM_CRYPTO_METHOD_SSLv23_SERVER -
STREAM_CRYPTO_METHOD_TLS_SERVER
If omitted, the
crypto_typecontext 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).
更新日志
| 版本 | 说明 |
|---|---|
| 5.6.0 |
The crypto_type is now optional.
|
范例
Example #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 )" );
}
stream_socket_enable_crypto ( $fp , true , STREAM_CRYPTO_METHOD_SSLv23_CLIENT );
fwrite ( $fp , "USER god\r\n" );
fwrite ( $fp , "PASS secret\r\n" );
stream_socket_enable_crypto ( $fp , false );
while ( $motd = fgets ( $fp )) {
echo $motd ;
}
fclose ( $fp );
?> 以上例程的输出类似于：
参见
- OpenSSL 函数
- 所支持的套接字传输器（Socket Transports）列表
用户评论:
[#1] bobe at webnaute dot net [2015-03-20 16:54:34]
There is an error in the description of the third argument:
"If omitted, the crypto_type context option on the stream's SSL context will be used instead."
The name of the context option is "crypto_method", NOT "crypto_type" which is just the name of the argument.
[#2] mark at kinoko dot fr [2007-11-06 11:00:10]
Just to avoid letting you search everywhere why your code doesn't work when using this function to enable crypto as a server, and when using TLS, you have to put the certificate in the "ssl" context, even if you start a TLS, SSLv3, etc.. server.
I had some troubles because of that...
[#3] tigger (AT) tiggerswelt d0t net [2007-05-30 03:15:55]
As already mentioned above:
stream_socket_enable_crypto is likely to fail/return zero if the socket is in non-blocking mode.
You may either wait some seconds until all neccessary data has arrived or switch temporary to blocking mode:
<?PHP
stream_set_blocking ($fd, true);
stream_socket_enable_crypto ($fd, true, STREAM_CRYPTO_METHOD_TLS_CLIENT);
stream_set_blocking ($fd, false);
?>
This works very fine for me ;-)