【PHP8.x】curl_multi_close関数の使い方

curl_multi_close関数は、複数のcURLセッションを同時に管理するために作成された「マルチcURLハンドル」を閉じ、そのハンドルに関連付けられているすべてのリソースを解放する関数です。

ウェブサイトへの並行リクエストなど、複数のネットワーク通信を効率的に行う場合、まず curl_multi_init() 関数でマルチcURLハンドルを作成し、そこに個々のcURLハンドルを追加して処理を行います。すべてのネットワーク通信が完了し、マルチcURLハンドルが不要になった際には、この curl_multi_close() 関数を呼び出してハンドルを明示的に閉じる必要があります。

この関数は、引数として閉じたいマルチcURLハンドルのリソースを受け取ります。関数が成功した場合は true を、失敗した場合は false を返します。リソースを適切に解放することは、メモリリークを防ぎ、システムリソースを効率的に利用するために非常に重要です。そのため、curl_multi_init() で作成したマルチcURLハンドルは、処理が終わった後、必ず curl_multi_close() で閉じるようにしてください。これは、プログラミングにおける基本的なリソース管理の原則に基づいています。

<?php
/**
 * curl_multi_init() で作成されたマルチ cURL ハンドルを閉じます。
 *
 * @param resource $multi_handle curl_multi_init() が返す cURL マルチハンドル。
 * @return void
 */
function curl_multi_close(resource $multi_handle): void {}

// 使用例:
$mh = curl_multi_init();
// ... cURL マルチハンドルの操作 ...
curl_multi_close($mh);
?>

CurlMultiHandle $multi_handle

• CurlMultiHandle $multi_handle: クローズするマルチハンドルリソースを指定します。

void

curl_multi_close 関数は、curl_multi_init で初期化されたマルチハンドルリソースを解放します。戻り値はありません。