{"id":229050,"date":"2022-10-23T17:44:00","date_gmt":"2022-10-23T14:44:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=229050"},"modified":"2022-11-09T05:20:36","modified_gmt":"2022-11-09T02:20:36","slug":"solicitacoes-remotas-com-wp_remote_get","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/solicitacoes-remotas-com-wp_remote_get\/","title":{"rendered":"Solicita\u00e7\u00f5es Remotas com wp_remote_get"},"content":{"rendered":"\n

Se voc\u00ea leu algum dos meus posts anteriores sobre como recuperar arquivos remotos, ent\u00e3o sabe que os velhos h\u00e1bitos s\u00e3o dif\u00edceis de morrer, pois costumo usar file_get_contents<\/code>em vez de arquivos wp_remote_get<\/code>.<\/p>\n

Ent\u00e3o, como se faz ao blogar, achei que seria \u00fatil compartilhar um exemplo simples de como usar wp_remote_get<\/code>no seu dia-a-dia.<\/p>\n

O post abaixo \u00e9 apenas um trecho de como us\u00e1-lo. Ou seja, ele n\u00e3o mostrar\u00e1 como projetar, digamos, uma classe em torno dele ou uma interface do usu\u00e1rio que permita aos usu\u00e1rios fazer upload de um arquivo. Mas isso deve ser suficiente para come\u00e7ar as coisas.<\/p>\n

E incluirei como usar a documenta\u00e7\u00e3o da API e entender como aproveit\u00e1-la ao usar uma fun\u00e7\u00e3o como essa.<\/p>\n

Por que usar wp_remote_get?<\/h2>\n

Embora eu nem sempre use a API do WordPress (o que geralmente \u00e9 porque, novamente, velhos h\u00e1bitos s\u00e3o transferidos ou porque desconhe\u00e7o uma fun\u00e7\u00e3o), eu tento.<\/p>\n

E acredito firmemente que, se voc\u00ea estiver trabalhando em um ambiente espec\u00edfico de um aplicativo e esse aplicativo fornecer uma API para algo, voc\u00ea deve us\u00e1-lo.<\/p>\n

Como ler os documentos<\/h3>\n

Se voc\u00ea estiver familiarizado com como aproveitar a documenta\u00e7\u00e3o, pule esta se\u00e7\u00e3o.<\/p>\n

Com isso dito, aqui est\u00e1 o que a documenta\u00e7\u00e3o ao redor wp_remote_get<\/code>diz:<\/p>\n

\n

Recupere a resposta bruta da solicita\u00e7\u00e3o HTTP usando o m\u00e9todo GET<\/strong>. Os resultados incluem cabe\u00e7alhos e conte\u00fado HTTP.<\/p>\n<\/blockquote>\n

Voc\u00ea pode ler mais nesta p\u00e1gina no Codex<\/a> e nesta p\u00e1gina nos Recursos do desenvolvedor<\/a>. Mas antes de realmente usar a fun\u00e7\u00e3o, \u00e9 importante entender o que ela aceita e o que ela retorna.<\/p>\n

E a fun\u00e7\u00e3o aceita dois par\u00e2metros:<\/p>\n

    \n
  1. o URL para o qual a solicita\u00e7\u00e3o est\u00e1 sendo feita,<\/li>\n
  2. o conjunto de argumentos necess\u00e1rios para a solicita\u00e7\u00e3o (que est\u00e1 fora do escopo deste post).<\/li>\n<\/ol>\n

    E wp_remote_get retorna resultados mistos com base no resultado da solicita\u00e7\u00e3o. De acordo com os recursos do desenvolvedor:<\/p>\n

    \n

    (WP_Error|array) A resposta ou WP_Error em caso de falha.<\/p>\n<\/blockquote>\n

    Neste ponto, sabemos o que a fun\u00e7\u00e3o faz, o que ela aceita e o que ela retorna. Portanto, temos o suficiente para continuar em rela\u00e7\u00e3o \u00e0 cria\u00e7\u00e3o de um exemplo simples.<\/p>\n

    Usando wp_remote_get<\/h3>\n

    Com todos os itens acima, aqui est\u00e1 um exemplo simples de como recuperar um arquivo de um determinado URL. Estou assumindo que a URL est\u00e1 em seu servidor local (porque n\u00e3o quero entrar em solicitar informa\u00e7\u00f5es de outros servidores neste post) e \u00e9 por isso que o dom\u00ednio \u00e9 o TLD de ponto-local.<\/p>\n

    Os coment\u00e1rios devem explicar o que est\u00e1 acontecendo<\/a>, mas vou oferecer mais alguns pensamentos depois disso.<\/p>\n

    <?php\n\n$file = wp_remote_get( 'https:\/\/example.local\/file.png' );\nif (! isset( $file['headers'])) {\n\n  \/*\n   * TODO: You may want to return early here, display an error,\n   * or provide messaging to the user.\n   *\/\n}\n\nif (is_wp_error( $file)) {\n\n  \/*\n   * TODO: Display an error message to the user that the file they\n   * requested was not successfully retrieved.\n   *\/\n}\n\n\/* \n * Get the base directory where we'll store the file. This will just be \n * wp-content\/uploads.\n *\/\n$upload_dir   = wp_upload_dir();\n$upload_dir = trailingslashit( $upload_dir['basedir'] );\n\n\/*\n * Give the file a name that we'll use to write to disk. And\n * build the path to the file including the directory and file name.\n *\/\n$uploaded_filename = 'uploaded.png';\n$file_path         = $upload_dir. $uploaded_filename;\n\n\/*\n * Open a resource for writing the file, write the data, and then close\n * the resource.\n *\/\n$resource = fopen( $file_path, 'w' );\nfwrite( $resource, $file['body'] );\nfclose( $resource );\n<\/code><\/pre>\n
    As observa\u00e7\u00f5es mais importantes s\u00e3o as seguintes:<\/p>\n
      \n
    1. Verifique os cabe\u00e7alhos para se certificar de que est\u00e3o definidos. Caso contr\u00e1rio, n\u00e3o h\u00e1 necessidade de prosseguir com a captura do corpo do arquivo.<\/li>\n
    2. Se houver um erro, precisamos lidar com isso graciosamente.<\/li>\n
    3. Se tudo der certo, estamos prontos para gravar o arquivo no disco. Estou usando as fun\u00e7\u00f5es de arquivo do PHP para fazer isso. Est\u00e1 um pouco fora do escopo do post, mas deve ser f\u00e1cil de entender se voc\u00ea estudar os links abaixo.<\/li>\n<\/ol>\n
      Em \u00faltima an\u00e1lise, o uso wp_remote_get<\/code>oferece muitas funcionalidades envolvidas em uma fun\u00e7\u00e3o f\u00e1cil de usar.<\/p>\n
      Alguns recursos PHP<\/h2>\n