Pobieranie danych z API (cURL + JSON) na przykładzie kursów NBP

<?php
/**
 * Pobieranie danych z API (cURL + JSON) — skryptyPHP.com
 * Zapisz jako: kursy-walut.php
 * Wymaga rozszerzenia curl (standard na hostingach).
 */

/**
 * Pobiera i dekoduje JSON spod wskazanego adresu.
 *
 * @throws RuntimeException gdy połączenie lub dekodowanie się nie powiedzie
 */
function pobierz_json(string $url, int $limitCzasu = 10): array
{
    $ch = curl_init($url);
    curl_setopt_array($ch, [
        CURLOPT_RETURNTRANSFER => true,          // zwróć odpowiedź, nie wypisuj
        CURLOPT_TIMEOUT        => $limitCzasu,   // maks. czas całego pobierania
        CURLOPT_CONNECTTIMEOUT => 5,             // maks. czas łączenia
        CURLOPT_FOLLOWLOCATION => true,          // podążaj za przekierowaniami
        CURLOPT_MAXREDIRS      => 3,
        CURLOPT_USERAGENT      => 'MojaStrona/1.0 (+https://twojadomena.pl)',
        CURLOPT_HTTPHEADER     => ['Accept: application/json'],
        // Weryfikacja certyfikatu SSL zostaje WŁĄCZONA (domyślna).
        // Nigdy nie wyłączaj jej przez CURLOPT_SSL_VERIFYPEER => false!
    ]);

    $odpowiedz = curl_exec($ch);

    if ($odpowiedz === false) {
        $blad = curl_error($ch);
        curl_close($ch);
        throw new RuntimeException('Błąd połączenia: ' . $blad);
    }

    $kodHttp = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
    curl_close($ch);

    if ($kodHttp >= 400) {
        throw new RuntimeException('Serwer API zwrócił błąd HTTP ' . $kodHttp);
    }

    try {
        return json_decode($odpowiedz, true, 512, JSON_THROW_ON_ERROR);
    } catch (JsonException $e) {
        throw new RuntimeException('Nieprawidłowy JSON: ' . $e->getMessage());
    }
}

/**
 * Jak wyżej, ale z buforowaniem odpowiedzi do pliku.
 * Kolejne wywołania w czasie $czasWaznosci czytają z dysku, nie z sieci.
 */
function pobierz_json_z_cache(
    string $url,
    string $plikCache,
    int $czasWaznosci = 3600
): array {
    if (is_file($plikCache) && time() - filemtime($plikCache) < $czasWaznosci) {
        $dane = json_decode((string) file_get_contents($plikCache), true);
        if (is_array($dane)) {
            return $dane;
        }
    }

    $dane = pobierz_json($url);
    file_put_contents($plikCache, json_encode($dane), LOCK_EX);
    return $dane;
}

// ── PRZYKŁAD: kursy walut z API NBP ─────────────────────────
$interesujace = ['USD', 'EUR', 'CHF', 'GBP'];

try {
    $tabela = pobierz_json_z_cache(
        'https://api.nbp.pl/api/exchangerates/tables/A?format=json',
        __DIR__ . '/cache-nbp.json',
        3600 // odświeżaj co godzinę
    );

    echo '<h2>Kursy średnie NBP (tabela ' . htmlspecialchars($tabela[0]['no']) . ')</h2>';
    echo '<ul>';
    foreach ($tabela[0]['rates'] as $kurs) {
        if (in_array($kurs['code'], $interesujace, true)) {
            echo '<li>1 ' . htmlspecialchars($kurs['code']) . ' = '
               . number_format($kurs['mid'], 4, ',', ' ') . ' zł</li>';
        }
    }
    echo '</ul>';

} catch (RuntimeException $e) {
    // Na produkcji: zaloguj błąd i pokaż neutralny komunikat
    error_log('Kursy NBP: ' . $e->getMessage());
    echo '<p>Kursy walut są chwilowo niedostępne.</p>';
}