【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() で閉じるようにしてください。これは、プログラミングにおける基本的なリソース管理の原則に基づいています。

Copy
1<?php
2/**
3 * curl_multi_init() で作成されたマルチ cURL ハンドルを閉じます。
4 *
5 * @param resource $multi_handle curl_multi_init() が返す cURL マルチハンドル。
6 * @return void
7 */
8function curl_multi_close(resource $multi_handle): void {}
9
10// 使用例:
11$mh = curl_multi_init();
12// ... cURL マルチハンドルの操作 ...
13curl_multi_close($mh);
14?>

CurlMultiHandle $multi_handle

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

void

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