{"id":228904,"date":"2022-10-23T17:20:00","date_gmt":"2022-10-23T14:20:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228904"},"modified":"2022-11-09T04:44:29","modified_gmt":"2022-11-09T01:44:29","slug":"requetes-a-distance-avec-wp_remote_get","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/requetes-a-distance-avec-wp_remote_get\/","title":{"rendered":"Requ\u00eates \u00e0 distance avec wp_remote_get"},"content":{"rendered":"\n

Si vous avez lu l’un de mes articles pr\u00e9c\u00e9dents sur la r\u00e9cup\u00e9ration de fichiers distants, alors vous savez que les vieilles habitudes ont la vie dure car j’utilise souvent file_get_contents<\/code>plut\u00f4t que wp_remote_get<\/code>.<\/p>\n

Donc, comme on le fait quand on blogue, j’ai pens\u00e9 qu’il serait utile de partager un exemple simple d’utilisation wp_remote_get<\/code>dans votre travail quotidien.<\/p>\n

Le message ci-dessous n’est qu’un extrait de la fa\u00e7on de l’utiliser. Autrement dit, il ne montrera pas comment concevoir, par exemple, une classe autour d’elle ou une interface utilisateur permettant aux utilisateurs de t\u00e9l\u00e9charger un fichier. Mais cela devrait suffire \u00e0 d\u00e9marrer les choses.<\/p>\n

Et j’inclurai comment utiliser la documentation de l’API et comprendre comment l’exploiter lors de l’utilisation d’une fonction comme celle-ci.<\/p>\n

Pourquoi utiliser wp_remote_get\u00a0?<\/h2>\n

Bien que je n’utilise pas toujours l’API WordPress (ce qui est g\u00e9n\u00e9ralement d\u00fb, encore une fois, \u00e0 de vieilles habitudes ou \u00e0 l’ignorance d’une fonction), j’essaie.<\/p>\n

Et je crois fermement que si vous travaillez dans l’environnement particulier d’une application et que ladite application fournit une API pour quelque chose, alors vous devriez l’utiliser.<\/p>\n

Comment lire les documents<\/h3>\n

Si vous savez comment tirer parti de la documentation, vous pouvez ignorer cette section.<\/p>\n

Cela dit, voici ce que dit la documentation wp_remote_get<\/code>:<\/p>\n

\n

R\u00e9cup\u00e9rez la r\u00e9ponse brute de la requ\u00eate HTTP \u00e0 l’aide de la m\u00e9thode GET<\/strong>. Les r\u00e9sultats incluent les en-t\u00eates et le contenu HTTP.<\/p>\n<\/blockquote>\n

Vous pouvez en savoir plus \u00e0 la fois sur cette page du Codex<\/a> et sur cette page des Ressources pour les d\u00e9veloppeurs<\/a>. Mais avant d’utiliser r\u00e9ellement la fonction, il est important de comprendre ce qu’elle accepte et ce qu’elle renvoie.<\/p>\n

Et la fonction accepte deux param\u00e8tres :<\/p>\n

    \n
  1. l’URL vers laquelle la demande est faite,<\/li>\n
  2. l’ensemble des arguments requis pour la requ\u00eate (ce qui sort du cadre de cet article).<\/li>\n<\/ol>\n

    Et wp_remote_get renvoie des r\u00e9sultats mitig\u00e9s en fonction du r\u00e9sultat de la requ\u00eate. Selon les ressources pour d\u00e9veloppeurs\u00a0:<\/p>\n

    \n

    (WP_Error|array) La r\u00e9ponse ou WP_Error en cas d’\u00e9chec.<\/p>\n<\/blockquote>\n

    \u00c0 ce stade, nous savons ce que fait la fonction, ce qu’elle accepte et ce qu’elle renvoie. Nous avons donc suffisamment de choses \u00e0 faire concernant la mise en place d’un exemple simple.<\/p>\n

    Utilisation de wp_remote_get<\/h3>\n

    Avec tout ce qui pr\u00e9c\u00e8de en place, voici un exemple simple de la fa\u00e7on de r\u00e9cup\u00e9rer un fichier \u00e0 partir d’une URL donn\u00e9e. Je suppose que l’URL se trouve sur votre serveur local (parce que je ne veux pas demander d’informations \u00e0 d’autres serveurs dans ce message), c’est pourquoi le domaine est le TLD de point-local.<\/p>\n

    Les commentaires devraient expliquer ce qui se passe<\/a>, mais je proposerai quelques r\u00e9flexions suppl\u00e9mentaires apr\u00e8s cela.<\/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
    Les remarques les plus importantes sont les suivantes\u00a0:<\/p>\n
      \n
    1. V\u00e9rifiez les en-t\u00eates pour vous assurer qu’ils sont d\u00e9finis. Si ce n’est pas le cas, il n’est pas n\u00e9cessaire de saisir le corps du fichier.<\/li>\n
    2. S’il y a une erreur, nous devons la g\u00e9rer avec \u00e9l\u00e9gance.<\/li>\n
    3. Si tout le reste est v\u00e9rifi\u00e9, nous sommes pr\u00eats \u00e0 \u00e9crire le fichier sur le disque. J’utilise les fonctions de fichier de PHP pour ce faire. C’est un peu en dehors de la port\u00e9e de l’article, mais cela devrait \u00eatre facile \u00e0 comprendre si vous \u00e9tudiez les liens ci-dessous.<\/li>\n<\/ol>\n
      En fin de compte, l’utilisation wp_remote_get<\/code>vous offre de nombreuses fonctionnalit\u00e9s int\u00e9gr\u00e9es dans une fonction facile \u00e0 utiliser.<\/p>\n
      Quelques ressources PHP<\/h2>\n