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の完成実装や実通信済みの例とは扱いません。
クライアント変更より先に記録すること
- どの送信先・メソッドで、通信が失敗したのかHTTP応答が返ったのかを区別する。
- redirectがある場合は最終応答を確認する。URLのトークン・Cookie・Authorization・生のbodyはログや質問へ出さない。
- 許可された読み取り要求だけ再試行を検討し、Retry-After、試行数、待機できる期限を決める。
- 旧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の内部動作を検証した例ではありません。
| この記事の要点 |
|
エラーの典型例
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を変更する対処は勧めません。
子ページはありません
- Error 400 : Bad Request Parameter Operation is missing
- MissingParameter. The request must contain the parameter Signature.
- RequestThrottled. AWS Access Key ID: ... . You are submitting requests too quickly
- 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.
- failed to open stream: HTTP request failed! HTTP/1.1 503 Service Unavailable
人気ページ
- 1 Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法
- 2 tomcat の起動 / 停止ログと catalina.log・catalina.out の違い
- 3 JavaScript で base URL を取得する方法|window.location.origin
- 4 YouTube Data API v3 エラー一覧|403・400・404 の原因と対処
- 5 Laravel エラー一覧|500/Blade/DB 接続/ルーティングの代表エラー
- 6 3Dグラフィックスのソフト一覧|Blender・Metasequoiaと用途別の選び方
- 7 Spring Frameworkのアノテーション一覧
- 8 【Spring】@Valueアノテーションとは
- 9 CATALINA_HOME の確認方法 (Linux / Mac)
- 10 【Spring】@Autowiredアノテーションとは
最近更新/作成されたページ
- Visual Studio「デザイナーを表示できません」エラーの原因と対処 2026-10-28 12:06:00
- SSH 認証に失敗しました。再試行してください の対処 2026-10-28 12:06:00
- SSH2 秘密鍵の読み込みに失敗しました の原因と対処 2026-10-28 12:06:00
- TeraTerm のよくあるエラーと対処法完全ガイド — Connection refused / 2026-10-28 12:06:00
- Visual Studio エラー一覧|コンパイルエラー・警告の確認方法と対処 2026-10-28 11:39:57
- Whitelabel Error Page の原因と消し方|Spring Boot のエラーページ 2026-10-28 11:39:57
- Eclipseで「サーバーに追加または除去できるリソースがありません。」の原因と対処法 2026-10-28 11:39:57
- SQL WHERE 句完全ガイド 2026-10-28 11:39:57
- SQL JOIN 完全ガイド (INNER/LEFT/RIGHT/FULL OUTER) 2026-10-28 11:39:57
- tomcat の起動 / 停止ログと catalina.log・catalina.out の違い 2026-10-28 10:24:23
- Tomcat の起動確認方法 5 つ|localhost:8080・ポート・プロセス・ログ 2026-10-28 10:24:23
- Oracle 19c COMMITの使い方: 暗黙コミット・自動確定・応答不明時の確認 2026-10-28 09:59:09
- Oracle 19c DELETE文|削除対象の確認・COMMIT前の判断・ROLLBACKの条件 2026-10-28 09:59:09
- Oracle 19c INSERT文|INSERT ALL・SELECT・RETURNINGとMERGEの使い分け 2026-10-28 09:59:09
- Oracle 19cのトランザクション制御|COMMIT・ROLLBACK・分離レベルと接続設定 2026-10-28 09:59:09