PHPのcurl_init関数の使い方と基本操作について解説

2025-02-19更新日: 2025-02-19

PHPのcurl_init関数は、cURLセッションを初期化するために利用します。

これにより、HTTPリクエストなどの外部通信を行う準備が整い、API連携やWebページの取得など、さまざまなネットワーク処理が可能になります。

この記事では、基本的な使い方や注意点について分かりやすく解説します。

目次から探す

基本構文と返り値の確認
- curl_initの書式
- 異常時の挙動
セッション初期化と設定
- cURLセッションの開始方法
- 開発環境での留意点
オプション設定とリクエスト実行
- 主要オプションの設定方法
- リクエスト実行のプロセス
エラー処理とリソース解放
- エラー検出の方法
- セッションの終了処理
まとめ

基本構文と返り値の確認

curl_initの書式

関数シグネチャと返り値の種類

curl_initは、URLを引数にしてcURLセッションを初期化する関数です。

正常に初期化できた場合にはリソースが返され、失敗するとfalseが返されます。

以下は基本的な使用例です。

<?php
// cURLセッションの初期化サンプル
$url = 'https://example.com';
$curlResource = curl_init($url);  // 指定したURLでセッションを開始
if ($curlResource !== false) {
    echo "cURL session successfully initialized.";
} else {
    echo "Failed to initialize cURL session.";
}
?>

cURL session successfully initialized.

異常時の挙動

初期化失敗時のエラー対応

初期化時に不正な引数や環境の問題でエラーが発生する場合、curl_initはfalseを返します。

この返り値を利用して、エラー発生時の処理を行うことができます。

次のサンプルは、意図的なエラーを発生させた上でのチェック例です。

<?php
// 不正な引数により初期化失敗を意図したサンプル
$curlResource = curl_init(false);
if ($curlResource === false) {
    echo "Error: Failed to initialize cURL session.";
} else {
    echo "cURL session initialized.";
}
?>

Error: Failed to initialize cURL session.

セッション初期化と設定

cURLセッションの開始方法

初期化リソースの取得

cURLセッションはcurl_init関数で開始され、URLを指定することでセッションに必要なリソースが得られます。

下記の例では、指定URLが存在する場合にセッションが正常に開始される様子を示しています。

<?php
// cURLセッション開始の基本例
$url = 'https://example-api.com/resource';
$ch = curl_init($url);
if ($ch) {
    echo "cURLセッションが開始されました。";
} else {
    echo "cURLセッションの開始に失敗しました。";
}
?>

cURLセッションが開始されました。

セッション設定の基本ポイント

取得したcURLリソースは、curl_setoptを使用して各種オプションを設定することができます。

代表的なオプションとして、レスポンスを文字列で返す設定や、接続タイムアウトの設定、ユーザーエージェントの指定があります。

簡単な例をご覧ください。

<?php
$url = 'https://example-api.com/resource';
$ch = curl_init($url);
// レスポンスを文字列で取得
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 接続タイムアウトを10秒に設定
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 10);
// ユーザーエージェントを設定
curl_setopt($ch, CURLOPT_USERAGENT, 'PHP-cURL-Example');
// リクエスト実行
$response = curl_exec($ch);
if ($response !== false) {
    echo "リクエスト成功。";
} else {
    echo "リクエストに失敗。";
}
// セッション終了
curl_close($ch);
?>

リクエスト成功。

開発環境での留意点

PHP環境における設定確認

開発環境では、使用しているPHPがcURLライブラリを正しく有効にしていることを確認する必要があります。

phpinfo()を利用すると、cURLがロードされているかどうか確認できるので便利です。

以下のコードは、設定を確認するためのサンプルです。

<?php
// phpinfo() を実行してcURLの設定を確認する
phpinfo();
?>

(phpinfo()の画面情報が出力され、cURLセクションが存在します)

オプション設定とリクエスト実行

主要オプションの設定方法

接続タイムアウトやヘッダーの設定

接続タイムアウトやヘッダーの設定は、CURLOPT_TIMEOUTやCURLOPT_HTTPHEADERオプションを使用して行います。

以下に接続タイムアウトの設定と、ヘッダーに必要な情報を追加する例を示します。

<?php
$url = 'https://api.example.com/data';
$ch = curl_init($url);
// 全体のタイムアウトを30秒に設定
curl_setopt($ch, CURLOPT_TIMEOUT, 30);
// ヘッダーの設定例
$headers = [
    'Content-Type: application/json',
    'Authorization: Bearer yourToken'
];
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
// リクエスト実行
$response = curl_exec($ch);
if ($response !== false) {
    echo "オプション設定成功。";
} else {
    echo "オプション設定エラー。";
}
curl_close($ch);
?>

オプション設定成功。

SSL/TLSオプションの調整

安全な通信を行うためには、SSL/TLSに関するオプションの設定が重要です。

CURLOPT_SSL_VERIFYPEERとCURLOPT_SSL_VERIFYHOSTを適切に設定することで、サーバー証明書の検証を行います。

以下のサンプルコードでは、これらの設定を明示しています。

<?php
$url = 'https://secure.example.com';
$ch = curl_init($url);
// SSL証明書の検証を有効にする
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 2);
// リクエスト実行
$response = curl_exec($ch);
if ($response !== false) {
    echo "SSL/TLS設定が有効です。";
} else {
    echo "SSL/TLS設定に問題があります。";
}
curl_close($ch);
?>

SSL/TLS設定が有効です。

リクエスト実行のプロセス

curl_execとの連携

curl_exec関数を呼び出すことで、設定したオプションに基づくリクエストが実行されます。

レスポンスは、事前にCURLOPT_RETURNTRANSFERをtrueに設定している場合、文字列として返ってきます。

以下のサンプルはその実例です。

<?php
$url = 'https://api.example.com/data';
$ch = curl_init($url);
// レスポンスを文字列で受け取るように設定
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// リクエストを実行しレスポンスを取得
$response = curl_exec($ch);
if ($response) {
    echo "レスポンス取得成功:" . $response;
} else {
    echo "リクエスト失敗。";
}
curl_close($ch);
?>

レスポンス取得成功:{JSON形式またはHTML形式のレスポンス}

レスポンス取得の流れ

リクエスト実行後に返されたレスポンスは、用途に応じて解析が可能です。

例えば、JSON形式のレスポンスであればjson_decodeを利用して連想配列に変換することが一般的です。

<?php
$url = 'https://jsonplaceholder.typicode.com/posts/1';
$ch = curl_init($url);
// レスポンスを文字列として取得
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// リクエスト実行とレスポンス取得
$response = curl_exec($ch);
if ($response !== false) {
    // JSONレスポンスを連想配列に変換
    $data = json_decode($response, true);
    print_r($data);
} else {
    echo "レスポンス取得に失敗。";
}
curl_close($ch);
?>

Array
(
    [userId] => 1
    [id] => 1
    [title] => sunt aut facere repellat provident occaecati excepturi optio reprehenderit
    [body] => quia et suscipit...
)

エラー処理とリソース解放

エラー検出の方法

curl_errorによる確認

リクエスト実行中のエラー情報は、curl_error関数で取得が可能です。

これにより、エラーメッセージを確認して問題箇所を特定できます。

以下はエラー内容を確認するためのコード例です。

<?php
$url = 'https://nonexistent.example.com';
$ch = curl_init($url);
// レスポンスを取得する設定
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 意図的にタイムアウトを短く設定し、失敗を誘発
curl_setopt($ch, CURLOPT_TIMEOUT, 1);
$response = curl_exec($ch);
if ($response === false) {
    $errorMessage = curl_error($ch);
    echo "cURLエラー: " . $errorMessage;
} else {
    echo "レスポンス取得成功。";
}
curl_close($ch);
?>

cURLエラー: Operation timed out after 1000 milliseconds with 0 out of 0 bytes received

エラーコードの活用

エラー発生時は、curl_errno関数でエラー番号を取得することも有用です。

エラー番号を活用することで、エラーの種類をプログラム内で分岐させることが可能です。

<?php
$url = 'https://nonexistent.example.com';
$ch = curl_init($url);
// レスポンス取得用の設定
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// タイムアウト短縮で失敗を誘発
curl_setopt($ch, CURLOPT_TIMEOUT, 1);
$response = curl_exec($ch);
if ($response === false) {
    $errorNumber = curl_errno($ch);
    echo "cURLエラー番号: " . $errorNumber;
} else {
    echo "レスポンス取得成功。";
}
curl_close($ch);
?>

cURLエラー番号: 28

セッションの終了処理

curl_closeによるリソース解放

cURLセッションが完了した後は、curl_closeを使用してリソースを解放する必要があります。

これにより、メモリリークを回避できます。

以下は、その基本的な例です。

<?php
$url = 'https://api.example.com/data';
$ch = curl_init($url);
// レスポンス取得の設定と実行
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
// リソースの解放
curl_close($ch);
echo "cURLセッションを終了しました。";
?>

cURLセッションを終了しました。

終了後のリソース管理方法

セッション終了後、cURLリソースは無効となります。

以降の処理で再利用することはできないため、変数の管理に注意が必要です。

以下の例では、セッション終了後に変数を参照しようとしないように示しています。

<?php
$url = 'https://api.example.com/data';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
// $chはここではもはや利用できません
echo "リソース解放後。";
?>