Включает или отключает шифрование на уже подключённом сокете

# stream_socket_enable_crypto

(PHP 5 >= 5.1.0, PHP 7, PHP 8)

stream_socket_enable_crypto — Включает или отключает шифрование на уже подключённом сокете

### Описание

function stream_socket_enable_crypto(
resource `$stream`,
bool `$enable`,
?int `$crypto_method` = `null`,
?resource `$session_stream` = `null`
): int|bool

Включает или отключает шифрование на потоке.

После настройки шифрования, криптография может быть включена или выключена динамически при помощи передачи значения `true` или `false` параметру `enable`.

### Список параметров

`stream`

  Потоковый ресурс.

`enable`

  Включить/отключить криптографию на потоке.

`crypto_method`

  Включить шифрование на потоке. Допустимые методы

  - `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_TLSv1_3_CLIENT` (начиная с PHP 7.4.0)
  - `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`
  - `STREAM_CRYPTO_METHOD_TLSv1_3_SERVER` (начиная с PHP 7.4.0)

  Если не указан, то будет использован параметр `crypto_method` из SSL контекста потока.

`session_stream`

  Использовать в потоке настройки из `session_stream`.

### Возвращаемые значения

Возвращает `true` в случае успешного выполнения, `false`, если не удалось установить шифрование или `0`, если недостаточно данных и вы должны попытаться ещё раз (только для неблокирующих сокетов).

### Список изменений

Версия | Описание
--- | ---
8.0.0 | `session_stream` теперь допускает значение null.

### Примеры

Пример #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);
    ?>

Вывод приведённого примера будет похож на:

### Смотрите также

- Функции OpenSSL
- Список транспортов для работы с сокетами

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open