stream_socket_enable_crypto
(PHP 5 >= 5.1.0, PHP 7)
stream_socket_enable_crypto — 接続済みのソケットについて暗号化の on/off を切り替える
説明
stream_socket_enable_crypto
( resource $stream
, bool $enable
[, int $crypto_type
[, resource $session_stream
]] ) : mixed
ストリームの暗号化を有効あるいは無効にします。
暗号化設定が確立されると、それ以降は
enable パラメータに true あるいは false
を指定することで暗号化の on/off を動的に切り替えられます。
パラメータ
streamストリームリソース。
enableストリームの暗号化を有効にするか無効にするか。
crypto_typeストリームの暗号化の設定。以下の方法が使用できます。
STREAM_CRYPTO_METHOD_SSLv2_CLIENTSTREAM_CRYPTO_METHOD_SSLv3_CLIENTSTREAM_CRYPTO_METHOD_SSLv23_CLIENTSTREAM_CRYPTO_METHOD_ANY_CLIENTSTREAM_CRYPTO_METHOD_TLS_CLIENTSTREAM_CRYPTO_METHOD_TLSv1_0_CLIENTSTREAM_CRYPTO_METHOD_TLSv1_1_CLIENTSTREAM_CRYPTO_METHOD_TLSv1_2_CLIENTSTREAM_CRYPTO_METHOD_SSLv2_SERVERSTREAM_CRYPTO_METHOD_SSLv3_SERVERSTREAM_CRYPTO_METHOD_SSLv23_SERVERSTREAM_CRYPTO_METHOD_ANY_SERVERSTREAM_CRYPTO_METHOD_TLS_SERVERSTREAM_CRYPTO_METHOD_TLSv1_0_SERVERSTREAM_CRYPTO_METHOD_TLSv1_1_SERVERSTREAM_CRYPTO_METHOD_TLSv1_2_SERVER
省略した場合は、ストリームの SSL コンテキストのオプション
crypto_methodを利用します。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 god\r\n");fwrite($fp, "PASS secret\r\n");/* それ以外では暗号化を無効にします */stream_socket_enable_crypto($fp, false);while ($motd = fgets($fp)) { echo $motd;}fclose($fp);?>
上の例の出力は、 たとえば以下のようになります。
