［PHP］curl_multi_close() 関数：並列処理の幕引きを美しく演出する

今回は、cURL マルチハンドリングの締めくくりを担う重要な関数、curl_multi_close() について詳しく解説していきます。

curl_multi_close() とは？
基本的な使い方
使用例
curl_multi_close() の重要性
プロのテクニック
注意点
まとめ

curl_multi_close() とは？

curl_multi_close() 関数は、cURL マルチハンドルセットを閉じ、関連するすべてのリソースを解放するための PHP 関数です。この関数は、並列処理の終了時に使用され、メモリリークを防ぐ重要な役割を果たします。

基本的な使い方

curl_multi_close() 関数の基本的な構文は以下の通りです：

void curl_multi_close ( resource $mh )

$mh: 閉じる cURL マルチハンドル

使用例

実際に curl_multi_close() を使用する例を見てみましょう：

// cURL マルチハンドルを初期化
$mh = curl_multi_init();

// いくつかの cURL ハンドルを追加
$ch1 = curl_init('https://api.example.com/data1');
$ch2 = curl_init('https://api.example.com/data2');
curl_multi_add_handle($mh, $ch1);
curl_multi_add_handle($mh, $ch2);

// マルチハンドルを実行
do {
    $status = curl_multi_exec($mh, $active);
} while ($status === CURLM_CALL_MULTI_PERFORM || $active);

// 結果を取得
foreach ([$ch1, $ch2] as $ch) {
    $result = curl_multi_getcontent($ch);
    echo "結果: " . $result . "\n";
    curl_multi_remove_handle($mh, $ch);
}

// マルチハンドルを閉じる
curl_multi_close($mh);

curl_multi_close() の重要性

リソース解放：使用したメモリやシステムリソースを適切に解放します。
メモリリーク防止：長時間実行されるスクリプトでの潜在的なメモリリークを防ぎます。
クリーンアップ：並列処理の終了を明示的に示し、コードの可読性を向上させます。

プロのテクニック

エラーハンドリングとの組み合わせ：

if ($mh !== false) {
    curl_multi_close($mh);
}

関数化：

function cleanupMultiHandle($mh, $handles) {
    foreach ($handles as $ch) {
        curl_multi_remove_handle($mh, $ch);
        curl_close($ch);
    }
    curl_multi_close($mh);
}

try-finally ブロックの使用：

$mh = curl_multi_init();
try {
    // マルチハンドル操作
} finally {
    curl_multi_close($mh);
}

注意点

個別のハンドル：curl_multi_close() は個別の cURL ハンドルを閉じないので、必要に応じて curl_close() を呼び出す必要があります。
再利用不可：一度閉じたマルチハンドルは再利用できません。新しい処理には新しいマルチハンドルを作成してください。
タイミング：すべての処理が完了し、結果を取得した後に呼び出すようにしましょう。