◀ 5.

PHP file_get_contentsの503対処|HTTP状態と再試行条件の確認

HTTP/1.1 503 Service Unavailableを含む警告は、PHPがHTTP応答の失敗を報告したものです。PHPの関数変更だけで相手や中間プロキシの503は直りません。旧PA-APIのエラー一覧内の資料ですが、このPHP警告自体は一般的なHTTP取得でも発生します。

要求不備や認証と再試行候補を分け、待機と試行数を制限する図

対象APIと提供状況を先に確認

2026年10月確認。PA-API 5も公式の廃止案内の対象です。旧キーの変更や再試行だけで利用を再開する案内ではありません。現在の連携はCreators APIの移行ガイドを確認し、専用資格情報とOAuth、要求/応答の変更を照合します。一般AWSサービスの署名/SDKと混用しないでください。

親のエラー一覧から他の個別症状を選択できます。以下の旧サンプルを現行APIの完成実装や実通信済みの例とは扱いません。

クライアント変更より先に記録すること

  1. どの送信先・メソッドで、通信が失敗したのかHTTP応答が返ったのかを区別する。
  2. redirectがある場合は最終応答を確認する。URLのトークン・Cookie・Authorization・生のbodyはログや質問へ出さない。
  3. 許可された読み取り要求だけ再試行を検討し、Retry-After、試行数、待機できる期限を決める。
  4. 旧PA-APIなら提供終了の案内を先に確認する。OAuthや署名を変更すれば一般的な503が必ず直るとは扱わない。

公式資料: Laravel HTTP client、旧レスポンスヘッダー変数の非推奨、http_get_last_response_headers。以下の関数はヘッダーを取得する実装ではなく、取得済み値の判断だけを検証する例です。

通信せず確認できる再試行の判断例

次はPHP 8系の学習用ポリシー関数です。HTTP通信・sleepは行わず、返す整数は待機秒数、nullは停止または後回しを意味します。0秒も有効なのでif ($delay)ではなく、$delay !== nullで判定します。この例はGET/HEADの429/503だけを候補とし、初回を含む最大3試行、待機は30秒以内に制限します。AWS SDKのすべてのエラー分類を置き換える関数ではありません。

<?php

// Policy only: no HTTP calls, sleep, credentials or framework configuration.
// null means stop/defer; an integer is a delay in seconds, including zero.
function retryDelay(string $method, int $status, ?string $retryAfter, int $attempt, int $now): ?int
{
    if (!in_array(strtoupper($method), ['GET', 'HEAD'], true)
        || !in_array($status, [429, 503], true) || $attempt < 1 || $attempt >= 3) {
        return null;
    }
    if ($retryAfter === null) {
        return random_int(1, 2 ** ($attempt - 1));
    }
    if (strlen($retryAfter) > 128 || preg_match('/[\x00-\x08\x0a-\x1f\x7f]/', $retryAfter)) {
        return null;
    }
    $value = trim($retryAfter, " \t");
    if (preg_match('/^[0-9]+$/D', $value)) {
        $digits = ltrim($value, '0');
        if (strlen($digits) > 2 || (int) $digits > 30) { return null; }
        return (int) $digits;
    }
    // This example accepts IMF-fixdate only. Other date forms are deferred.
    $date = DateTimeImmutable::createFromFormat('!D, d M Y H:i:s \G\M\T', $value, new DateTimeZone('UTC'));
    if (!$date || $date->format('D, d M Y H:i:s \G\M\T') !== $value) { return null; }
    $delay = max(0, $date->getTimestamp() - $now);

    return $delay <= 30 ? $delay : null;
}

Retry-Afterが30秒を超えたら30秒へ短縮して再送せず、停止/延期します。HTTP-dateはIMF-fixdateだけ受理し、旧形式の日付や不正値は安全側に停止します。ヘッダーなしの小さなジッターは説明用で、実運用には接続/応答タイムアウト・全体期限・キュー・SDK自身の再試行との調整が必要です。POST等はこの関数では再送しません。安全に再送できる更新操作はサービスの冪等性仕様を別途設計してください。

待機値の根拠: RFC 9110のRetry-After。外部APIへの実通信やSDKの内部動作を検証した例ではありません。

この記事の要点
  • 原因①: 対象サーバーが過負荷 / メンテで 本当に 503(一時的、時間を置く)
  • 原因②: CDN/プロキシ等の応答も確認。ただしUser-Agent未指定や特定ヘッダーだけでBot検出を原因と断定しない
  • 原因③: レート制限。同一 IP からの高頻度アクセスで一時的に 503
  • 対処: 通信失敗とHTTP失敗を分け、正式API/利用条件・応答状態・安全な再送可否を確認。UA偽装やクライアント変更だけで解消としない
  • 長期的には Guzzle / Http ファサードでリトライ・指数バックオフ・タイムアウトを統一管理

エラーの典型例

Warning: file_get_contents(https://example.com/api):
  failed to open stream: HTTP request failed!
  HTTP/1.1 503 Service Unavailable
in /var/www/html/fetch.php on line 12

file_get_contents() や fopen() で外部 URL を読もうとした際、HTTP ステータスが 503 で返ったときの警告です。「ストリームを開けなかった」と書かれていますが、原因はHTTP レイヤの 503 です。

原因の切り分け

原因判定方法主な対処
① 一時的なメンテ・過負荷ブラウザで開いてみる、curl コマンドで再現時間を置く、相手に問い合わせ
② Bot 検出(Cloudflare 等)CDNの経由情報やRequest IDは調査材料で、cf-rayだけではBot判定の証明ではない提供元の正式API/制限を確認しRequest ID等で問い合わせる
③ レート制限連続アクセス時のみ発生間隔を空ける、指数バックオフ
④ DNS 障害・SSL 問題エラー文言を確認DNS / 証明書を確認
⑤ 自サーバ側ファイアウォール同じ URL を別ホストから叩くと OK送信元 IP / IPS を確認

確認1: User-Agentと取得条件を確認する

HTTP wrapperのUser-Agentはコンテキストまたはphp.iniの設定によります。必ずPHP/8.xになるわけではなく、UAだけで503の原因を特定できません。公式HTTP contextを確認します。次の旧例は未実行の比較資料で、身元の偽装や保護の回避を勧めません。PHP8.5では$http_response_headerは非推奨です。最初のステータス行だけを見る旧処理はredirect時の最終状態も保証せず、生のbodyを例外として公開しないでください:

$context = stream_context_create([
    'http' => [
        'method'  => 'GET',
        'header'  => implode("\r\n", [
            'User-Agent: Mozilla/5.0 (compatible; MyBot/1.0; +https://example.com/bot)',
            'Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
            'Accept-Language: ja,en;q=0.9',
            'Referer: https://example.com/',
        ]),
        'timeout' => 10,
        'ignore_errors' => true,   // 4xx/5xx でも例外的に body を取りたい場合
    ],
    'ssl' => [
        'verify_peer'      => true,
        'verify_peer_name' => true,
    ],
]);

$body = @file_get_contents('https://example.com/api', false, $context);

// $http_response_header に HTTP ヘッダ一覧が入る
// 例: HTTP/1.1 503 Service Unavailable
if (isset($http_response_header[0])
    && preg_match('#\bHTTP/\S+ (\d+)#', $http_response_header[0], $m)
) {
    $status = (int) $m[1];
    if ($status >= 400) {
        throw new RuntimeException("HTTP $status: $body");
    }
}

選択肢2: cURLで通信失敗とHTTP状態を分ける

cURL等を使うと通信エラーとHTTP状態を別々に扱いやすくなりますが、切替自体が503を解消するわけではありません。下の旧例は未実行です。任意URLの無制限なredirectを許す完成実装ではなく、送信先の許可・認証情報の転送・SSRF・TLS等を別途設計してください:

function fetch(string $url): string
{
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 15,
        CURLOPT_CONNECTTIMEOUT => 5,
        CURLOPT_FOLLOWLOCATION => true,
        CURLOPT_USERAGENT      => 'Mozilla/5.0 MyBot/1.0',
        CURLOPT_HTTPHEADER     => [
            'Accept: text/html,*/*;q=0.8',
            'Accept-Language: ja,en;q=0.9',
        ],
    ]);
    $body = curl_exec($ch);
    if ($body === false) {
        $err = curl_error($ch);
        curl_close($ch);
        throw new RuntimeException("cURL: $err");
    }
    $status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    if ($status >= 400) {
        throw new RuntimeException("HTTP $status returned");
    }
    return $body;
}

対処3: リトライ + 指数バックオフ

503は一時的な場合もありますが、待てば必ず成功するわけではありません。下は旧文字列一致による再送例で、正式な状態/エラーコード・操作の冪等性・Retry-After・全体期限を網羅しません。SDK等の自動再送との二重化も避けます:

function fetchWithRetry(string $url, int $maxRetry = 4): string
{
    $attempt = 0;
    while (true) {
        $attempt++;
        try {
            return fetch($url);
        } catch (RuntimeException $e) {
            if (strpos($e->getMessage(), 'HTTP 503') === false
             && strpos($e->getMessage(), 'HTTP 429') === false) {
                throw $e;  // 503 / 429 以外はリトライしない
            }
            if ($attempt >= $maxRetry) throw $e;
            $sleep = min(2 ** ($attempt - 1), 30);  // 1, 2, 4, 8, ... 最大 30 秒
            error_log("HTTP 503: retry in {$sleep}s (attempt $attempt)");
            sleep($sleep);
        }
    }
}

対処4: Retry-After ヘッダを尊重する

Retry-Afterは省略される場合もあり、値は秒数またはHTTP-dateです。下の旧断片は整数しか読まず、通信失敗も確認せず、min($wait,60)で待機を短縮するためそのまま使わないでください。 長い待機を短縮して早く再送するのではなく、止める/後回しにする判断が必要です:

$ch = curl_init($url);
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HEADER         => true,
]);
$response = curl_exec($ch);
$status = (int) curl_getinfo($ch, CURLINFO_HTTP_CODE);
$hSize  = curl_getinfo($ch, CURLINFO_HEADER_SIZE);
$rawH   = substr($response, 0, $hSize);
$body   = substr($response, $hSize);
curl_close($ch);

if ($status === 503 || $status === 429) {
    if (preg_match('/^Retry-After:\s*(\d+)/mi', $rawH, $m)) {
        $wait = (int) $m[1];
        sleep(min($wait, 60));
        // 再試行
    }
}

対処5: allow_url_fopen が無効化されている可能性

共有レンタルサーバや一部の本番環境では allow_url_fopen = Off になっています。この場合 file_get_contents 自体が URL を開けず、別エラーになります:

ini_get('allow_url_fopen');   // "1" なら有効

// 確認用 PHP コマンド
// php -i | grep allow_url_fopen

無効なら実行環境と利用可能なHTTPクライアントを確認します。これはHTTP503とは別の条件です。設定を緩めることや「cURL一択」を通常の解決策とせず、管理者の運用方針に従ってください。

対処6: Laravel / Guzzle で書き直す

下の旧コード枠はLaravelとGuzzleの別々の例で、1ファイルへまとめて実行する完成例ではありません。Laravelのretry(3,1000)は初回込み最大3試行です。条件なしでは対象外のHTTP失敗も再送し得て、最終失敗は通常例外になります。Guzzle例もRetry-After・期限・部分失敗を網羅しません。採用するクライアントで一か所だけ再試行を管理してください。

// Laravel
use Illuminate\Support\Facades\Http;

$response = Http::withHeaders([
        'User-Agent' => 'MyApp/1.0',
    ])
    ->timeout(15)
    ->retry(3, 1000)   // 1 秒間隔で 3 回
    ->get('https://example.com/api');

if ($response->successful()) {
    $data = $response->json();
}

// Guzzle
use GuzzleHttp\Client;
use GuzzleHttp\HandlerStack;
use GuzzleHttp\Middleware;

$stack = HandlerStack::create();
$stack->push(Middleware::retry(
    function ($retries, $request, $response = null, $exception = null) {
        return $retries < 3 && $response && $response->getStatusCode() === 503;
    },
    function ($retries) {
        return 1000 * (2 ** $retries);   // 指数バックオフ (ms)
    }
));
$client = new Client(['handler' => $stack, 'timeout' => 15]);
$res = $client->get('https://example.com/api');

本当に「相手が落ちている」場合の見分け方

下の旧コメントの「別ホストも503なら相手障害」「自サーバだけならIPブロック」という二択は断定できません。DNS/経路/プロキシ/認証/配信先の違いも確認します。curl -vは秘密ヘッダーやURL等を出し得るので、生ログを公開しないでください。回線変更による制限回避を勧めるものではありません。

# ターミナルから直接 curl
curl -v -A "Mozilla/5.0" https://example.com/api

# ステータスだけ
curl -s -o /dev/null -w "%{http_code}\n" -A "Mozilla/5.0" https://example.com/api

# 別ホストから(自宅 / モバイル回線 / クラウド)でも 503 なら相手側障害
# 自サーバからだけ 503 なら IP ブロック / FW / Bot 検知

FAQ

Q: 警告だけ消したい
A: @で隠すだけでは失敗を扱えません。通信失敗と最終HTTP状態を確認し、生のエラー本文を公開せず安全な失敗表示にします。PHP8.5では$http_response_headerが非推奨で、PHP8.4以降のhttp_get_last_response_headers等の対応を確認します。

Q: Cloudflare の保護を突破できる?
A: 規約上の問題が出るため避けるべき。相手に API 連携を依頼するか、相手が提供する正規エンドポイントを使う。

Q: 503 が永続的に出続ける
A: IP制限だけでなく、相手/中間装置の障害・設定・経路等も調査します。時刻・正式なHTTP状態・安全に伏せたRequest IDを記録して提供元へ問い合わせ、アクセス制限を避けるためにIPを変更する対処は勧めません。

子ページ

子ページはありません

同階層のページ
  1. Error 400 : Bad Request Parameter Operation is missing
  2. MissingParameter. The request must contain the parameter Signature.
  3. RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
  4. SignatureDoesNotMatch. The request signature we calculated does not match the signature you provided. Check your AWS Secret Access Key and signing method. Consult the service documentation for details.
  5. failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable

最近更新/作成されたページ