stream_socket_enable_crypto
(PHP 5 >= 5.1.0, PHP 7)
stream_socket_enable_crypto — Включает или отключает шифрование на уже подключённом сокете
Описание
$stream
, bool $enable
, int $crypto_type
= ?
, resource $session_stream
= ?
) : mixedВключает или отключает шифрование на потоке.
После настройки шифрования, криптография может быть включена
или выключена динамически при помощи передачи значения true
или false
параметру enable
.
Список параметров
-
stream
-
Потоковый ресурс.
-
enable
-
Включить/отключить криптографию на потоке.
-
crypto_type
-
Включить шифрование на потоке. Допустимые методы
STREAM_CRYPTO_METHOD_SSLv2_CLIENT
STREAM_CRYPTO_METHOD_SSLv3_CLIENT
STREAM_CRYPTO_METHOD_SSLv23_CLIENT
STREAM_CRYPTO_METHOD_ANY_CLIENT
STREAM_CRYPTO_METHOD_TLS_CLIENT
STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT
STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT
STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT
STREAM_CRYPTO_METHOD_SSLv2_SERVER
STREAM_CRYPTO_METHOD_SSLv3_SERVER
STREAM_CRYPTO_METHOD_SSLv23_SERVER
STREAM_CRYPTO_METHOD_ANY_SERVER
STREAM_CRYPTO_METHOD_TLS_SERVER
STREAM_CRYPTO_METHOD_TLSv1_0_SERVER
STREAM_CRYPTO_METHOD_TLSv1_1_SERVER
STREAM_CRYPTO_METHOD_TLSv1_2_SERVER
Если не указан, то будет использован параметр
crypto_method
из SSL контекста потока. -
session_stream
-
Использовать в потоке настройки из
session_stream
.
Возвращаемые значения
Возвращает true
в случае успеха, false
, если не удалось установить шифрование
или 0
, если недостаточно данных и вы должны попытаться ещё раз
(только для неблокирующих сокетов).
Список изменений
Версия | Описание |
---|---|
5.6.0 |
Добавлены константы STREAM_CRYPTO_METHOD_ANY_CLIENT , STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT , STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT , STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT , STREAM_CRYPTO_METHOD_ANY_SERVER , STREAM_CRYPTO_METHOD_TLSv1_0_SERVER , STREAM_CRYPTO_METHOD_TLSv1_1_SERVER , STREAM_CRYPTO_METHOD_TLSv1_2_SERVER .
|
5.6.0 |
Параметр crypto_type теперь необязателен.
|
Примеры
Пример #1 Пример использования stream_socket_enable_crypto()
<?php
$fp = stream_socket_client("tcp://myproto.example.com:31337", $errno, $errstr, 30);
if (!$fp) {
die("Не могу соединиться: $errstr ($errno)");
}
/* Включить шифрование для этапа входа в систему */
stream_socket_enable_crypto($fp, true, STREAM_CRYPTO_METHOD_SSLv23_CLIENT);
fwrite($fp, "USER бог\r\n");
fwrite($fp, "PASS секрет\r\n");
/* Отключить шифрование для всего остального */
stream_socket_enable_crypto($fp, false);
while ($motd = fgets($fp)) {
echo $motd;
}
fclose($fp);
?>
Результатом выполнения данного примера будет что-то подобное: