[PHP][cURL] Podstawy cz.4 - cookies

Wysyłanie cookies może odbywać się dwukierunkowo, tj. serwer może w odpowiedzi zażądać utworzenia pliku ciasteczka w przeglądarce, jak i przeglądarka/cURL może wysłać do serwera informacje o ciasteczkach jakie są ustawione dla danej domeny. Ciasteczka oczywiście możemy preparować sami, a odbywa się to za pomocą stworzenia prostego ciągu z nazwami i wartościami naszych ciasteczek, a nastepnie wysłaniu żądania na serwer. Spójrzmy więc jak to wygląda w praktyce.

Przygotowanie ciasteczek - CURLOPT_COOKIE

W najprostrzej możliwej postaci musimy przygotować ciąg o następującej strukturze:

$cookies = "cookie1=".urlencode("wartość1")."; cookie2=".urlencode("wartość2");  // i tak dalej

Wszystkie ciastecznka muszą być rozdzielone średnikiem, a ich wartości potraktowane funkcją urlencode().

Nastepnie taki ciąg ustawiamy jako opcję w cURL-u za pomocą parametru CURLOPT_COOKIE:

curl_setopt($ch, CURLOPT_COOKIE, $cookies);

Całość wysyłamy na serwer.
Nasz kod wyglądać więc będzie tak:

<?php
 
// do tej tablicy odbierzemy nagłówki
 
$return_headers = [];
 
$errors = '';
 
 
 
// funkcja odbierająca nagłówki
 
function headerLine($curl, $header_line ) {
 
    $GLOBALS['return_headers'][] = $header_line;
 
    return strlen($header_line);
 
}
 
 
 
// url do server.php
 
$url_to_server = 'http://localhost/server.php';
 
 
 
// inicjujemy sesję połączenia
 
$ch = curl_init($url_to_server);
 
 
 
// definiujemy cookies
 
$cookies = "cookie1=".urlencode("this_is_cookie1").";cookie2=".urlencode("this_is_cookie2");
 
 
 
// dodajemy cookies do żądania:
 
curl_setopt($ch, CURLOPT_COOKIE, $cookies);
 
 
 
// ustawiamy opcje
 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // chcemy odebrać dane
 
curl_setopt($ch, CURLOPT_USERAGENT, 'fake browser'); // ustawiamy user-agenta
 
curl_setopt($ch, CURLOPT_REFERER, 'http://www.google.com'); // ustawiamy referera
 
curl_setopt($ch, CURLOPT_HEADERFUNCTION, "headerLine"); // ustawiamy własną funkcję do przetworzenia nagłówka
 
 
 
 
 
// wykonujemy połączenie
 
$response_body = curl_exec($ch);
 
 
 
// pobieramy błąd, jeśli wystąpi
 
if (curl_errno($ch))  $errors.= '<h2>Error #' . curl_errno($ch) . ': ' . curl_error($ch).'</h2>';
 
 
 
// zamykamy sesję połączenia
 
curl_close($ch);
 
?>

Wysłane ciasteczka pojawią się po stronie serwera w tablicy $_COOKIE:

Ciasteczka wysyłane przez serwer

A jak sprawa wygląda w drugą stronę, gdy to serwer wysyła do nas żądanie ze stworzeniem ciasteczka? Zobaczymy to w nagłówku otrzymanym od serwera:

Jak widać dostaliśmy nagłówek Set-Cookie, który wysyła do nas ciasteczko sesyjne o nazwie PHPSESSID i wartości w tym przypadku 04bc39avas8hvkks9458b8toe7. Analogicznie przesyłane są do nas wszystkie inne ciasteczka, informujące o zalogowaniu i inne, ustawiane w PHP za pomocą funkcji setcookie().

Aby to przeanalizować, dodajmy na początku pliku server.php następujący kod:

<?php
 
setcookie('cookie_from_server', 'test123');

i sprawdźmy co się stało w clients.php - jak widać otrzymaliśmy od serwera nagłówek z nowym ciasteczkiem:

Ustawianie flagi HttpOnly

Domyślnie przesyłane przez PHP ciasteczko nie ma ustawionej opcji HttpOnly, a więc może zostać odczytane przez Javascript. Aby wymusić na przeglądarce ustawienie takiej opcji, musimy ustawić cookie poprzez:

<?php
 
setcookie('cookie_from_server', 'test123', 0, '/', 'localhost', false, true);

gdzie składnia wygląda następująco:

setcookie(nazwa_cookie, wartość_cookie, czas_ważności, domena, https, httponly)

Ciasteczko z pliku

Cookies można też zapisać w pliku i wysłać je prosto z pliku.
Służy do tego opcja:

curl_setopt($ch, CURLOPT_COOKIEFILE, '/ścieżka/absolutna/do/pliku');

Uwaga: ścieżka MUSI być absolutna, nie możemy tutaj podać:

cookies.txt

Musimy podać, np.:

C:/WWW/test/cookies.txt

lub wykorzystać:

realpath('cookies.txt')

Nasz plik cookies.txt może wyglądać następująco:

localhost   TRUE    /   FALSE   0   cookie_from_file1    cookie_value1
 
localhost   TRUE    /   FALSE   0   cookie_from_file2    cookie_value3
 

Składnia wygląda następująco:

domena   dostęp_dla_poddomen   ścieżka   czas_wygaśnięcia   nazwa_cookie   wartość_cookie

Pola oddzielamy tabulatorem, nie spacją, a każde ciasteczko to oddzielna linijka.
Gdy domenę ustawimy z kropką na początku:

.localhost

i podamy TRUE w dostępie do poddomen, to ciastko będzie dostępne również dla subdomen, jak np. test.localhost, www.localhost, test2.localhost itd.

Przykład użycia:

<?php
 
$return_headers = [];
 
 
 
function headerLine($curl, $header_line ) {
 
    $GLOBALS['return_headers'][] = $header_line;
 
    return strlen($header_line);
 
}
 
$url_to_server = 'http://localhost/server.php';
 
$ch = curl_init($url_to_server);
 
$cookie_file = 'cookies.txt';
 
 
 
curl_setopt($ch, CURLOPT_COOKIEFILE, realpath($cookie_file)); // cookie z pliku
 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // chcemy odebrać dane
 
curl_setopt($ch, CURLOPT_HEADERFUNCTION, "headerLine"); // ustawiamy własną funkcję do przetworzenia nagłówka
 
$response_body = curl_exec($ch);
 
curl_close($ch);
 
?>

Wynik:

Zapisywanie odebranych ciasteczek

Odebrane od serwera cookies cURL może zapisać do określonego przez nas pliku.
Służy do tego opcja:

curl_setopt($ch, CURLOPT_COOKIEJAR, '/absolutna/ścieżka/do/pliku');

Dzięki tej opcji wszystkie odebrane od serwera ciasteczka, po wykonaniu funkcji curl_close()  zapisane zostaną do pliku, który podaliśmy jako parametr.
Uwaga: ścieżka ponownie MUSI być absolutna, nie możemy tutaj podać:

returned_cookies.txt

Musimy podać, np.:

C:/WWW/test/returned_cookies.txt

lub wykorzystać:

realpath('returned_cookies.txt')

Przykład użycia:

<?php
 
$return_headers = [];
 
 
 
function headerLine($curl, $header_line ) {
 
    $GLOBALS['return_headers'][] = $header_line;
 
    return strlen($header_line);
 
}
 
$url_to_server = 'http://localhost/server.php';
 
$ch = curl_init($url_to_server);
 
$cookie_file = 'returned_cookies.txt';
 
 
 
curl_setopt($ch, CURLOPT_COOKIEJAR, realpath($cookie_file)); // cookie do pliku
 
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); // chcemy odebrać dane
 
curl_setopt($ch, CURLOPT_HEADERFUNCTION, "headerLine"); // ustawiamy własną funkcję do przetworzenia nagłówka
 
$response_body = curl_exec($ch);
 
curl_close($ch);
 
?>

W naszym przypadku, plik returned_cookies.txt uzyska taką treść:

# Netscape HTTP Cookie File
 
# http://curl.haxx.se/docs/http-cookies.html
 
# This file was generated by libcurl! Edit at your own risk.
 
 
 
#HttpOnly_.localhost TRUE / FALSE 0 cookie_from_server test123
 
test5.localhost FALSE / FALSE 0 PHPSESSID 04h6239oieslvfhqajtdls7nf0

Oficjalny, pełny manual biblioteki cURL znajduje się tutaj: http://php.net/manual/en/book.curl.php

<< Część 3: Żądania POST i wysyłanie plików

Część 5: Obsługa przekierowań >>