Chacun des \u00e9l\u00e9ments ci-dessus est destin\u00e9 \u00e0 fournir une introduction sur la fa\u00e7on de commencer \u00e0 \u00e9crire des tests unitaires tr\u00e8s basiques. Les choses peuvent devenir plus complexes, surtout \u00e0 mesure qu’une application ou un projet grandit (mais c’est toujours vrai, non\u00a0?).<\/p>\n
Mais pour s’assurer que l’on est pr\u00e9par\u00e9 pour cela, il y a un dernier composant des tests unitaires sur lequel je pense que nous devrions nous concentrer et c’est comprendre le fichier de configuration PHPUnit XML (que vous avez peut-\u00eatre vu dans d’autres projets comme phpunit.xml).<\/p>\n
Configuration XML de PHPUnit<\/h2>\n
Donc, dans cet article, je vais configurer un projet simple qui utilise PHPUnit, \u00e9crit quelques tests comme ceux que nous avons d\u00e9j\u00e0 vus et exploite un fichier de configuration pour automatiser les tests.<\/p>\n
De plus, je vais faire ce que je peux pour expliquer au mieux les parties n\u00e9cessaires du fichier de configuration afin que vous puissiez en inclure un dans votre prochain projet.<\/p>\n
1 \u00c9craser les fichiers<\/h3>\n
Avant de se lancer dans l’\u00e9criture de code testable, il est important de conna\u00eetre les fichiers qui seront n\u00e9cessaires pour faire fonctionner le processus.<\/p>\n
Voici, plus ou moins, comment nous<\/a><\/strong> organisons les choses d\u00e8s le d\u00e9but d’un projet\u00a0:<\/p>\n Finalement, vous verrez \u00e9galement :<\/p>\n \u00c0 ce stade, cependant, examinons le fichier de configuration XML, puis essayons d’ex\u00e9cuter PHPUnit automatiquement sans aucun autre param\u00e8tre.<\/p>\n Examinons d’abord le fichier de configuration de base\u00a0:<\/a><\/strong><\/p>\n Comprenons maintenant ce que nous examinons exactement (autre que le simple XML).<\/p>\n Cela dit, notre fichier XML contient tout ce dont PHPUnit a besoin pour fonctionner sans aucun autre param\u00e8tre.<\/p>\n N’oubliez pas, cependant, avant de passer au reste de cet article, je suppose que vous avez globalement install\u00e9 PHPUnit sur votre syst\u00e8me \u00e0 l’aide de Composer. Si ce n’est pas le cas, consultez cet article<\/a><\/strong> car il vous fournira des instructions sur la fa\u00e7on de le faire.<\/p>\n Une fois cela fait, vous pouvez v\u00e9rifier que PHPUnit est install\u00e9 en saisissant la commande suivante dans votre terminal\u00a0:<\/p>\n Et vous devriez voir quelque chose comme ceci :<\/p>\n<\/p>\n Si vous voyez quelque chose comme ci-dessus, vous pouvez ex\u00e9cuter PHPUnit n’importe o\u00f9 depuis votre syst\u00e8me.<\/p>\n Avant d’aller plus loin, \u00e9crivons un fichier d’amor\u00e7age de base. Nous l’appellerons bootstrap.php<\/strong> et le d\u00e9poserons dans notre r\u00e9pertoire de tests<\/strong>. Il comprendra les \u00e9l\u00e9ments suivants\u00a0:<\/a><\/strong><\/p>\n Il s’agit d’un simple "chargeur automatique" (que je l’appelle avec h\u00e9sitation \u00e9tant donn\u00e9 qu’il ne fait qu’it\u00e9rer dans les fichiers et les exiger, mais cela fonctionne pour nos besoins).<\/p>\n \u00c0 ce stade, mettons en place un test de base.<\/p>\n Si vous lisez quelque chose sur le d\u00e9veloppement pilot\u00e9 par les tests, vous entendrez probablement parler du cycle de r\u00e9p\u00e9tition rouge-vert. Il y a beaucoup \u00e0 dire \u00e0 ce sujet et je vous recommande de le lire<\/a><\/strong>, mais ce n’est pas le but de cet article.<\/p>\n Au lieu de cela, nous nous concentrons davantage sur l’\u00e9criture de tests qui correspondent \u00e0 ce que nous devons faire, n’est-ce pas\u00a0? Cela dit, proc\u00e9dons comme suit\u00a0:<\/p>\n Maintenant, depuis le Terminal, changez de r\u00e9pertoire dans le r\u00e9pertoire du projet (ce qui fait certes d\u00e9faut, pour l’instant) puis lancez simplement php<\/em><\/strong> unit<\/em> :<\/p>\n En supposant que tout est configur\u00e9 correctement, vous devriez voir quelque chose comme ceci :<\/p>\n Puisque nous n’avons ni code ni tests, nous allons naturellement voir la sortie ci-dessus, n’est-ce pas\u00a0? \u00c9crivons donc un seul test qui s’ex\u00e9cutera (et \u00e9chouera) car il n’y a pas de code \u00e0 tester.<\/p>\n Tout d’abord, dans le r\u00e9pertoire tests<\/strong>, cr\u00e9ez un fichier appel\u00e9 AcmeCacheTest.php.<\/strong> Et faisons quelque chose de simple comme instancier un objet cache<\/a><\/strong> que nous cr\u00e9erons \u00e9ventuellement.<\/p>\n Avant d’ex\u00e9cuter le test, notez que nous\u00a0:<\/p>\n Cela fait partie de ce qui rend l’utilisation de PHPUnit si facile. Une fois cela fait, ex\u00e9cutez le code suivant \u00e0 partir de la racine de votre projet\u00a0:<\/p>\n Apr\u00e8s cela, vous devriez voir ce qui suit\u00a0:<\/p>\n Notez que cela donnera un test d’\u00e9chec et il vous indiquera o\u00f9<\/strong> le probl\u00e8me a \u00e9t\u00e9 trouv\u00e9, le fichier et la ligne.<\/p>\n Pour r\u00e9soudre ce probl\u00e8me, nous devons \u00e9crire une classe\u00a0:<\/a><\/strong><\/p>\n Le test de r\u00e9ussite de base (qui sera bas\u00e9 sur le code pr\u00e9c\u00e9dent) comprendra les \u00e9l\u00e9ments suivants\u00a0:<\/p>\n Tout d’abord, testons que nous sommes capables de configurer la classe et qu’elle n’est pas nulle. C’est un peu une affirmation inutile puisque nous savons que nous aurons une classe correctement instanci\u00e9e, mais cela nous plonge dans le rythme de l’\u00e9criture de tests\u00a0:<\/a><\/strong><\/p>\n Et lancez le test :<\/p>\n Ensuite, v\u00e9rifions que la valeur par d\u00e9faut du cache est d\u00e9finie\u00a0:<\/a><\/strong><\/p>\n Comme pour l’\u00e9tape pr\u00e9c\u00e9dente, ex\u00e9cutez les tests et vous devriez maintenant voir deux tests r\u00e9ussis\u00a0:<\/p>\n Enfin, testons pour voir si nous sommes capables de changer la valeur avec succ\u00e8s\u00a0:<\/a><\/strong><\/p>\n Et les trois derniers tests de r\u00e9ussite\u00a0:<\/p>\n Et voila:<\/p>\n Certes, c’est simple, mais cela pose les bases de bien plus que ce que beaucoup de gens font d\u00e9j\u00e0 avec leurs tests.<\/p>\n De plus, cela vous donne quelque chose sur quoi vous appuyer au fur et \u00e0 mesure que vos c\u00f4telettes de test se renforcent.<\/p>\n Enfin, si vous souhaitez vraiment vous plonger dans le fichier de configuration, vous pouvez lire l’ explication d\u00e9taill\u00e9e du manuel \u00e0 ce sujet.<\/a><\/strong><\/p>\n Notez, cependant, que tout ce qui est d\u00e9crit ci-dessus vise \u00e0 \u00eatre ce dont vous avez besoin pour commencer \u00e0 configurer votre propre fichier de configuration PHPUnit XML.<\/p>\n\n
\n
2 Les bases du fichier de configuration<\/h3>\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n\n<!-- http:\/\/phpunit.de\/manual\/4.1\/en\/appendixes.configuration.html -->\n<phpunit xmlns:xsi=\"http:\/\/www.w3.org\/2001\/XMLSchema-instance\"\n xsi:noNamespaceSchemaLocation=\"http:\/\/schema.phpunit.de\/4.1\/phpunit.xsd\"\n bootstrap=\".\/tests\/bootstrap.php\"\n backupGlobals=\"false\"\n colors=\"true\"\n convertErrorsToExceptions=\"true\"\n convertNoticesToExceptions=\"true\"\n convertWarningsToExceptions=\"true\"\n>\n <testsuites>\n <testsuite name=\"AcmeTests\">\n <directory>.\/tests<\/directory>\n <\/testsuite>\n <\/testsuites>\n\n <logging>\n <log type=\"coverage-text\" target=\"php:\/\/stdout\" showUncoveredFiles=\"true\"><\/log>\n <\/logging>\n<\/phpunit>\n<\/code><\/pre>\n\n
\n
\n
$ which phpunit<\/code><\/pre>\n3 Le fichier d’amor\u00e7age<\/h3>\n
<?php\n\/\/ This array has a single file but could whole the contents of an entire directory.\n$files = [\n dirname(__DIR__).'\/AcmeCache.php',\n];\n\nforeach ($files as $file) {\n if (file_exists($file)) {\n require_once $file;\n }\n}\n<\/code><\/pre>\n4 Un test de base qui \u00e9choue<\/h3>\n
\n
$ phpunit<\/code><\/pre>\n![\"\u00c9crire](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7588ea742f.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n\n
$ phpunit<\/code><\/pre>\n![\"\u00c9crire](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75891b9ec8.png\")
<\/a><\/p>\n<?php\n\nnamespace Acme;\n\nclass AcmeCache\n{\n private $duration;\n\n public function __construct()\n {\n $this->duration = 43200;\n }\n\n public function setDuration(int $duration)\n {\n $this->duration = $duration;\n }\n\n public function getDuration(): int\n {\n return $this->duration;\n }\n}\n<\/code><\/pre>\n4 Quelques tests de base et r\u00e9ussis<\/h3>\n
\n
<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n}\n<\/code><\/pre>\n![\"\u00c9crire](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e75894bbad2.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"\u00c9crire](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589770dbe.png\")
<\/a><\/p>\n<?php\n\nnamespace AcmeTests;\n\nuse PHPUnitFrameworkTestCase;\nuse AcmeAcmeCache;\n\nclass AcmeCacheTest extends TestCase\n{\n private $cache;\n\n public function setUp()\n {\n $this->cache = new AcmeCache();\n }\n\n public function testCacheExists()\n {\n $this->assertNotNull($this->cache);\n }\n\n public function testDefaultCacheValue()\n {\n $this->assertSame(43200, $this->cache->getDuration());\n }\n\n public function testSetCustomDuration()\n {\n $duration = 4200;\n\n $this->cache->setDuration($duration);\n $this->assertSame($duration, $this->cache->getDuration());\n }\n}\n<\/code><\/pre>\n![\"\u00c9crire](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589a7745a.png\")
<\/a><\/p>\n\n
Y a t-il plus? (Toujours raison?)<\/h2>\n