Formularze

Formularze są jednym z najważniejszych sposobów na interakcję użytkownika ze stroną umieszczoną na serwerze HTTP. Dane pochodzące z nich mogą być przesyłane dwiema różnymi metodami: GET oraz POST. O ile pierwsza z nich nie powinna wymagać wyjaśnień, o tyle używanie drugiej wymaga nieco innego podejścia.

Na początku powiadamiamy przeglądarkę o nadchodzących danych z formularza za pomocą nagłówka Content-Type (multipart/form-data lub application/x-www-form-urlencoded). Client URL Library robi to automatycznie, lecz możemy narzucić to zachowanie przypisując wartość true opcji CURLOPT_POST. Następnie przekazujemy nazwy i zawartość zmiennych poprzez CURLOPT_POSTFIELDS. Niestety dokumentacja przedstawia tylko jeden, mniej wygodny sposób na wykonanie tej czynności, czyli przekazanie spreparowanego ciągu znaków.

Pojawia się tu problem ze znakami specjalnymi, które należy zakodować poprzez użycie funkcji urlencode. Ręczne przygotowywanie powyższego ciągu może być męczące, dlatego pomożemy sobie funkcją, która znajduje się w listingu 7.1.

<?php
function createPostString($aPostFields) {
    foreach ($aPostFields as $key => $value) {
        $aPostFields[$key] = urlencode($key) . '=' . urlencode($value);
    }
    return implode('&', $aPostFields);
}
?>

Oto skrypt wykorzystujący ją:

<?php
$postFields['zwykły_tekst'] = 'tekst1';
$postFields['e-mail'] = 'example@example.com';
$postFields['non-alfanum'] = '~!@#$%^&*()_+';
$ch = curl_init('http://localhost/curl/site.php');
curl_setopt($ch, CURLOPT_POSTFIELDS, createPostString($postFields));
curl_exec($ch);
curl_close($ch);
?>

Powyższa metoda pozwala wyłącznie na przesyłanie danych tekstowych, więc przy przesyłaniu plików będziemy musieli wykorzystać drugi, prostszy sposób - przekazanie samej tablicy. Modyfikacja skryptu z listingu 7.2 ogranicza się do usunięcia wywołania funkcji createPostString i przekazania zmiennej $postFields.

<?php
$postFields['zwykły_tekst'] = 'tekst1';
$postFields['e-mail'] = 'example@example.com';
$postFields['non-alfanum'] = '~!@#$%^&*()_+';
$ch = curl_init('http://localhost/curl/site.php');
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_exec($ch);
curl_close($ch);
?>

Niestety, nic nie jest idealne - ten sposób posiada również jedną znaczącą wadę, która wyjdzie na jaw przy wysyłaniu plików.