Функция cURL в PHP: от базовых HTTP запросов до продвинутой настройки

Расширенные примеры использования cURL в PHP

Ниже приведены подробные примеры с кодом и результатами выполнения (предполагается работа с тестовым API).

Пример 1: GET запрос к публичному REST API с обработкой ошибок

<?php
function getUsers() {
    $ch = curl_init();
    curl_setopt_array($ch, [
        CURLOPT_URL => "https://jsonplaceholder.typicode.com/users",
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT => 10,
        CURLOPT_HTTPHEADER => ['Accept: application/json']
    ]);

    $response = curl_exec($ch);
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    $error = curl_error($ch);
    curl_close($ch);

    if ($error) {
        return ['error' => "cURL error: $error"];
    }
    if ($httpCode !== 200) {
        return ['error' => "HTTP code: $httpCode"];
    }
    return json_decode($response, true);
}
$result = getUsers();
print_r($result);
?>

Array
(
    [0] => Array
        (
            [id] => 1
            [name] => Leanne Graham
            [username] => Bret
            [email] => Sincere@april.biz
            ...
        )
)

Пояснение: Функция curl_setopt_array() позволяет задать несколько параметров одним вызовом. Проверяется HTTP код ответа, выводится массив пользователей.

Пример 2: POST запрос с JSON и чтение ответа

<?php
$data = ['title' => 'foo', 'body' => 'bar', 'userId' => 1];
$json = json_encode($data);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://jsonplaceholder.typicode.com/posts",
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => $json,
    CURLOPT_HTTPHEADER => [
        'Content-Type: application/json',
        'Content-Length: ' . strlen($json)
    ],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo "HTTP status: $httpCode\n";
echo "Response: $response\n";
?>

HTTP status: 201
Response: {"title":"foo","body":"bar","userId":1,"id":101}

Пояснение: Успешный POST возвращает статус 201 и созданный объект с ID.

Пример 3: Загрузка файла на сервер с использованием CURLFile

<?php
$filePath = __DIR__ . '/test.txt';
file_put_contents($filePath, 'Hello, world!');
$cfile = new CURLFile($filePath, 'text/plain', 'test.txt');
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://httpbin.org/post",
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => ['file' => $cfile],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
curl_close($ch);
$decoded = json_decode($response, true);
echo "Uploaded file content: " . $decoded['files']['file'] . "\n";
unlink($filePath);
?>

Uploaded file content: Hello, world!

Пояснение: Используется специальный класс CURLFile (доступен с PHP 5.5), который корректно добавляет файл в multipart/form-data. После выполнения временный файл удаляется.

Пример 4: Асинхронные запросы через curl_multi с тайм-аутом

<?php
$urls = [
    'https://httpbin.org/delay/2',
    'https://httpbin.org/delay/1',
    'https://httpbin.org/get'
];
$mh = curl_multi_init();
$handles = [];
foreach ($urls as $url) {
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 5);
    curl_multi_add_handle($mh, $ch);
    $handles[] = $ch;
}
$active = null;
do {
    curl_multi_exec($mh, $active);
    curl_multi_select($mh);
} while ($active);

foreach ($handles as $ch) {
    $content = curl_multi_getcontent($ch);
    $info = curl_getinfo($ch);
    echo "URL: " . $info['url'] . " - HTTP " . $info['http_code'] . " - size: " . strlen($content) . "\n";
    curl_multi_remove_handle($mh, $ch);
    curl_close($ch);
}
curl_multi_close($mh);
?>

URL: https://httpbin.org/delay/2 - HTTP 200 - size: 310
URL: https://httpbin.org/delay/1 - HTTP 200 - size: 310
URL: https://httpbin.org/get - HTTP 200 - size: 286

Пояснение: Все три запроса выполняются параллельно, общее время выполнения равно самому медленному запросу (~2 секунды), а не сумме.

Пример 5: Работа с прокси и проверка SSL

<?php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://api64.ipify.org?format=json",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_PROXY => "http://proxy.example.com:3128",
    CURLOPT_PROXYUSERPWD => "user:pass",
    CURLOPT_PROXYTYPE => CURLPROXY_HTTP,
    CURLOPT_SSL_VERIFYPEER => true,
    CURLOPT_CAINFO => "/etc/ssl/certs/ca-certificates.crt"
]);
$response = curl_exec($ch);
if (curl_errno($ch)) {
    echo "Error: " . curl_error($ch);
} else {
    $data = json_decode($response, true);
    echo "Your public IP (via proxy): " . $data['ip'] . "\n";
}
curl_close($ch);
?>

Your public IP (via proxy): 123.456.789.0

Пояснение: Для проверки SSL сертификата используется файл центра сертификации. Прокси указывается со схемой http, тип - CURLPROXY_HTTP. Токен авторизации передаётся через CURLOPT_PROXYUSERPWD.

Пример 6: Использование cookie для сессионной авторизации

<?php
$cookieFile = tempnam(sys_get_temp_dir(), 'cookies');
// Шаг 1: авторизация
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://httpbin.org/post",
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query(['username' => 'test', 'password' => 'secret']),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_COOKIEJAR => $cookieFile,
    CURLOPT_COOKIEFILE => $cookieFile
]);
$response = curl_exec($ch);
curl_close($ch);
// Шаг 2: запрос с сохранённой сессией
$ch2 = curl_init();
curl_setopt_array($ch2, [
    CURLOPT_URL => "https://httpbin.org/cookies",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_COOKIEFILE => $cookieFile
]);
$response2 = curl_exec($ch2);
curl_close($ch2);
echo "Cookies received:\n" . $response2 . "\n";
unlink($cookieFile);
?>

Cookies received:
{
  "cookies": {
    "username": "test",
    "password": "secret"
  }
}

Пояснение: После первого запроса сервер может установить cookie, которые сохраняются в файл. Второй запрос отправляет эти cookie обратно, что позволяет поддерживать сессию.

Пример 7: Отправка PATCH запроса с частичным обновлением

<?php
$data = ['title' => 'updated title'];
$json = json_encode($data);
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://jsonplaceholder.typicode.com/posts/1",
    CURLOPT_CUSTOMREQUEST => "PATCH",
    CURLOPT_POSTFIELDS => $json,
    CURLOPT_HTTPHEADER => ['Content-Type: application/json'],
    CURLOPT_RETURNTRANSFER => true
]);
$response = curl_exec($ch);
curl_close($ch);
echo "Response: $response\n";
?>

Response: {"id":1,"title":"updated title","body":"...","userId":1}

Пояснение: CURLOPT_CUSTOMREQUEST позволяет отправлять любой HTTP метод, включая PATCH, DELETE, PUT. Тело запроса формируется как при POST.