{"id":230387,"date":"2022-11-28T16:03:00","date_gmt":"2022-11-28T13:03:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=230387"},"modified":"2022-11-09T22:09:23","modified_gmt":"2022-11-09T19:09:23","slug":"une-introduction-a-la-reflexion-en-php-et-comment-cela-joue-dans-les-tests-unitaires","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/fr\/une-introduction-a-la-reflexion-en-php-et-comment-cela-joue-dans-les-tests-unitaires\/","title":{"rendered":"Une introduction \u00e0 la r\u00e9flexion en PHP (et comment cela joue dans les tests unitaires)"},"content":{"rendered":"\n

Au cours des derni\u00e8res semaines, j’ai \u00e9crit sur les tests unitaires<\/a><\/strong> pour les membres<\/a><\/strong> du site (et quelque chose que je pr\u00e9vois de continuer \u00e0 faire dans le prochain article). C’est quelque chose que je pense; si vous \u00e9crivez du code c\u00f4t\u00e9 serveur, vous devriez le faire.<\/p>\n

Bien s\u00fbr, c’est plus facile pour moi de le dire que de le faire, donc m\u00eame si j’essaie de faire du bon travail, il y a toujours de la place pour que je m’am\u00e9liore. Je dis cela plus comme une v\u00e9rification personnelle qu’autre chose, alors je m’\u00e9loigne du sujet.<\/p>\n

L’un des concepts qui revient souvent lors des tests est l’id\u00e9e de tester les valeurs des attributs priv\u00e9s. Par exemple, disons que vous avez un setter, mais vous n’avez pas n\u00e9cessairement un getter pour cette valeur particuli\u00e8re.<\/p>\n

Il est facile de dire "Eh bien, alors vous devez \u00e9crire un getter", mais ce n’est pas toujours le cas. Je veux dire, que se passe-t-il si vous stockez des informations dans la classe qui n’ont pas besoin d’\u00eatre expos\u00e9es \u00e0 des classes tierces ?<\/p>\n

Comment alors sommes-nous cens\u00e9s \u00e9crire des tests sur ce type de donn\u00e9es lorsque nous voulons y acc\u00e9der mais que nous n’en avons pas la capacit\u00e9 et que nous ne voulons pas compromettre l’int\u00e9grit\u00e9 de notre travail\u00a0?<\/p>\n

C’est l\u00e0 que la r\u00e9flexion entre en jeu.<\/p>\n

R\u00e9flexion en PHP<\/h2>\n

Plus pr\u00e9cis\u00e9ment, pour comprendre comment inspecter la valeur d’une variable donn\u00e9e de l’ext\u00e9rieur vers l’int\u00e9rieur, il faut savoir utiliser la r\u00e9flexion.<\/p>\n

Heureusement, PHP nous fournit une API puissante pour le faire, et cela vaut probablement la peine d’entrer dans les d\u00e9tails dans un autre article. Mais, pour celui-ci, s’en tenir \u00e0 l’essentiel.<\/p>\n

Une d\u00e9finition de travail<\/h3>\n

Tout d’abord, un regard sur ce que signifie la r\u00e9flexion. Le manuel PHP le d\u00e9finit ainsi<\/a><\/strong> :<\/p>\n

\n

La classe ReflectionClass<\/strong> rapporte des informations sur une classe.<\/p>\n<\/blockquote>\n

Mais je pense que \u00e7a vaut la peine d’avoir quelque chose d’un peu plus solide. Allons-y avec quelque chose comme \u00e7a au moins pour ce post:<\/p>\n

\n

La r\u00e9flexion est la fa\u00e7on dont un programme s’inspecte et se modifie pendant l’ex\u00e9cution.<\/p>\n<\/blockquote>\n

Ce n’est peut-\u00eatre pas g\u00e9nial; peut \u00eatre pas.<\/p>\n

\"Une<\/a><\/p>\n

Mais cela servira l’objectif de ce post.<\/p>\n

Lire une valeur par r\u00e9flexion<\/h3>\n

Supposons que pour cet article, vous ayez une classe d’espaces de noms sur AcmePluginAPIClient<\/strong> et qu’elle ait une propri\u00e9t\u00e9 appel\u00e9e username<\/strong>. Nous verrons plus tard \u00e0 quoi pourrait ressembler une impl\u00e9mentation tr\u00e8s basique de ceci.<\/p>\n

Bien s\u00fbr, ce serait beaucoup plus \u00e9toff\u00e9 dans un plugin r\u00e9el.<\/p>\n

Supposons cependant que vous souhaitiez d\u00e9finir la valeur de l’attribut, puis lire sa valeur. La mise en garde est que la propri\u00e9t\u00e9 est marqu\u00e9e comme priv\u00e9e<\/strong> et qu’il n’y a aucun moyen de la lire de l’ext\u00e9rieur.<\/p>\n

C’est l\u00e0 que la r\u00e9flexion devient utile. Autrement dit, nous pouvons utiliser une partie du programme pour se regarder et rendre compte de ce qu’il voit. (R\u00e9flexion, compris\u00a0? C’est comme quand nous voulons savoir ce qui se passe avec nous-m\u00eames et que personne d’autre n’est l\u00e0, alors nous nous regardons dans un miroir et voyons ce qu’il y a.)<\/p>\n

Pour ce faire, vous devez faire cinq choses :<\/p>\n

    \n
  1. Instanciez la classe que vous souhaitez tester,<\/li>\n
  2. D\u00e9finissez la valeur de la variable,<\/li>\n
  3. Prenez une instance de ReflectionClass<\/strong> pour la classe que nous voulons tester,<\/li>\n
  4. D\u00e9finissez sa propri\u00e9t\u00e9 sur accessible,<\/li>\n
  5. Lisez la valeur.<\/li>\n<\/ol>\n

    Voici donc une s\u00e9rie d’essentiels qui fourniront les \u00e9tapes n\u00e9cessaires pour faire exactement cela.<\/p>\n

    1 Instancier la classe<\/a><\/h4>\n
    <?php\n\nnamespace AcmePlugin;\n\nclass APIClient\n{\n  private $username;\n\n  \/\/ Other functions for class implementation...\n}\n<\/code><\/pre>\n
    2 D\u00e9finissez la valeur<\/a><\/h4>\n
    <?php\n\nnamespace AcmePlugin;\n\nclass APIClient\n{\n  private $username;\n\n  public function setUsername($username)\n  {\n    $this->username = $username;\n  }\n\n  \/\/ Other functions for class implementation...\n}\n<\/code><\/pre>\n
    3 Instancier les objets r\u00e9fl\u00e9chis<\/a><\/h4>\n
    <?php\n\nnamespace AcmePluginTests;\n\nuse AcmePluginAPIAPIClient;\n\nclass APIClientTest\n{\n  public function setUsername()\n  {\n\n    \/\/ Instantiate the class.\n    $client = new APIClient();\n    $username = 'tommcfarlin';\n    $client->setUsername($username);\n\n    \/\/ Now get a reflected instance of the class.\n    $reflectedClient = new ReflectionClass('AcmePluginAPIAPIClient');\n\n    \/\/ More to come...\n  }\n}\n<\/code><\/pre>\n
    4. D\u00e9finissez la propri\u00e9t\u00e9, marquez-la comme accessible<\/a><\/h4>\n
    <?php\n\nnamespace AcmePluginTests;\n\nuse AcmePluginAPIAPIClient;\n\nclass APIClientTest\n{\n  public function setUsername()\n  {\n\n    \/\/ Instantiate the class.\n    $client = new APIClient();\n    $username = 'tommcfarlin';\n    $client->setUsername($username);\n\n    \/\/ Now get a reflected instance of the class.\n    $reflectedClient = new ReflectionClass('AcmePluginAPIAPIClient');\n    $usernameProperty = new ReflectionObject($client);\n    $usernameProperty->setAccessible(true);\n\n    \/\/ More to come...\n  }\n}\n<\/code><\/pre>\n
    5 Lisez la valeur<\/a><\/h4>\n
    <?php\n\nnamespace AcmePluginTests;\n\nuse AcmePluginAPIAPIClient;\n\nclass APIClientTest\n{\n  public function setUsername()\n  {\n\n    \/\/ Instantiate the class.\n    $client = new APIClient();\n    $username = 'tommcfarlin';\n    $client->setUsername($username);\n\n    \/\/ Now get a reflected instance of the class.\n    $reflectedClient = new ReflectionClass('AcmePluginAPIAPIClient');\n\n    \/\/ Grab a reference to the private property by making it accessible.\n    $usernameProperty = new ReflectionObject($client);\n    $usernameProperty->setAccessible(true);\n\n    \/\/ And finally, read it's value.\n    $usernameValue = $usernameProperty->getValue($client);\n  }\n}\n<\/code><\/pre>\n
    Et c’est l’amorce de base sur la r\u00e9flexion<\/h2>\n
    \u00c0 ce stade, cela devrait vous donner quelques informations de base sur ce qu’est Reflection, comment l’utiliser et pourquoi il est utile, en particulier dans le cas des tests unitaires<\/a><\/strong>.<\/p>\n
    C’est l’un de ces concepts qui peuvent devenir plus complexes car l’API de r\u00e9flexion de PHP est assez puissante (mais relativement facile \u00e0 comprendre). Cependant, lorsque vous le couplez avec des tests unitaires, il y a beaucoup de choses qui peuvent \u00eatre faites.<\/p>\n
    Ma prise sans vergogne<\/h3>\n
    Cela dit, si vous souhaitez apprendre les tenants et les aboutissants de ce genre de choses, n’h\u00e9sitez pas \u00e0 consulter la zone r\u00e9serv\u00e9e aux membres<\/a><\/strong> du site. Je construis, chaque semaine, un carnet de commandes<\/a><\/strong> pour nous aider \u00e0 nous concentrer sur l’adoption de meilleures pratiques en tant que d\u00e9veloppeurs WordPress.<\/p>\n
    Les tests unitaires, la r\u00e9flexion et plus encore ne sont que la derni\u00e8re partie de celui-ci.<\/p>\n
    Source d’enregistrement:  tommcfarlin.com<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"
    Comprendre les bases de la r\u00e9flexion en PHP peut aider \u00e0 rendre votre programmation, en particulier les tests, beaucoup plus facile.<\/p>\n","protected":false},"author":1,"featured_media":164037,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[893,717,801],"tags":[1167],"class_list":["post-230387","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-code-2","category-developpeur","category-php-3","tag-affiai-fr"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/230387","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/comments?post=230387"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/posts\/230387\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media\/164037"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/media?parent=230387"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/categories?post=230387"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/fr\/wp-json\/wp\/v2\/tags?post=230387"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}