【PHP8.x】STREAM_CLIENT_PERSISTENT定数の使い方

STREAM_CLIENT_PERSISTENT定数は、PHPのネットワークストリーム関連関数で使用される定数であり、クライアントソケットの接続を永続的に維持すべきであることを指定するために利用されます。これは、主にstream_socket_client関数などの引数として渡すことで、確立される接続の振る舞いを制御する目的で使われます。

通常、PHPスクリプトが実行を終えると、そのスクリプト内で開かれた全てのネットワーク接続は自動的に閉じられ、関連するリソースも解放されます。しかし、このSTREAM_CLIENT_PERSISTENT定数を指定して接続を確立すると、スクリプトの実行が終了しても、その接続は閉じられずに開いたまま維持されます。これにより、同じPHPプロセス（例えば、PHP-FPMのワーカープロセスなど）内で後続のリクエストが来た際に、既存の永続接続を再利用することが可能になります。

接続を再利用する最大の利点は、ネットワーク接続を確立するためにかかる時間やCPUリソースのオーバーヘッドを削減できる点にあります。特に、データベースやキャッシュサーバー、メッセージキューなど、頻繁に接続を必要とする外部サービスへのアクセスにおいて、アプリケーションのパフォーマンスの大幅な向上に貢献します。ただし、永続接続はプロセス間で共有されるため、接続の状態管理には十分な注意が必要です。不適切に利用すると、予期せぬデータの混入やリソースのリークを引き起こす可能性もあるため、その特性を理解して適切に利用することが重要です。

Copy
1<?php
2$socket = stream_socket_client("tcp://localhost:80", $errno, $errstr, 30, STREAM_CLIENT_CONNECT | STREAM_CLIENT_PERSISTENT);
3?>

引数なし

引数はありません

戻り値なし

戻り値はありません