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

CURLSHOPT_UNSHARE定数は、PHPのcURL拡張機能において、共有ハンドル（CURLSH）のリソース共有に関する設定を行う際に使用される定数です。cURLの共有ハンドルは、複数のcURLイージーハンドル（個別のリクエスト）間でクッキー、DNSキャッシュ、接続プールといった特定の情報を共有することで、ネットワーク通信の効率化を図るための仕組みです。これにより、例えば複数のHTTPリクエスト間で同じセッション情報を再利用したり、DNSの名前解決結果をキャッシュして高速化したりできます。

しかし、アプリケーションの設計によっては、特定のリソースを共有ハンドル間で共有したくない場合があります。例えば、異なるユーザーや異なる目的の処理を行う際に、クッキー情報やDNSキャッシュを独立させたいといったケースが考えられます。CURLSHOPT_UNSHARE定数は、このような場合に、共有ハンドルが持つべきではない特定のリソースの種類を明示的に指定するために利用されます。

この定数をcurl_share_setopt()関数と組み合わせて使用することで、共有プールから特定のタイプのリソースを「共有しない」設定にすることができます。具体的には、このオプションの引数として、共有したくないリソースの種類を示すビットマスク値（例えば、CURL_LOCK_DATA_COOKIEを指定すればクッキー、CURL_LOCK_DATA_DNSを指定すればDNSキャッシュ）を渡します。これにより、開発者はcURLの共有機能を柔軟に制御し、個々のリクエストが独立した動作を保証する必要がある場合に、データの意図しない共有を防ぎ、より堅牢なシステムを構築することが可能となります。

Copy
1<?php
2$sh = curl_share_init();
3curl_share_setopt($sh, CURLSHOPT_UNSHARE, CURL_LOCK_DATA_DNS);
4curl_share_close($sh);
5?>

引数なし

引数はありません

int

CURLSHOPT_UNSHARE定数は、共有ハンドルから特定の情報を削除する際に使用する整数値を表します。