Richieste remote con wp_remote_get
Se hai letto uno dei miei post precedenti sul recupero di file remoti, allora sai che le vecchie abitudini sono dure a morire perché io uso spesso file_get_contentspiuttosto che wp_remote_get.
Quindi, come si fa quando si blogga, ho pensato che sarebbe stato utile condividere un semplice esempio di come utilizzarlo wp_remote_getnel lavoro quotidiano.
Il post qui sotto è solo un frammento di come usarlo. Cioè, non mostrerà come progettare, ad esempio, una classe attorno ad esso o un’interfaccia utente che consenta agli utenti di caricare un file. Ma questo dovrebbe essere sufficiente per iniziare le cose.
E includerò come prendere la documentazione dell’API e capire come sfruttarla quando si utilizza una funzione come questa.
Perché usare wp_remote_get?
Anche se non utilizzo sempre l’API di WordPress (che di solito è perché, ancora una volta, le vecchie abitudini si ripetono o perché non sono a conoscenza di una funzione), ci provo.
E credo fermamente che se stai lavorando in un particolare ambiente di un’applicazione e detta applicazione fornisce un’API per qualcosa, dovresti usarla.
Come leggere i documenti
Se hai familiarità con come sfruttare la documentazione, puoi saltare questa sezione.
Detto questo, ecco cosa wp_remote_getdice la documentazione in giro:
Recupera la risposta grezza dalla richiesta HTTP utilizzando il metodo GET . I risultati includono intestazioni e contenuto HTTP.
Puoi leggere di più sia su questa pagina nel Codex che su questa pagina nelle Risorse per gli sviluppatori. Ma prima di utilizzare effettivamente la funzione, è importante capire cosa accetta e cosa restituisce.
E la funzione accetta due parametri:
- l’URL a cui viene inoltrata la richiesta,
- l’insieme degli argomenti richiesti per la richiesta (che esula dallo scopo di questo post).
E wp_remote_get restituisce risultati misti in base all’esito della richiesta. Secondo le risorse per gli sviluppatori:
(WP_Error|array) La risposta o WP_Error in caso di errore.
A questo punto, sappiamo cosa fa la funzione, cosa accetta e cosa restituisce. Quindi abbiamo abbastanza per andare avanti per quanto riguarda la creazione di un semplice esempio.
Usando wp_remote_get
Con tutto quanto sopra in atto, ecco un semplice esempio di come recuperare un file da un determinato URL. Presumo che l’URL sia sul tuo server locale (perché non voglio entrare nella richiesta di informazioni da altri server in questo post), motivo per cui il dominio è il TLD di dot-local.
I commenti dovrebbero spiegare cosa sta succedendo, ma dopo offrirò alcuni pensieri in più.
Le cose più importanti da notare sono le seguenti:
- Controlla le intestazioni per assicurarti che siano impostate. In caso contrario, non è necessario procedere con l’acquisizione del corpo del file.
- Se c’è un errore, allora dobbiamo gestirlo con grazia.
- Se tutto il resto va a buon fine, allora siamo pronti per scrivere il file su disco. Sto usando le funzioni di file di PHP per farlo. È un po’ fuori dallo scopo del post, ma dovrebbe essere facile da capire se studi i link sottostanti.
In definitiva, l’utilizzo wp_remote_getti offre molte funzionalità racchiuse in una funzione facile da usare.