stream_socket_enable_crypto

Turns encryption on/off on an already connected socket (PHP 5 >= 5.1.0)
mixed stream_socket_enable_crypto ( resource stream, bool enable [, int crypto_type [, resource session_stream]] )

When called with the crypto_type parameter, stream_socket_enable_crypto() will setup encryption on the stream using the specified method.

Valid values for crypto_type

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

Once the crypto settings are established, cryptography can be turned on and off dynamically by passing TRUE or FALSE in the enable parameter.

If this stream should be seeded with settings from an already established crypto enabled stream, pass that stream's resource variable in the fourth parameter.

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).

Example 2387. stream_socket_enable_crypto() Example

copy to clipboard

<?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);
?>

OpenSSL, and Appendix Q, List of Supported Socket Transports

Code Examples / Notes » stream_socket_enable_crypto

mark

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...

tigger

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 ;-)

stream_socket_enable_crypto

Turns encryption on/off on an already connected socket (PHP 5 >= 5.1.0) mixed stream_socket_enable_crypto ( resource stream, bool enable [, int crypto_type [, resource session_stream]] )

Example 2387. stream_socket_enable_crypto() Example

Code Examples / Notes » stream_socket_enable_crypto

Change Language

Turns encryption on/off on an already connected socket (PHP 5 >= 5.1.0)
mixed stream_socket_enable_crypto ( resource stream, bool enable [, int crypto_type [, resource session_stream]] )