Jokainen yll\u00e4 olevista on tarkoitettu antamaan alulle, kuinka aloittaa hyvin perusyksikk\u00f6testien kirjoittaminen. Asiat voivat muuttua monimutkaisemmiksi varsinkin sovelluksen tai projektin kasvaessa (mutta se on aina totta, eik\u00f6?).<\/p>\n
Mutta varmistaaksemme, ett\u00e4 ihminen on valmistautunut siihen, yksikk\u00f6testauksessa on yksi viimeinen komponentti, johon meid\u00e4n pit\u00e4isi mielest\u00e4ni keskitty\u00e4, ja se on PHPUnit XML -m\u00e4\u00e4ritystiedoston ymm\u00e4rt\u00e4minen (jonka olet ehk\u00e4 n\u00e4hnyt muissa projekteissa nimell\u00e4 phpunit.xml).<\/p>\n
PHPUnit XML -kokoonpano<\/h2>\n
Joten t\u00e4ss\u00e4 viestiss\u00e4 aion perustaa yksinkertaisen projektin, joka k\u00e4ytt\u00e4\u00e4 PHPUnit-yksikk\u00f6\u00e4, kirjoittaa muutamia testej\u00e4, kuten olemme jo n\u00e4hneet, ja hy\u00f6dynt\u00e4\u00e4 m\u00e4\u00e4ritystiedostoa testauksen automatisoimiseksi.<\/p>\n
Lis\u00e4ksi aion tehd\u00e4 parhaani selitt\u00e4\u00e4kseni m\u00e4\u00e4ritystiedoston tarvittavat osat, jotta voit sis\u00e4llytt\u00e4\u00e4 sellaisen seuraavaan projektiisi.<\/p>\n
1 Tiedostojen poistaminen<\/h3>\n
Ennen kuin aloitat testattavan koodin kirjoittamisen, on t\u00e4rke\u00e4\u00e4 tiet\u00e4\u00e4 tiedostot, joita tarvitaan prosessin toimimiseen.<\/p>\n
Seuraavassa on enemm\u00e4n tai v\u00e4hemm\u00e4n, kuinka j\u00e4rjest\u00e4mme<\/a><\/strong> asiat projektin alusta alkaen:<\/p>\n Lopulta n\u00e4et my\u00f6s:<\/p>\n T\u00e4ss\u00e4 vaiheessa katsotaan kuitenkin XML-m\u00e4\u00e4ritystiedostoa ja yritet\u00e4\u00e4n sitten suorittaa PHPUnit automaattisesti ilman muita parametreja.<\/p>\n Katsotaanpa ensin perusasetustiedostoa:<\/a><\/strong><\/p>\n Ymm\u00e4rr\u00e4mme nyt, mit\u00e4 tarkalleen tarkastelemme (muuta kuin yksinkertaista XML:\u00e4\u00e4).<\/p>\n Kaiken t\u00e4m\u00e4n j\u00e4lkeen XML-tiedostossamme on kaikki mit\u00e4 PHPUnit tarvitsee toimiakseen ilman muita parametreja.<\/p>\n Muista kuitenkin, ennen kuin jatkat t\u00e4m\u00e4n artikkelin loppuun, oletan, ett\u00e4 olet asentanut PHPUnitin maailmanlaajuisesti j\u00e4rjestelm\u00e4\u00e4si Composerin avulla. Jos ei, tutustu t\u00e4h\u00e4n artikkeliin<\/a><\/strong>, sill\u00e4 se sis\u00e4lt\u00e4\u00e4 ohjeet sen tekemiseen.<\/p>\n Kun olet valmis, voit varmistaa, ett\u00e4 PHPUnit on asennettu kirjoittamalla seuraavan komennon p\u00e4\u00e4tteeseen:<\/p>\n Ja sinun pit\u00e4isi n\u00e4hd\u00e4 jotain seuraavanlaista:<\/p>\n<\/p>\n Jos n\u00e4et jotain yll\u00e4 olevan kaltaista, voit suorittaa PHPUnitin miss\u00e4 tahansa j\u00e4rjestelm\u00e4ss\u00e4si.<\/p>\n Ennen kuin jatkat, kirjoitetaan perus bootstrap-tiedosto. Kutsumme sit\u00e4 nimell\u00e4 bootstrap.php<\/strong> ja pudotamme sen testihakemistoomme<\/strong>. Se sis\u00e4lt\u00e4\u00e4 seuraavat:<\/a><\/strong><\/p>\n T\u00e4m\u00e4 on yksinkertainen "autoloader" (jota ep\u00e4r\u00f6im\u00e4tt\u00e4 kutsun sill\u00e4, koska se vain toistaa tiedostoja ja vaatii niit\u00e4, mutta se toimii meid\u00e4n tarkoituksissamme).<\/p>\n T\u00e4ss\u00e4 vaiheessa tehd\u00e4\u00e4n perustesti.<\/p>\n Jos luet jotain testil\u00e4ht\u00f6isest\u00e4 kehityksest\u00e4, kuulet todenn\u00e4k\u00f6isesti punavihre\u00e4n toiston syklist\u00e4. Siit\u00e4 on paljon sanottavaa, ja suosittelen sen lukemista<\/a><\/strong>, mutta se ei ole t\u00e4m\u00e4n viestin tarkoitus.<\/p>\n Sen sijaan keskitymme enemm\u00e4n siihen, ett\u00e4 kirjoitamme testej\u00e4, jotka vastaavat sit\u00e4, mit\u00e4 meid\u00e4n on teht\u00e4v\u00e4, eik\u00f6 niin? Tehd\u00e4\u00e4n sitten n\u00e4in:<\/p>\n Vaihda nyt terminaalista hakemisto projektin hakemistoon (josta toistaiseksi puuttuu) ja suorita sitten php<\/em><\/strong> unit<\/em>:<\/p>\n Olettaen, ett\u00e4 kaikki on asetettu oikein, sinun pit\u00e4isi n\u00e4hd\u00e4 jotain t\u00e4llaista:<\/p>\n Koska meill\u00e4 ei ole koodia eik\u00e4 testej\u00e4, n\u00e4emme luonnollisesti yll\u00e4 olevan tulosteen, eik\u00f6 niin? Joten kirjoitetaan yksi testi, joka suoritetaan (ja ep\u00e4onnistuu), koska sille ei ole varsinaista testattavaa koodia.<\/p>\n Luo ensin testihakemistoon<\/strong> tiedosto nimelt\u00e4 AcmeCacheTest.php.<\/strong> Ja annetaan sen tehd\u00e4 jotain yksinkertaista, kuten luoda v\u00e4limuistiobjekti<\/a><\/strong>, jonka lopulta luomme.<\/p>\n Ennen testin suorittamista huomaa, ett\u00e4:<\/p>\n T\u00e4m\u00e4 on osa sit\u00e4, mik\u00e4 tekee PHPUnitin k\u00e4yt\u00f6st\u00e4 niin helppoa. Kun t\u00e4m\u00e4 on tehty, suorita seuraava koodi projektisi juuresta:<\/p>\n Sen j\u00e4lkeen sinun pit\u00e4isi n\u00e4hd\u00e4 seuraava:<\/p>\n Huomaa, ett\u00e4 t\u00e4m\u00e4 antaa ep\u00e4onnistuneen testin ja kertoo, mist\u00e4<\/strong> ongelma l\u00f6ydettiin, tiedostosta ja rivist\u00e4.<\/p>\n T\u00e4m\u00e4n korjaamiseksi meid\u00e4n on kirjoitettava luokka:<\/a><\/strong><\/p>\n Perusl\u00e4p\u00e4isykoe (joka perustuu edelliseen koodiin) sis\u00e4lt\u00e4\u00e4 seuraavat:<\/p>\n Testataan ensin, ett\u00e4 pystymme m\u00e4\u00e4ritt\u00e4m\u00e4\u00e4n luokan ja ettei se ole tyhj\u00e4. T\u00e4m\u00e4 on hieman tarpeeton v\u00e4ite, koska tied\u00e4mme, ett\u00e4 meill\u00e4 on luokka oikein instantoituna, mutta se vie meid\u00e4t kokeiden kirjoittamisen uraan:<\/a><\/strong><\/p>\n Ja suorita testi:<\/p>\n Seuraavaksi tarkistetaan, ett\u00e4 v\u00e4limuistin oletusarvo on asetettu:<\/a><\/strong><\/p>\n Suorita testit edellisen vaiheen tapaan, ja sinun pit\u00e4isi nyt n\u00e4hd\u00e4 kaksi l\u00e4p\u00e4isev\u00e4\u00e4 testi\u00e4:<\/p>\n Lopuksi testataan, voimmeko muuttaa arvoa onnistuneesti:<\/a><\/strong><\/p>\n Ja kolme viimeist\u00e4 l\u00e4p\u00e4isykoetta:<\/p>\n Ja siin\u00e4 se on:<\/p>\n My\u00f6nnett\u00e4k\u00f6\u00f6n, se on yksinkertaista, mutta t\u00e4m\u00e4 antaa perusteet paljon enemm\u00e4n kuin mit\u00e4 monet ihmiset jo tekev\u00e4t testeill\u00e4\u00e4n.<\/p>\n Lis\u00e4ksi se antaa sinulle rakentamisen varaa, kun testikyljyksesi vahvistuvat.<\/p>\n Lopuksi, jos olet innokas todella sukeltamaan asetustiedostoon, voit lukea sen k\u00e4sikirjan perusteellisen<\/a><\/strong> selityksen.<\/p>\n Huomaa kuitenkin, ett\u00e4 kaikki yll\u00e4 kuvattu pyrkii olemaan sit\u00e4, mit\u00e4 tarvitset oman PHPUnit XML -asetustiedoston m\u00e4\u00e4ritt\u00e4misen aloittamiseen.<\/p>\n\n
\n
2 M\u00e4\u00e4ritystiedoston perusteet<\/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 Bootstrap-tiedosto<\/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 Perustesti, hyl\u00e4tty<\/h3>\n
\n
$ phpunit<\/code><\/pre>\n![\"Kirjoitusyksikk\u00f6testit](\"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![\"Kirjoitusyksikk\u00f6testit](\"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 Muutama perustesti, l\u00e4p\u00e4isev\u00e4 testi<\/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![\"Kirjoitusyksikk\u00f6testit](\"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![\"Kirjoitusyksikk\u00f6testit](\"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![\"Kirjoitusyksikk\u00f6testit](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-163700-61e7589a7745a.png\")
<\/a><\/p>\n\n
Onko enemm\u00e4n? (Aina oikeassa?)<\/h2>\n