curl_init

(PHP 4 >= 4.0.2, PHP 5, PHP 7, PHP 8)

curl_initИнициализирует cURL-сеанс

Описание

curl_init(?string $url = null): CurlHandle|false

Функция инициализирует новую сессию модуля cURL и возвращает дескриптор, с которым работают функции curl_setopt(), curl_exec() и curl_close().

Список параметров

url

Функция автоматически установит значение аргумента, который передали в этот параметр, опции CURLOPT_URL. Модуль разрешает ручную установку значения опции функцией curl_setopt() после инициализации сеанса.

Замечание:

Модуль cURL отключает протокол file, если установили директиву open_basedir.

Возвращаемые значения

Функция возвращает cURL-дескриптор в случае успешного выполнения, или false, если возникла ошибка.

Список изменений

Версия Описание
8.0.0 Теперь в случае успешного выполнения функция возвращает экземпляр класса CurlHandle; раньше возвращался ресурс (resource).
8.0.0 Параметр url теперь принимает значение null.

Примеры

Пример #1 Пример инициализации нового cURL-сеанса и получение веб-страницы

<?php

// Создаём новую cURL-сессию
$ch = curl_init();

// Устанавливаем URL-адрес и другие параметры
curl_setopt($ch, CURLOPT_URL, "http://www.example.com/");
curl_setopt($ch, CURLOPT_HEADER, 0);

// Получаем страницу и передаём её в браузер
curl_exec($ch);

// Завершаем cURL-сеанс и высвобождаем системные ресурсы
curl_close($ch);

?>

Смотрите также

  • curl_close() - Завершает сеанс cURL
  • curl_multi_init() - Возвращает новый мультидескриптор модуля cURL