[PHP|cURL] Kurs cURL

cURL - Client URL Library - to biblioteka do uniwersalnej wymiany danych między zdalnymi serwerami poprzez różne protokoły. Oznacza to, że na danym serwerze można wysyłać i pobierać dane z/do innego. Biblioteka cURL jest prosta w użyciu, ale zarazem bardzo funkcjonalna. Używa się jej między innymi do pobierania zdalnych dokumentów czy też wysłania danych do innych serwisów. cURL obsługuje protokoły: HTTP POST, HTTP PUT, FTP oraz certyfikaty SSL. Wpis ten jest wprowadzeniem do obsługi tej biblioteki.

Pierwsze żądanie

W tym przykładzie pokażę jak może wyglądać żądanie http z użyciem cURL: 

$ch = curl_init('http://www.example.com'); // Inicjujemy sesję cURL z żądaniami na adres przekazany jako argument

curl_setopt($ch, CURLOPT_HEADER, 0); // Rezygnujemy z nagłówków w zwróconej odpowiedzi
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 30); // Ustawiamy timeout połączenia np. 30 sekund

curl_exec($ch); // Wykonujemy żądanie

curl_close($ch); // Kończymy sesję

Jak widać na powyższym przykładzie, wysłanie prostego żądania http wymaga napisania tylko 5 krótkich linii kodu.

curl_init

Funkcja curl_init to funkcja inicjalizująca sesję cURL. Jako argument możemy, ale nie musimy przekazać do funkcji URL na jaki będzie wysłane żądanie. Adres dla żądania można także przekazać za pomocą funkcji curl_setopt, ale o tym w dalszej części. Funkcja curl_init zwraca resource - uchwyt połączenia.

curl_setopt

Funkcja curl_setopt jest jedną z ważniejszych funkcji biblioteki cURL. Służy ona do ustawiania opcji połączenia. Funkcja ta przyjmuje 3 argumenty: (resource) $ch - uchwyt połączenia, (int) $option - opcja do ustawienia (przekazywana jako stała), (mixed) $value - wartość dla ustawiane opcji. Wypiszę najczęściej używane przeze mnie opcje wraz z ich opisami. Wszystkie dostępne opcje znajdują się w dokumentacji.

  • bool CURLOPT_RETURNTRANSFER - TRUE, jeśli wynik żądania ma być zwrócony;
  • bool CURLOPT_HEADER - TRUE, jeśli do odpowiedzi mają zostać dołączone nagłówki;
  • bool CURLOPT_BINARYTRANSFER - TRUE, jeśli odpowiedź ma być zwrócona w surowym stanie;
  • bool CURLOPT_AUTOREFERER, TRUE, jeśli nagłówek Referer ma być ustawiany automatycznie;
  • string CURLOPT_URL - URL dla zapytania;
  • string CURLOPT_REFERER - ustawia nagłówek Referer;
  • string CURLOPT_USERAGENT - ustawia nagłówek User-Agent;
  • string CURLOPT_COOKIE - ustawia nagłówek Cookie;
  • string CURLOPT_ENCODING - ustawia nagłówek Accept-Encoding;
  • int CURLOPT_CONNECTTIMEOUT - ustawia timeout połączenia (w sekundach);
  • int CURLOPT_BUFFERSIZE - ustawia rozmiar bufora;
  • int CURLOPT_PORT - ustawia numer portu dla połączenia;

curl_exec

Za pomocą funkcji curl_exec wykonujemy wcześniej ustawione żądanie. Funkcja przyjmuje 1 argument (resource) - uchwyt zwrócony przez funkcję curl_init. Funkcja ta zwraca TRUE, jeśli żądanie zostanie pomyślnie wysłane lub FALSE w przypadku niepowodzenia. Uwaga! Funkcja curl_init służy także do zwracania wyniku żądania, jeśli opcja CURLOPT_RETURNTRANSFER zostanie ustawiona na TRUE.

curl_close

Funkcja curl_close kończy sesję cURL. Funkcja przyjmuje 1 argument (resource) - uchwyt połączenia.

Komentarze

Prześlij komentarz

Dzięki za komentarz!

Popular

[HTML] Jak wstawić obrazek?

Cześć! Jesteś tu zapewne dlatego, bo nie wiesz jak wstawić zdjęcie na stronę. W tym wpisie nauczysz się wstawiać obrazek na stronę www zarówno jako tylko obrazek, ale też obrazek jako klikalny odnośnik. Przejdźmy zatem do nauki... Wstawianie obrazka Do wstawiania grafiki na stronę służy znacznik img z atrybutami src oraz alt . Atrybutem wymaganym jest src - adres źródłowy (adres grafiki, którą chcemy wstawić na stronę). Atrybut alt - zawiera tekst alternatywny, który zostanie wyświetlony, gdy wczytanie obrazka się nie powiedzie. Podsumowując, aby wstawić zdjęcie piszemy następujący fragment kodu: <img src="images/flower.jpg" alt="Kwiatek" /> Link z obrazkiem A teraz połączenie odnośnika z obrazkiem, czyli zastąpienie tekstu w linku zdjęciem: <a href="https://www.ukodowani.pl"><img src="images/banner.jpg" alt="ukodowani.pl" /></a> Możesz również ustawić zdjęcie jako tło . Jeśli chcesz dowiedzieć się j
Czytaj więcej

[C++] Jak obliczyć pole i obwód trapezu?

Przed napisaniem programu obliczającego pole i obwód trapezu, przypomnij sobie wzory. Pole trapezu liczymy według wzoru P=((a+b)*h)/2. Wzór na obwód Ob=a+b+c+d. Obliczając pole trapezu musimy znać rozmiary dwóch podstaw i wysokości. Obliczamy pole trapezu #include <iostream> using namespace std; int main() { int a; int b; int h; double p; cout << "Podaj długość podstawy a: "; cin >> a; cout << "Podaj długość podstawy b: "; cin >> b; cout << "Podaj wysokość: "; cin >> h; if(cin.good() == true) { p = ((a + b) * h) / 2.0; cout << "Pole trapezu wynosi: " << p; } return 0; } Obliczamy obwód trapezu #include <iostream> using namespace std; int main() { int a, b, c, d, ob; cout << "Podaj długość boku a: "; cin >> a; cout << "Podaj długość boku b: "; cin >> b; cout << "Podaj długość boku c: "; cin >> c;
Czytaj więcej

[PHP] Jak pobrać adres strony?

Gdy zajdzie potrzeba pobrania adresu strony, na której użytkownik aktualnie się znajduje, posłużyć się można do tego celu tablicą $_SERVER z kluczem 'SERVER_NAME'. Pobranie adresu strony, na której znajduje się użytkownik sprowadza się dosłownie do połączenia dwóch elementów tablicy $_SERVER: SERVER_NAME oraz REQUEST_URI . Element o kluczu 'SERVER_NAME' zawiera nazwę hosta serwera, na którym wykonywany jest skrypt, a element z kluczem 'REQUEST_URI' pobiera wszystko to, co zostało wpisane po nazwie domeny np. '/index.php'. Tak więc, aby wyświetlić adres strony lub adres do skryptu, łączymy te dwa elementy: echo $_SERVER['SERVER_NAME'] . $_SERVER['REQUEST_URI']; Powyższy przykład wyświetli nam URL, pod którym aktualnie się znajdujemy, ale bez przedrostka http/https. Aby do ciągu z URL'em dołączana była nazwa protokołu, musimy użyć jeszcze jednego elementu tablicy $_SERVER, a mianowicie HTTPS , który nie będzie pusty, jeśli żądanie
Czytaj więcej