Kiedy stosować curl
Użyj curl, aby sprawdzić odpowiedzi HTTP, pobrać zasób lub wywołać API z serwera. Oddziel sukces transportu od sukcesu aplikacji, ustaw rozsądne limity czasu i nie umieszczaj tokenów uwierzytelniających w zapisanych przykładach poleceń.
Składnia
curl [PARAMETERS] URLNawiasy kwadratowe oznaczają argumenty opcjonalne; wielokropek oznacza powtórzenie. Zastąp przykładowe nazwy plików, nazwy użytkowników i adresy serwerów własnymi wartościami.
Typowe opcje i argumenty
Przykłady użycia
Sprawdź nagłówki witryn
curl -I https://example.comWysyłane jest żądanie zawierające wyłącznie nagłówek; niektóre usługi obsługują to inaczej niż zwykłe żądanie treści.
Pobierz plik z przetwarzaniem błędów HTTP
curl --fail --location --output ./page.html https://example.comNastępują przekierowania, a treść odpowiedzi zastępuje nazwany plik lokalny; Stany błędów HTTP powodują awarię.
Zapytanie JSON z ograniczeniem czasowym
curl --fail --max-time 15 -H 'Accept: application/json' https://example.com/api/statusŻądana jest odpowiedź JSON z ograniczonym całkowitym czasem trwania; punkt końcowy musi faktycznie zapewniać, że API.
Uwagi i ograniczenia
- W przypadku HTTPS certyfikat jest domyślnie weryfikowany; nie wyłączaj sprawdzania przez -k bez osobnego powodu.
- Nie umieszczaj prawdziwych tokenów ani haseł w historii poleceń i nie uruchamiaj pobranych skryptów bez weryfikacji.
Często zadawane pytania i rozwiązywanie problemów
Dlaczego curl kończy się sukcesem, gdy serwer zwraca stronę błędu?
Bez opcji niepowodzenia otrzymanie odpowiedzi na błąd HTTP nadal może być liczone jako udany transfer. Sprawdź zarówno status HTTP, jak i status wyjścia polecenia.
Czy powinienem wyłączyć weryfikację certyfikatu, aby naprawić HTTPS?
Nie omijaj zaufania w ramach rutynowej naprawy. Zamiast tego sprawdź nazwę hosta, czas systemowy, łańcuch certyfikatów serwera i konfigurację zaufanego urzędu certyfikacji.
Dalsza pomoc
Opcje różnią się w zależności od wersji i dystrybucji. Sprawdź zainstalowaną dokumentację za pomocą tego polecenia: man curl.