PHP: Curl

Итак, Curl - это проект, целью которого является интерпретация URL и выборка из них данных, за проект Curl отвечает Дениел Стенберг (Daniel Stenberg). Почти все сценарии, использующие Curl - схожи по своему принципу:

1. создание ресурса Curl функцией curl_init

2. установку параметров с помощью функции curl_setopt

3. выполнение запроса с помощью curl_exec.

Недавно в проект Curl был добавлен так называемый мультиинтерфейс. Теперь РНР поддерживает и эти функции, но они ещё сыроваты.

void curl_close(resource curl)

Функция curl_close освобождает память, занятую ресурсом Curl,

string curlerror(resource curl)

Функция curlerror возвращает описание последней ошибки для заданного ресурса Curl.

integer curl_errno(resource curl)

Функция curl_errno возвращает номер последней ошибки, сгенерированной заданным ресурсом Curl.В таблице ниже приведены константы РНР, представляющие коды ошибок, возвращаемые функцией curl_errno()

Коды ошибок, возвращаемые CURL функциями

boolean/string curl_ехес(resource curl)

Функция curl_ехес предназначена для выполнения запроса. В зависимости от параметра CURLOPT_RETURNTRANSFER функция curl_ехес возвращает логическое значение или запрашиваемые данные см. пример ниже.

CURL отправка POST запроса:

  <?php
    if(!($curl = curl_init()))
    {
      exit ('Невозможно инициализировать ресурс Curl!');
    }
    
    //Настроить процессор поиска php.net для выполнения запроса post 
    curl_setopt($curl, CURLOPT_URL, 'http://www.php.net/search.php');
    curl_setopt($curl, CURLOPT_RETURNTRANSFER,  TRUE);
    curl_setopt($curl, CURLOPT_POST, TRUE);
    curl_setopt($curl, CURLOPT_POSTFIELDS, 'lang=en_US&Zend API&show=nosource');
    
    //сделать запрос
    $results = curl_exec($curl);
    
    print('<pre>');
    print(htmlentities($results));
    print ('</pre>');
  ?>

string curl_getinfo(resource curl, integer info)

Функция curl_getinfо применяется для поиска информации о Curl-запросе. В таблице ниже приведен перечень констант, используемых в аргументе info.

Заметьте!

Авторы Curl не стали плодить множество функций, для работы, они пошли другим путём. В скрипте используются несколько функций, а вот их поведение, и скрипта в целом, настраивается с помощью функции curl_setopt и её констант - их то как раз хренова куча! Так что Ctrl + F вам в помощь - я специально не стал разбивать материал на несколько страниц, что бы пользуясь встроенной функцией поиска, в вашем браузере, вы могли найти описание нужной константы на одной странице.

Перечень констант, используемых в аргументе curl_getinfo

<?php

  //принять стартовую страницу узла Zend
  $curl = curl_init('http://www.zend.com/');
  curl_setopt($curl, CURLOPT_RETURNTRANSFER, TRUE);
  curl_exec($curl);
   
  //получить различную информацию
  echo 'CURLINFO_CONNECT_TIME: '.curl_getinfo($curl, CURLINFO_CONNECT_TIME).'<br />';
  echo 'CURLINFO_CONTENT_LENGTH_DOWNLOAD: '.curl_getinfo($curl, CURLINFO_CONTENT_LENGTH_DOWNLOAD).'<br />';
  echo 'CURLINFO_CONTENT_LENGTH_UPLOAD: '.curl_getinfo($curl, CURLINFO_CONTENT_LENGTH_UPLOAD).'<br />';
  echo 'CURLINFO_CONTENT_TYPE: '.curl_getinfo($curl, CURLINFO_CONTENT_TYPE).'<br />';
  echo 'CURLINFO_EFFECTIVE_URL: '.curl_getinfo($curl,  CURLINFO_EFFECTIVE_URL).'<br />';
  echo 'CURLINFO_FILETIME: '.curl_getinfo($curl, CURLINFO_FILETIME).'<br />';
  echo 'CURLINFO_HEADER_SIZE: '.curl_getinfo($curl,  CURLINFO_HEADER_SIZE).'<br />';
  echo 'CURLINFO_HTTP_CODE: '.curl_getinfo($curl,  CURLINFO_HTTP_CODE).'<br />';
  echo 'CURLINFO_NAMELOOKUP_TIME: '.curl_getinfo($curl, CURLINFO_NAMELOOKUP_TIME).'<br />';
  echo 'CURLINFO_PRETRANSFER_TIME: '.curl_getinfo($curl,  CURLINFO_PRETRANSFER_TIME).'<br />';
  echo 'CURLINFO_REDIRECT_COUNT: '.curl_getinfo($curl,  CURLINFO_REDIRECT_COUNT).'<br />';
  echo 'CURLINFO_REDIRECT_TIME: '.curl_getinfo($curl,  CURLINFO_REDIRECT_TIME).'<br />';
  echo 'CURLINFO_REQUEST_SIZE: '.curl_getinfo($curl, CURLINFO_REQUEST_SIZE).'<br />';
  echo 'CURLINFO_SIZE_DOWNLOAD: '.curl_getinfo($curl,  CURLINFO_SIZE_DOWNLOAD).'<br />';
  echo 'CURLINFO_SIZE_UPLOAD: '.curl_getinfo($curl,  CURLINFO_SIZE_UPLOAD).'<br />';
  echo 'CURLINFO_SPEED_DOWNLOAD: '.curl_getinfo($curl,  CURLINFO_SPEED_DOWNLOAD).'<br />';
  echo 'CURLINFO_SPEED_UPLOAD: '.curl_getinfo($curl,  CURLINFO_SPEED_UPLOAD).'<br />';
  echo 'CURLINFO_SSL_VERIFYRESULT: '.curl_getinfo($curl,  CURLINFO_SSL_VERIFYRESULT).'<br />';
  echo 'CURLINFO_STARTTRANSFER_TIME: '.curl_getinfo($curl, CURLINFO_STARTTRANSFER_TIME).'<br />';
  echo 'CURLINFO_TOTAL_TIME: '.curl_getinfo($curl, CURLINFO_TOTAL_TIME).'<br />';

?>

resource curl_init(string url)

Функция curl_init используется для создания дескриптора ресурса Curl. Необязательный аргумент url устанавливает параметр CURLOPT_URL.

integer curl_multi_add_handle(resource multi, resource curl)

Функция curl_milti_add_handle добавляет обычный ресурс Curl в мульти ресурсный стек и возвращает код состояния.

curl_multi_close(resource multi)

Функция curl_milti_close закрывает мультиресурс Curl и вызывает функцию curl_multi_cleanup.

integer curl_multi_exec (resource multi)

Функция curl_milti_exec читает и записывает данные на все сокеты мультиресурсного стека. Вызывает функцию curl_milti_perform.

string curl_multigetcontent(resource multi)

Функция curl_multi_getcontent возвращает содержимое из мультиресурса.

array curl_multi_lnfo_read(resource multi)

Функция curl_multi_lnfo_read возвращает массив, содержащий информацию о мультиресурсе.

resource curl_milti_init()

Функция curl_milti_init возвращает ресурс, указывающий на мульти интерфейс.

integer curl_multi_remove_handle(resource multi, resource curl)

Функция curl_multi_remove_handle удаляет обычный ресурс Curl из мульти ресурсного стека. Возвращает код состояния.

curl_multi_select(resource multi, integer timeout)

Функция multi_select выполняет выбор из библиотеки языка С по набору ресурсов Curl в мульти ресурсном стеке. Передается необязательный аргумент timeout.

string curl_version()

Функция curl_version предназначена для определения версии работающей библиотеки Curl.

boolean curl_setopt(resource curl, string option, value setting)

Функция curl_setopt позволяет сделать настройку соединения Curl до выполнения функции curl_exec. Необходимо передавать дескриптор ресурса Curl, созданного функцией curl_init. В таблице ниже, перечислены константы для этой функции

В будущих статьях я планирую освещать рецепты типовых задач, решаемых при помощи Curl. Подробнее о проекте Curl можно узнать по адресу