Solicitações Remotas com wp_remote_get
Se você leu algum dos meus posts anteriores sobre como recuperar arquivos remotos, então sabe que os velhos hábitos são difíceis de morrer, pois costumo usar file_get_contentsem vez de arquivos wp_remote_get.
Então, como se faz ao blogar, achei que seria útil compartilhar um exemplo simples de como usar wp_remote_getno seu dia-a-dia.
O post abaixo é apenas um trecho de como usá-lo. Ou seja, ele não mostrará como projetar, digamos, uma classe em torno dele ou uma interface do usuário que permita aos usuários fazer upload de um arquivo. Mas isso deve ser suficiente para começar as coisas.
E incluirei como usar a documentação da API e entender como aproveitá-la ao usar uma função como essa.
Por que usar wp_remote_get?
Embora eu nem sempre use a API do WordPress (o que geralmente é porque, novamente, velhos hábitos são transferidos ou porque desconheço uma função), eu tento.
E acredito firmemente que, se você estiver trabalhando em um ambiente específico de um aplicativo e esse aplicativo fornecer uma API para algo, você deve usá-lo.
Como ler os documentos
Se você estiver familiarizado com como aproveitar a documentação, pule esta seção.
Com isso dito, aqui está o que a documentação ao redor wp_remote_getdiz:
Recupere a resposta bruta da solicitação HTTP usando o método GET. Os resultados incluem cabeçalhos e conteúdo HTTP.
Você pode ler mais nesta página no Codex e nesta página nos Recursos do desenvolvedor. Mas antes de realmente usar a função, é importante entender o que ela aceita e o que ela retorna.
E a função aceita dois parâmetros:
- o URL para o qual a solicitação está sendo feita,
- o conjunto de argumentos necessários para a solicitação (que está fora do escopo deste post).
E wp_remote_get retorna resultados mistos com base no resultado da solicitação. De acordo com os recursos do desenvolvedor:
(WP_Error|array) A resposta ou WP_Error em caso de falha.
Neste ponto, sabemos o que a função faz, o que ela aceita e o que ela retorna. Portanto, temos o suficiente para continuar em relação à criação de um exemplo simples.
Usando wp_remote_get
Com todos os itens acima, aqui está um exemplo simples de como recuperar um arquivo de um determinado URL. Estou assumindo que a URL está em seu servidor local (porque não quero entrar em solicitar informações de outros servidores neste post) e é por isso que o domínio é o TLD de ponto-local.
Os comentários devem explicar o que está acontecendo, mas vou oferecer mais alguns pensamentos depois disso.
As observações mais importantes são as seguintes:
- Verifique os cabeçalhos para se certificar de que estão definidos. Caso contrário, não há necessidade de prosseguir com a captura do corpo do arquivo.
- Se houver um erro, precisamos lidar com isso graciosamente.
- Se tudo der certo, estamos prontos para gravar o arquivo no disco. Estou usando as funções de arquivo do PHP para fazer isso. Está um pouco fora do escopo do post, mas deve ser fácil de entender se você estudar os links abaixo.
Em última análise, o uso wp_remote_getoferece muitas funcionalidades envolvidas em uma função fácil de usar.