Solicitudes remotas con wp_remote_get
Si ha leído alguna de mis publicaciones anteriores sobre la recuperación de archivos remotos, entonces sabe que los viejos hábitos mueren con dificultad, ya que a menudo uso file_get_contentsen lugar de wp_remote_get.
Entonces, como uno hace cuando escribe en un blog, pensé que sería útil compartir un ejemplo simple de cómo usarlo wp_remote_geten su trabajo diario.
La publicación a continuación es simplemente un fragmento de cómo usarlo. Es decir, no mostrará cómo diseñar, digamos, una clase a su alrededor o una interfaz de usuario que permita a los usuarios cargar un archivo. Pero esto debería ser suficiente para que las cosas comiencen.
E incluiré cómo tomar la documentación de la API y entender cómo aprovecharla cuando se usa una función como esta.
¿Por qué usar wp_remote_get?
Aunque no siempre uso la API de WordPress (que suele ser porque, de nuevo, los viejos hábitos se mantienen o porque desconozco una función), lo intento.
Y creo firmemente que si está trabajando en el entorno particular de una aplicación y dicha aplicación proporciona una API para algo, entonces debe usarla.
Cómo leer los documentos
Si está familiarizado con cómo aprovechar la documentación, puede omitir esta sección.
Dicho esto, esto es lo que wp_remote_getdice la documentación:
Recupere la respuesta sin procesar de la solicitud HTTP utilizando el método GET . Los resultados incluyen encabezados y contenido HTTP.
Puede leer más en esta página del Codex y en esta página de Recursos para desarrolladores. Pero antes de usar la función, es importante comprender qué acepta y qué devuelve.
Y la función acepta dos parámetros:
- la URL a la que se realiza la solicitud,
- el conjunto de argumentos requeridos para la solicitud (que está fuera del alcance de esta publicación).
Y wp_remote_get devuelve resultados mixtos según el resultado de la solicitud. Según los recursos del desarrollador:
(WP_Error|array) La respuesta o WP_Error en caso de falla.
En este punto, sabemos qué hace la función, qué acepta y qué devuelve. Así que tenemos suficiente para seguir con respecto a la configuración de un ejemplo simple.
Usando wp_remote_get
Con todo lo anterior en su lugar, aquí hay un ejemplo simple de cómo recuperar un archivo de una URL determinada. Supongo que la URL está en su servidor local (porque no quiero solicitar información de otros servidores en esta publicación), razón por la cual el dominio es el TLD de dot-local.
Los comentarios deberían explicar qué pasa, pero ofreceré algunas ideas más después de eso.
Las cosas más importantes a tener en cuenta son las siguientes:
- Verifique los encabezados para asegurarse de que estén configurados. De lo contrario, no hay necesidad de continuar con la captura del cuerpo del archivo.
- Si hay un error, entonces debemos manejarlo con gracia.
- Si todo lo demás funciona, entonces estamos listos para escribir el archivo en el disco. Estoy usando las funciones de archivo de PHP para hacer esto. Está un poco fuera del alcance de la publicación, pero debería ser fácil de entender si estudia los enlaces a continuación.
En última instancia, el uso wp_remote_getle brinda una gran cantidad de funciones envueltas en una función fácil de usar.