Podstawowe funkcje

W skład implementacji cURL w PHP wchodzą dwa interfejsy ? easy oraz multi. Jak sama nazwa wskazuje, curl_easy udostępnia zbiór funkcji pozwalający na komunikację w najprostszy sposób. Curl_multi pozwala natomiast na jednoczesne działanie na kilku sesjach. Zacznijmy od omówienia pierwszego z nich.

curl_init

Pierwsza funkcja rozpoczyna sesję i zwraca zasób, który będzie służył do kontroli połączenia.

Jedyny opcjonalny parametr jest odnośnikiem URI do zasobu, z którym chcemy się połączyć. Na tym etapie powinniśmy korzystać z możliwości podania URI podczasz inicjalizacji sesji, aczkolwiek istnieje alternatywne, mniej wygodne rozwiązanie, które zostanie omówione w dalszej części artykułu.

curl_setopt

Kolejną z niezbędnych funkcji jest curl_setopt, która odpowiada za zmianę opcji w obrębie sesji.

Pierwszym przekazywanym parametrem jest zwrócony przez funkcję curl_init zasób cURL. Kolejnym argumentem jest liczba powiązana z konkretną właściwością. W rozszerzeniu wszystkie opcje są reprezentowane poprzez stałe rozpoczynające się prefiksem CURLOPT. Każdej opcji możliwe jest przypisanie wartości konkretnego typu. Spis najważniejszych stałych znajduje się w manualu PHP. Wszelkie używane stałe zostaną opisane w tekście, więc dokumentacja będzie potrzebna tylko w przypadku wykonywania zadań wykraczających poza tematykę artykułu. Musimy sobie zdać sprawę, że większa część komunikacji z serwerem jest sterowana opcjami, więc będzie to najczęściej używana funkcja w przykładach zawartych w tym tekście.

curl_exec

Kiedy już mamy zasób i ustawione opcje, musimy przesłać nasze żądanie do serwera, co czynimy wywołując funkcję curl_exec.

Argumenty nie powinny wymagać wyjaśnień, gdyż sytuacja wygląda analogicznie do pozostałych funkcji. Typ zwracanej wartości jest zależny od opcji połączenia, o której będzie mowa nieco później.

curl_close

Od samego początku używania biblioteki, należy wyrobić sobie dobry nawyk zamykania sesji. Mimo iż w pierwszych skryptach nie wymaga się czyszczenia, to jednak później może okazać się to niezbędne. Wywołanie nie powinno wymagać wyjaśnień.