Wykonywanie poleceń

Poza przeglądaniem katalogów i wymianą plików, FTP oferuje dodatkowe możliwości, z których nieraz chcielibyśmy skorzystać. Nie zostały one jednak zaimplementowane jako ustawienia transferu. Z pomocą przychodzą nam dwie opcje służące do bezpośredniego wywołania komend FTP: CURLOPT_QUOTE i CURLOPT_POSTQUOTE. Jako wartości przyjmują tablice z kolejnymi poleceniami do wykonania.

Kolejność wykonywania poleceń

Warto zdać sobie sprawę z tego, w którym momencie komendy zostaną wysłane przez cURL, gdyż nieznajomość tego zachowania może przysporzyć niemałych kłopotów. Najlepiej zilustruje to przykład.

$ch = curl_init('ftp://login:haslo@example.com/folder/');
curl_setopt($ch, CURLOPT_QUOTE, array('CWD katalog'));
curl_setopt($ch, CURLOPT_POSTQUOTE, array('CWD podkatalog'));
curl_exec($ch);
curl_close($ch);

Niektórych może zdziwić wynik działania powyższego kodu, lecz jest to zachowanie całkowicie poprawne. Wpierw cURL łączy się z serwerem FTP. Po nazwiązaniu połączenia wykonywane są polecenia przypisane do CURLOPT_QUOTE, czyli w tym przypadku zmiana folderu na 'katalog'. Następnie wykonywane są działania podjęte przez samą bibliotekę zostaje wysłane polecenie CWD folder. Jest to zachowanie dosyć niespodziewane, gdyż bardziej logicznym wynikiem byłoby wykonanie komendy CWD /folder. W tej chwili znajdujemy się w katalogu /katalog/folder/ na serwerze. Client URL Library wysyła polecenie wyświetlenia listy plików znajdujących się w obecnej gałęzi. Po otrzymaniu indeksu folderu /katalog/folder/ przechodzimy do poleceń przypisanych do CURLOPT_POSTQUOTE. Następuje zmiana folderu na /katalog/folder/podfolder/. Na liście nie ma komend do wykonania, więc biblioteka zamyka połączenie.

Przydatne polecenia

Dzięki możliwości wysyłania poleceń jesteśmy w stanie wykonywać dowolne działania na serwerze (o ile posiadamy do tego uprawnienia). Oto kilka najbardziej pożytecznych przykładów.

curl_setopt($ch, CURLOPT_QUOTE, array('CDUP'));

curl_setopt($ch, CURLOPT_QUOTE, array('RNFR stara_nazwa',
                                      'RNTO kat/nowa_nazwa'));

curl_setopt($ch, CURLOPT_QUOTE, array('DELE nazwa_pliku'));

curl_setopt($ch, CURLOPT_QUOTE, array('MKD kat/podkat'));

curl_setopt($ch, CURLOPT_QUOTE, array('RMD katalog'));

Przed usunięciem folderu należy upewnić się, czy jest on pusty, gdyż w przeciwnym wypadku polecenie zakończy się niepowodzeniem.