دریافت نرخ ارز در PHP و لاراول با cURL و Guzzle؛ آموزش کامل

<?php
function ezrate_get(string $path, array $query = []): array
{
    $key = getenv('EZRATE_KEY');
    $url = 'https://api.ezrate.me/v1' . $path . ($query ? '?' . http_build_query($query) : '');
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 8,
        CURLOPT_HTTPHEADER => ["X-API-Key: {$key}", 'Accept: application/json'],
    ]);
    $body = curl_exec($ch);
    $code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);

    if ($body === false || $code !== 200) {
        throw new RuntimeException("EZRate API error: HTTP {$code}");
    }
    return json_decode($body, true, 512, JSON_THROW_ON_ERROR);
}

$res = ezrate_get('/rates', ['symbols' => 'usd,eur,aed', 'lang' => 'fa']);
foreach ($res['data'] as $r) {
    printf("%s: %s تومان\n", $r['name'], number_format($r['sell']));
}

function ezrate_rates_cached(int $ttl = 60): array
{
    $file = sys_get_temp_dir() . '/ezrate_rates.json';
    if (is_file($file) && time() - filemtime($file) < $ttl) {
        return json_decode(file_get_contents($file), true);
    }
    try {
        $data = ezrate_get('/rates', ['symbols' => 'usd,eur,aed,g18,emami'])['data'];
        file_put_contents($file, json_encode($data), LOCK_EX);
        return $data;
    } catch (Throwable $e) {
        // API در دسترس نیست: آخرین فایل حتی اگر قدیمی باشد
        return is_file($file) ? json_decode(file_get_contents($file), true) : [];
    }
}

// .env
EZRATE_KEY=ezr_live_…

// config/services.php
'ezrate' => [
    'key' => env('EZRATE_KEY'),
    'url' => 'https://api.ezrate.me/v1',
],

<?php
namespace App\Services;

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

class ExchangeRates
{
    public function all(): array
    {
        return Cache::remember('ezrate:rates', 60, function () {
            $res = Http::withHeaders(['X-API-Key' => config('services.ezrate.key')])
                ->timeout(8)->retry(2, 500, throw: false)
                ->get(config('services.ezrate.url') . '/rates', ['category' => 'fiat', 'lang' => 'fa']);

            if (! $res->successful()) {
                return Cache::get('ezrate:rates:last', []);
            }
            $rates = collect($res->json('data'))->keyBy('symbol')->all();
            Cache::forever('ezrate:rates:last', $rates);   // آخرین مقدار معتبر
            return $rates;
        });
    }

    public function sell(string $symbol): ?int
    {
        return $this->all()[$symbol]['sell'] ?? null;
    }
}

// routes/console.php (لاراول ۱۱ به بعد)
use Illuminate\Support\Facades\Schedule;

Schedule::call(function () {
    Cache::forget('ezrate:rates');
    app(\App\Services\ExchangeRates::class)->all();
})->everyMinute()->name('ezrate-refresh')->withoutOverlapping();

$res = Http::withHeaders(['X-API-Key' => config('services.ezrate.key')])
    ->get(config('services.ezrate.url') . '/convert', [
        'from' => 'usd', 'to' => 'irt', 'amount' => 49.99, 'side' => 'sell',
    ])->json('data');
// $res['result'] = معادل تومانی ۴۹٫۹۹ دلار

// database/migrations/xxxx_create_daily_rates_table.php
Schema::create('daily_rates', function (Blueprint $t) {
    $t->id();
    $t->date('day');
    $t->string('symbol', 16);
    $t->unsignedBigInteger('buy');
    $t->unsignedBigInteger('sell');
    $t->string('quote', 8)->default('IRT');
    $t->unique(['day', 'symbol']);
});

// routes/console.php — هر شب ساعت ۲۳:۵۵ به وقت تهران
Schedule::call(function () {
    foreach (app(\App\Services\ExchangeRates::class)->all() as $r) {
        DB::table('daily_rates')->updateOrInsert(
            ['day' => today('Asia/Tehran'), 'symbol' => $r['symbol']],
            ['buy' => $r['buy'], 'sell' => $r['sell'], 'quote' => $r['quote']]
        );
    }
})->dailyAt('23:55')->timezone('Asia/Tehran');

use Illuminate\Support\Facades\Http;

it('shows the dollar price', function () {
    Http::fake(['api.ezrate.me/*' => Http::response([
        'data' => [['symbol' => 'usd', 'name' => 'دلار', 'buy' => 100000, 'sell' => 100200, 'quote' => 'IRT']],
        'meta' => ['as_of' => now()->toIso8601String(), 'freshness_sec' => 60],
    ])]);
    Cache::flush();
    expect(app(\App\Services\ExchangeRates::class)->sell('usd'))->toBe(100200);
});

it('keeps the last rate when the API is down', function () {
    Cache::forever('ezrate:rates:last', ['usd' => ['sell' => 99000]]);
    Http::fake(['api.ezrate.me/*' => Http::response([], 503)]);
    Cache::forget('ezrate:rates');
    expect(app(\App\Services\ExchangeRates::class)->sell('usd'))->toBe(99000);
});

$old = Cache::get('ezrate:usd:prev');
$new = $rates['usd']['sell'];
if ($old && abs($new - $old) / $old >= 0.01) {
    event(new \App\Events\DollarMoved($old, $new));
}
Cache::forever('ezrate:usd:prev', $new);