Documentazione sull'uso di cURL

cURL è uno strumento da riga di comando e una libreria per il trasferimento dei dati. Supporta numerosi protocolli, tra cui HTTP, HTTPS, FTP, ecc. cURL è molto utile nello sviluppo web, in particolare per effettuare richieste HTTP, scaricare file e chiamare API. ServBay include cURL di fabbrica, e questo documento tratterà in dettaglio l'installazione, la configurazione e l'uso di cURL.

Sommario

• Sommario
• Installazione e configurazione
  • Installazione
  • Configurazione
• Uso di base
  • Invio di una richiesta HTTP GET
  • Invio di una richiesta HTTP POST
  • Download di un file
  • Upload di un file
• Uso avanzato
  • Impostazione degli header HTTP
  • Gestione dei dati JSON
  • Gestione dei cookie
  • Uso di un proxy
  • Limitazione della banda
  • Ripresa di download interrotti
  • Verifica dei certificati SSL
• Problemi comuni
  • 1. Il comando cURL non funziona
  • 2. Si verificano errori durante l'invio delle richieste
  • 3. Fallimento nel download o nell'upload di file
  • 4. Verifica del certificato SSL fallita
• Conclusione

Installazione e configurazione

Installazione

ServBay include cURL di fabbrica, non è richiesta un'installazione aggiuntiva.

Configurazione

Non è necessaria alcuna configurazione di default.

Uso di base

cURL offre una ricca varietà di opzioni da riga di comando per varie attività di trasferimento dati. Di seguito sono riportati alcuni esempi di uso di base:

Invio di una richiesta HTTP GET

curl -X GET https://api.example.com/data

Invio di una richiesta HTTP POST

curl -X POST -d "param1=value1&param2=value2" https://api.example.com/data

Download di un file

curl -O https://example.com/file.zip

Upload di un file

curl -X POST -F "file=@/path/to/file" https://api.example.com/upload

Uso avanzato

Impostazione degli header HTTP

curl -H "Content-Type: application/json" -H "Authorization: Bearer token" https://api.example.com/data

Gestione dei dati JSON

Invio di dati JSON

curl -X POST -H "Content-Type: application/json" -d '{"key1":"value1", "key2":"value2"}' https://api.example.com/data

Ottenere e analizzare la risposta JSON (insieme a jq)

curl -s https://api.example.com/data | jq .

Gestione dei cookie

Salvare i cookie in un file

curl -c cookies.txt https://example.com

Usare un file di cookie

curl -b cookies.txt https://example.com

Uso di un proxy

curl -x http://proxy.example.com:8080 https://api.example.com/data

Limitazione della banda

curl --limit-rate 100K https://example.com/file.zip -O

Ripresa di download interrotti

curl -C - -O https://example.com/largefile.zip

Verifica dei certificati SSL

curl --cacert /path/to/ca-bundle.crt https://secure.example.com

Problemi comuni

1. Il comando cURL non funziona

• Soluzione: controllare che cURL sia installato correttamente e garantire che il percorso del file di configurazione sia corretto. Se il problema persiste, consultare i log degli errori per maggiori informazioni.

2. Si verificano errori durante l'invio delle richieste

• Soluzione: controllare che l'URL e i parametri della richiesta siano corretti. Assicurarsi che la connessione di rete sia stabile e che il server di destinazione sia raggiungibile.

3. Fallimento nel download o nell'upload di file

• Soluzione: verificare che il percorso del file e i permessi siano corretti. Assicurarsi che il server di destinazione supporti le operazioni di trasferimento dei file.

4. Verifica del certificato SSL fallita

• Soluzione: assicurarsi di usare il corretto file del certificato CA. Puoi usare l'opzione --insecure per ignorare la verifica del certificato SSL (non consigliato per ambienti di produzione).

curl --insecure https://secure.example.com

Conclusione

cURL è uno strumento da riga di comando potente e flessibile, adatto a vari compiti di trasferimento dei dati. Con questo documento, puoi imparare come installare, configurare e utilizzare cURL su ServBay per fare richieste HTTP, scaricare file e chiamare API.