Un aperçu de l'API HTTP WordPress un bref aperçu de wp_remote_post

Dans la première série sur l'API HTTP WordPress, nous avons examiné wp_remote_get. Plus précisément, nous avons examiné les aspects suivants de l’API:

  • Un aperçu de la fonction
  • Un exemple pratique de celui-ci
  • Comment gérer la réponse
  • Et comprendre les arguments de la fonction

Nous allons continuer la série sur l'API HTTP WordPress, mais nous allons nous intéresser à une deuxième méthode de l'API: wp_remote_post.

Tout au long de la prochaine série d’articles, nous examinerons la fonction pour comprendre ce qu’elle offre et pourquoi elle est utile, un exemple pratique de la manière de l’intégrer à notre travail, ainsi que de comprendre les fonctions et la réponse qui vient de la fonction.

Cela dit, commençons notre étude de la fonction.


Requêtes à distance: une actualisation

Si vous n’avez pas suivi jusqu’à présent, je vous recommande vivement de consulter le tout premier message de la série pour au moins comprendre les bases de la OBTENIR demande le travail.

Honnêtement, POSTER les demandes ne sont pas si différentes. Tout comme OBTENIR les requêtes sont généralement utilisées pour extraire des informations du serveur, POSTER les requêtes sont généralement destinées à envoyer des messages au serveur.

Mais voici la chose: les deux protocoles sont capables d'envoyer des données et recevoir des données, mais voici une règle générale sur la façon dont j'aborde généralement les requêtes GET et POST.

  • OBTENIR les demandes sont généralement utilisées pour récupérer informations du serveur, donc une réponse est attendue
  • POSTER les demandes sont généralement utilisées pour envoyer informations au serveur, et bien qu'une réponse ne soit pas attendue, il est toujours bon de savoir si le serveur a reçu et traité la réponse correctement ou non

Dans le reste des articles de cette partie de la série, nous examinerons comment gérer les deux cas - c'est-à-dire, comment gérer lorsqu'une réponse n'est pas donnée et comment gérer une réponse est donné.


Un résumé de la manière dont les demandes sont faites

Maintenant, en ce qui concerne les requêtes au niveau du serveur - en particulier en PHP -, elles sont généralement effectuées avec les deux fonctions suivantes (sauf si vous utilisez une bibliothèque tierce en dehors du champ de cette série).

Bien que nous ayons couvert ces derniers plus en détail dans le premier post, je vais les résumer ici.

  • fichier_get_contents accepte une URL en tant que paramètre et renverra les données demandées ou une valeur false en cas d'échec. C'est un moyen relativement courant de récupérer des données pour des requêtes à distance.
  • boucle est une bibliothèque complète (plutôt qu'une fonction) qui fournit des options de configuration complètes que les développeurs peuvent adapter à leurs besoins. Il y a beaucoup à apprendre sur cette bibliothèque. Si vous êtes un développeur avancé, consultez certainement cURL.

Pour l’essentiel, il est assez facile de comprendre comment les demandes sont faites, mais le degré avec lequel vous modifiez Comment les demandes sont faites est complètement dépendante de l'option que vous choisissez d'utiliser - c'est, fichier_get_contents ou boucle.

Bien sûr, il s’agit plus de la manière dont PHP exécute les requêtes et bien que nous puissions l’implémenter dans certains de nos travaux en fonction de la nature du projet, cela ne couvre pas nécessairement la façon dont WordPress le fait..

En fait, ce qui précède est un bref rappel basé sur le contenu précédent. Néanmoins, il est important de comprendre d'où nous venons, ce qui est disponible et où nous nous dirigeons.


Comment POSTER Les demandes sont faites dans WordPress

Comme mentionné, les notes ci-dessus sont beaucoup plus étroitement liées à PHP, jetons donc un coup d'œil à POSTER requêtes dans le contexte de WordPress.

Et si vous êtes amené à créer des projets pour WordPress ou des produits sur WordPress, il est important de comprendre les API disponibles pour vous assurer de ne pas perdre un type de fonctionnalité ou de fonctionnalité avec une mise à niveau vers le noyau. Application WordPress.

Ainsi, tout comme nous avons examiné les normes de codage WordPress pour passer en revue les meilleures pratiques d'écriture de code WordPress, nous allons maintenant examiner les API disponibles pour l'écriture. POSTER demandes utilisant les meilleures pratiques.

Pour cela, entrez wp_remote_post.

La fonction accepte deux arguments:

  • L'URL à laquelle la demande sera faite
  • Un tableau d'arguments permettant de personnaliser la demande au serveur.

Bien que la gamme d'arguments soit quelque peu en dehors du cadre de ce que nous allons faire dans cette série, il est important de comprendre ce qui est disponible, en particulier si vous envisagez de faire un travail plus avancé à l'avenir:

  • méthode fait référence à la méthode utilisée pour la demande. Nous utilisons évidemment POSTER compte tenu de la nature de notre méthode API.
  • temps libre C'est combien de temps vous êtes prêt à attendre pour que la demande soit traitée avant d'abandonner. La valeur par défaut est cinq secondes, mais cela peut être diminué ou augmenté en fonction de la nature de votre application..
  • redirection cela ressemble à l'URL vers laquelle vous seriez redirigé une fois la demande terminée, n'est-ce pas? Au lieu de cela, c’est une unité de temps - en secondes - d’attendre une redirection avant d’abandonner la demande..
  • agent utilisateur nous permet de contrôler l'agent utilisateur qui est envoyé avec la demande. Il s’agit généralement de WordPress et du numéro de version, mais il est évidemment personnalisable.
  • blocage En bref, si la valeur est true, le script continue de s'exécuter jusqu'à ce que le serveur renvoie quelque chose. sinon, le script continuera à fonctionner sans bloquer le reste de votre application. Certes, cela se fait aux dépens de la possibilité de ne jamais recevoir de réponse, mais cela dépend de la situation dans laquelle vous vous préparez..
  • compresse a été introduit dans WordPress 2.6 et vous permet d’envoyer le corps de la requête dans un format compressé. Ce sera en dehors du champ de nos futurs articles.
  • décompresser est similaire à compresser, sauf que c'est de notre côté - si des données compressées sont reçues, cela nous permettra de décompresser le contenu avant tout travail ou traitement ultérieur..
  • sslverify a été introduit dans WordPress 2.8 et est utile pour les scénarios dans lesquels vous devez vérifier si une certification SSL est valide. Si ce n'est pas le cas, la demande est refusée. sinon, vous êtes prêt à partir. Cette option sortira également du cadre de cet ensemble d'articles..

De toute évidence, il y a beaucoup de choses qui sont disponibles. J'espère pouvoir examiner certains de ces articles plus en détail au cours des prochains articles, mais examinons tout d'abord un exemple très simple et pratique d'utilisation de la fonction API..


Let's POSTER une requête

À ce stade, les choses devraient être suffisamment claires, non? En utilisant wp_remote_post devrait être aussi simple que d'utiliser wp_remote_get donc à partir du prochain article, nous allons faire exactement cela.

Jusque-là, assurez-vous d'avoir passé en revue tous les articles ayant conduit à ce point et laissez s'il vous plaît des commentaires et / ou des questions à ce message en particulier dans les commentaires..

Ensuite, nous allons travailler!