Laravelに専用SDKは必要か？

不要である。組み込みHTTPクライアントがbearer token、クエリ、タイムアウト、JSONヘッダーを送信でき、APIは通常のJSONを返す。

何秒キャッシュするか？

60秒は約1分ごとに更新される活発なペアに合い、重複呼び出しを防ぐ。日次参照通貨ではdata_updated_atを確認する。

PHP floatで通貨換算できるか？

floatは2進浮動小数点であり表現誤差が生じうる。正確な計算には10進数または任意精度ライブラリを使い、最終表示額だけを丸める。

Freeキーの上限は？

カード不要で月10,000回、毎分12回である。共有読み取りをキャッシュし、ページ表示ごとの上流呼び出しを避ける。

Tutorial/PHP と Laravel

PHPとLaravelで為替レートを取得する

LaravelのHTTPクライアント、bearer認証、有限のタイムアウト、鮮度メタデータを使ってライブレートを取得・キャッシュする。

MMexchangerate.dev·Jul 17, 2026·6分で読了

小さなLaravelサービスでexchangerate.devを呼び出し、HTTPエラーを拒否し、完全なFX観測を60秒キャッシュできる。キーは設定に置き、レートとともにsource、market_session、data_updated_atを返す。

Key points

Laravel HTTPクライアントでbearer認証、タイムアウト、throw()を使う。

成功した完全な応答を60秒キャッシュする。

EXCHANGERATE_API_KEYからキーを読む。

正確な金額計算には10進数ライブラリを使う。

キャッシュ付きFXサービスを作る

このサービスはベースとソート済みシンボルから安定したキャッシュキーを作る。throw()がLaravelのキャッシュ書き込み前に実行されるため、失敗応答はレートとして保存されない。

php · app/Services/ExchangeRateService.phpcopy

<?php

namespace App\Services;

use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;

final class ExchangeRateService
{
    public function latest(string $base, array $symbols): array
    {
        sort($symbols);
        $symbolList = implode(',', $symbols);
        $cacheKey = "fx:latest:{$base}:{$symbolList}";

        return Cache::remember($cacheKey, now()->addSeconds(60), function () use (
            $base,
            $symbolList,
        ): array {
            return Http::acceptJson()
                ->withToken(config('services.exchangerate.key'))
                ->timeout(5)
                ->get(
                    "https://api.exchangerate.dev/v1/latest/{$base}",
                    ['symbols' => $symbolList],
                )
                ->throw()
                ->json();
        });
    }
}

キーをソース管理外に設定する

php · config/services.php and .envcopy

// config/services.php
'exchangerate' => [
    'key' => env('EXCHANGERATE_API_KEY'),
],

// .env (never commit the real value)
EXCHANGERATE_API_KEY=exr_live_...

レートと観測フィールドを読む

$service->latest("USD", ["EUR", "GBP"])を呼び、$result["rates"]["EUR"]を読む。$result["source"]、$result["market_session"]、$result["data_updated_at"]も保持する。

エラーをレートとしてキャッシュしない

401はキーまたはヘッダーの誤り、429は要求上限超過を示す。失敗させ、以前の成功観測を残す場合は元の更新時刻も残す。

キャッシュキー作成前にシンボルをソートする。
有限のHTTPタイムアウトを設定する。
JSONを読む前にthrowを呼ぶ。
APIレートではなく最終金額を丸める。

exchangerate.dev

FXデータを扱う開発者向けの統合ガイド。

キャッシュ付きFXサービスを作る

キーをソース管理外に設定する

レートと観測フィールドを読む

Keep reading