stream_socket_client
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...
stream_socket_enable_crypto
(PHP 5 >= 5.1.0)
stream_socket_enable_crypto — Turns encryption on/off on an already connected socket
Description
mixed stream_socket_enable_crypto
( resource
$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.
Parameters
-
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_CLIENTSTREAM_CRYPTO_METHOD_SSLv3_CLIENTSTREAM_CRYPTO_METHOD_SSLv23_CLIENTSTREAM_CRYPTO_METHOD_TLS_CLIENTSTREAM_CRYPTO_METHOD_SSLv2_SERVERSTREAM_CRYPTO_METHOD_SSLv3_SERVERSTREAM_CRYPTO_METHOD_SSLv23_SERVERSTREAM_CRYPTO_METHOD_TLS_SERVER
-
session_stream -
Seed the stream with settings from
session_stream.
Return Values
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).
Examples
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)");
}
/* 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);
?>
The above example will output something similar to:
add a note
User Contributed Notes
stream_socket_enable_crypto - [2 notes]
mark at kinoko dot fr ¶
5 years ago
tigger (AT) tiggerswelt d0t net ¶
6 years ago
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 ;-)