Share
Embed
【最終回】Drupal モジュール開発入門講座 第10回 自動テスト
アクイアジャパン Acquia Japan
February 08, 2023
Transcript
36 slides
-
Drupal Ϟδϡʔϧ։ൃೖߨ࠲γϦʔζ – DrupalͰʮϞδϡʔϧʯͱݺΕΔɺখ͞ͳιϑτΣΞΛ࣮͢Δ͜ͱͰػೳ֦ுΛߦ ͍·͢ɻຊΣϏφʔγϦʔζͰɺDrupalͷϞδϡʔϧ։ൃʹؔ͢ΔجૅࣝΛղઆ͠· ͢ɻ – DrupalͷόοΫΤϯυपΓʹ͍ͭͯମܥతʹֶͼ͍ͨํɺࣗͰΧελϜϞδϡʔϧΛ࡞Ε ΔΑ͏ʹͳΓ͍ͨํɺΞΫΠΞೝఆσϕϩούʔࢼݧΛࢦ͢ํʹ͓͢͢ΊͰ͢ɻ –
DrupalΛҰ௨Γૢ࡞ͨ͜͠ͱ͕͋ΔํΛରͱ͍ͯ͠·͢ɻ·ͩDrupalΛ৮ͬͨ͜ͱ͕ແ͍ ํɺॳ৺ऀ͚DrupalνϡʔτϦΞϧಈըʢຊޠʣΛઌʹݟ͓ͯ͘ͱΑΓཧղ͕ਂ·Γ ·͢ɻ -
ҰൠతͳιϑτΣΞςετͷςετϨϕϧ – ୯ମςετɿϓϩάϥϜͷߏཁૉͰ͋ΔΫϥεؔͳͲͷ୯ҐͰಈ࡞Λ ֬ೝ͢ΔͨΊͷςετɻϢχοτςετɺίϯϙʔωϯτςετͱݺΕ Δɻ – ౷߹ςετɿݸʑͷιϑτΣΞϞδϡʔϧΛΈ߹Θͤͯू߹ମͱͯ͠ಈ ࡞Λ֬ೝ͢ΔͨΊͷςετɻ݁߹ςετͱݺΕΔɻ – γεςϜςετɿΞϓϦέʔγϣϯશମ·ͨγεςϜશମͷಈ࡞ΛΤϯυ
πʔΤϯυͰਫ਼ࠪ͢ΔͨΊͷςετɻE2EςετͱݺΕΔɻ – डೖςετɿಛఆͷ·ͨػೳ͕ɺސ٬·ͨϚωʔδϟʔͳͲͷ ෦རؔऀʹΑͬͯઃఆ͞Ε༷ͨʹैͬͯ։ൃ͞Εͨ͜ͱΛ֬ೝ͢Δ ͨΊͷςετɻ खಈͰςετ͢Δ ͷେมɾɾͦ͜ ͰࣗಈԽʂ https://en.wikipedia.org/wiki/Software_testing#Testing_levels -
Drupalͷࣗಈςετ – ػೳՃɺվमɺDrupalΞοϓσʔτͰίʔυʹมߋ͕͋ͬͨࡍʹɺࣗಈς ετΛ௨ͯ͡ιϑτΣΞͷৼΔ͍ΛݕࠪͰ͖·͢ɻ – DrupalͰɺPHPUnitͱ͍͏ςετϑϨʔϜϫʔΫΛαϙʔτ͍ͯ͠·͢ɻ ͜ΕʹΑͬͯPHPϕʔεͷςετΛࣗಈԽͰ͖·͢ɻ – PHPUnitͰςετͷ࣮ߦɺςετ݁Ռͷग़ྗɺίʔυΧόϨοδղੳͳͲ ͕Ͱ͖·͢ɻ
– CI/CDπʔϧͱΈ߹ΘͤΔ͜ͱͰɺίʔυมߋΛߦ͏ʹࣗಈతʹςετ ࣮ߦΛߦ͏͜ͱ͕Ͱ͖·͢ɻ -
DrupalͷςετεΠʔτ ςετͷతʹԠͯ͡5छྨͷςετεΠʔτ͕༻ҙ͞Ε͍ͯ·͢ɻ͜ΕΒ PHPUnitϕʔεʹهड़͞Ε͍ͯ·͢ɻ – UnitɿDBߏσʔλΛΘͣ(ϞοΫͰରԠՄೳ)ɺΫϥεؔ୯Ґ ͰςετΛߦ͏ɻ – KernelɿDBߏσʔλΛ͏͕WebϒϥβෆཁͳςετΛߦ͏ɻ – FunctionalɿWebϒϥβΛ༻ͨ͠ςετΛߦ͏ɻ
– FunctionalJavaScriptɿWebϒϥβͱJavaScriptΛ༻ͨ͠ςετΛߦ ͏ɻ – BuildɿϏϧυϓϩηεͱͦͷ݁Ռʹରͯ͠ςετΛߦ͏ɻ https://api.drupal.org/api/drupal/core%21core.api.php/group/testing/9 ୯ମςετɺ౷߹ ςετɺγεςϜ ςετΛΧόʔ -
Drupalͷࣗಈςετͱ ·ͱΊ – ιϑτΣΞΛςετ͢Δ্Ͱɺࣗಈςετ͕͋Δ͜ͱʹΑͬͯػೳ ՃɺվमɺDrupalΞοϓσʔτͰίʔυʹมߋ͕͋Δʹιϑτ ΣΞͷৼΔ͍ΛݕࠪͰ͖·͢ɻ – DrupalͰɺPHPUnitͱ͍͏ςετϑϨʔϜϫʔΫΛαϙʔτ͓ͯ͠ ΓɺPHPϕʔεͷςετΛࣗಈԽͰ͖·͢ɻ –
DrupalʹςετͷతʹԠͯ͡5छྨͷςετεΠʔτ͕༻ҙ͞Εͯ ͓Γɺ୯ମςετɺ౷߹ςετɺγεςϜ/ػೳςετͷ࣮ࢪΛαϙʔ τ͍ͯ͠·͢ɻ -
– PHPUnitdrupal/core-devύοέʔδʹؚ·Ε͍ͯΔͷͰɺcomposerίϚϯυͰΠϯετʔϧ ͠·͢ɻ $ composer require drupal/core-dev --dev --update-with-all-dependencies
– PHPUnit͕ΠϯετʔϧͰ͖ͨΒɺphpunitίϚϯυ͕͑ΔΑ͏ʹͳΓ·͢ɻ $ ./vendor/bin/phpunit --version PHPUnitͷΠϯετʔϧ ※1 PHPUnitΛ༻͢ΔʹComposer͕ඞཁͰ͢ɻ ※2 --devΦϓγϣϯΛ͚ͯΠϯετʔϧ͠·͢ɻ ※3 DrupalϓϩδΣΫτ͕࠷৽Ͱͳ͍߹ɺ༻͍ͯ͠ΔDrupalόʔδϣϯΛࢦఆͯ͠Πϯ ετʔϧ͠·͢ɻྫɿ ‘drupal/core-dev:^9.4’ -
PHPUnitͷઃఆϑΝΠϧΛ༻ҙ͢Δ – phpunit.xml (͘͠phpunit.xml.dist)ͱ͍͏ϑΝΠϧΛɺϓϩδΣΫτσΟϨΫτϦ Լʹஔ͠·͢ɻ/web/core/phpunit.xml.dist Λίϐʔͯ࣋ͬͯ͘͠ΔͱָͰ͢ɻ $ cp web/core/phpunit.xml.dist
phpunit.xml – ϑΝΠϧͷதΛ͍͔ͭ͘मਖ਼͠·͢ɻ – bootstrapͷɿύεΛमਖ਼͢Δ – SIMPLETEST_DBͷɿKernelςετFunctionalςετͰඞཁ – SIMPLETEST_BASE_URLͷɿFunctionalςετͰඞཁ – ͦͷଞɿదͰͳ͍ύεΛमਖ਼͢Δ -
ࢀߟ) LandoͰDrupalڥΛ༻ҙ͍ͯ͠Δ߹ – LandoͷDrupalϨγϐΛ༻ͯ͠DrupalڥΛ༻ҙ͍ͯ͠Δ߹ɺ࣍ͷίϚϯυ ͰphpunitίϚϯυΛ࣮ߦͰ͖·͢ɻ $ lando php /app/vendor/bin/phpunit
--version – ·ͨɺ.lando.ymlʹ ͷΑ͏ʹઃఆ͢Δ͜ͱͰɺಠࣗͷίϚϯυΛఏڙͰ͖·͢ɻ $ lando phpunit --version tooling: phpunit: service: appserver cmd: - appserver: php /app/vendor/bin/phpunit -c /app/phpunit.xml -
– DrupalίΞΛؚΉશͯͷςετΛ࣮ߦ $ ./vendor/bin/phpunit -c phpunit.xml – ಛఆͷσΟϨΫτϦͷςετΛ࣮ߦ
$ ./vendor/bin/phpunit -c phpunit.xml web/core/modules/system/tests/src/Kernel – ಛఆͷςετϑΝΠϧͷςετΛ࣮ߦ $ ./vendor/bin/phpunit -c phpunit.xml web/core/modules/system/tests/src/Unit/ Breadcrumbs/PathBasedBreadcrumbBuilderTest.php ͞·͟·ͳ࣮ߦํ๏ -
– ಛఆͷςετεΠʔτͷςετΛ࣮ߦ͢Δ $ ./vendor/bin/phpunit -c phpunit.xml --testsuite unit
– ಛఆͷάϧʔϓͷςετΛ࣮ߦ͢Δ $ ./vendor/bin/phpunit -c phpunit.xml --group views – ςετରͷҰཡΛग़ྗ͢Δ $ ./vendor/bin/phpunit -c phpunit.xml --list-tests ͞·͟·ͳ࣮ߦํ๏ -
ςετϑΝΠϧ࡞ʹؔ͢Δϧʔϧ – ςετϑΝΠϧ {yourmodule}/tests/src/{testsuite}/xxTest.php ͷ໋໊نଇʹै͍·͢ɻ ྫɿmarucha/tests/src/Unit/Controller/MaruchaControllerTest.php –
ςετΫϥεͷ໊લۭؒ࣍ͷΑ͏ʹͳΓ·͢ɻ Drupal\Tests\{yourmodule}\{testsuite}\xxTest ྫɿDrupal\Tests\marucha\Unit\Controller\MaruchaControllerTest – ςετΫϥε༻͢ΔςετεΠʔτ͕༻ҙ͢ΔجఈΫϥεΛ֦ு͠·͢ɻ – ςετϝιουɺtest͔Β࢝·Δpublicϝιουʹهड़͠·͢ɻ – docblockͰςετʹؔ͢ΔใΛదٓهࡌ͠·͢ɻ -
DrupalͷςετεΠʔτ ΧςΰϦ త جఈΫϥε σΟϨΫτϦ Unit DBߏσʔλΛΘͣ(Ϟο ΫͰରԠՄೳ)ɺΫϥεؔ୯ ҐͰςετΛߦ͏ɻ \Drupal\Tests\UnitTestCase
yourmodule/tests/src/Unit/ Kernel DBߏσʔλΛ͏͕Webϒ ϥβෆཁͳςετΛߦ͏ɻ \Drupal\KernelTests\KernelTestBase yourmodule/tests/src/Kernel/ Functional WebϒϥβΛ༻ͨ͠ςετ Λߦ͏ɻ \Drupal\Tests\BrowserTestBase yourmodule/tests/src/Functional/ FunctionalJavaScript WebϒϥβͱJavaScriptΛ ༻ͨ͠ςετΛߦ͏ɻ \Drupal\FunctinalJavaScriptTests\We bDriverTestBase yourmodule/tests/src/ FunctionalJavaScript/ Build Ϗϧυϓϩηεͱͦͷ݁Ռʹର ͯ͠ςετΛߦ͏ɻ \Drupal\BuildTests\Framework\BuildT estBase yourmodule/tests/src/Build/ https://api.drupal.org/api/drupal/core%21core.api.php/group/testing/9 -
ԋश ΧελϜϞδϡʔϧͰςετίʔυ(Unitςετ)Λॻ͍ͯΈΑ͏ʂ 1. ϞδϡʔϧσΟϨΫτϦʹ tests/src/Unit/Controller/ MaruchaController.php ϑΝΠϧΛ࡞͢Δ 2. ςετΛ࣮ߦࣦͯ͠ഊ͢Δ͜ͱΛ֬ೝ͢Δ 3.
ςετ͕௨ΔΑ͏ʹ࣮͢Δ ίʔυͪ͜Β→ https://github.com/hmaruyama/my-drupal9-module/compare/vol10 -
Drupal Ϟδϡʔϧ։ൃೖߨ࠲γϦʔζ 1. Ϟδϡʔϧͷجૅࣝ 2. γϯϓϧͳΧελϜϞδϡʔϧΛ࡞ͬͯΈΑ͏ 3. ϑοΫ 4. ϑΥʔϜ
5. αʔϏε 6. Πϕϯτ 7. ϓϥάΠϯ 8. ΤϯςΟςΟ 9. ߏ 10. ࣗಈςετ https://www.youtube.com/playlist?list=PLVkpj3GMKNm2n_u-gOCBhDtqXTDxwhqjM -
– Ξϯέʔτͷ͝ڠྗΑΖ͓͘͠ئ͍͠·͢ʂ ʢΣϏφʔऴྃޙʹURL͕ڞ༗͞Ε·͢ʣ – ࣍ճͷ์ૹͪ͜Β 3/1(ਫ) ΞΫΠΞೝఆCloud Platform
Proͬͯ ͲΜͳࢼݧʁపఈղઆΣϏφʔ https://www.acquia.com/jp/events/webinars/acquia-certified-cloud-platform-pro-introduction ࠷ޙʹ