Twig կաղապարների դեբագավորում

Twig կաղապարների շարժիչը առաջարկում է դեբագավորման գործիք։

Drupal 8-ի իրականացումը նաև ավելացնում է լրացուցիչ գործիք, որը թույլ է տալիս գտնել կաղապարը, որը ցուցադրում է նշված HTML-ը։

Զգուշացում․ Twig դեբագի միացումը կարող է փչացնել կայքի որոշ հատվածներ, հատկապես Views։ Տեսեք այս խնդիրը։

Դեբագի միացում

Դուք միացնում եք Twig դեբագը sites/default/services.yml ֆայլում։

debug փոփոխականին նշանակեք true և մաքրեք քեշը։

parameters:
  twig.config:
    debug: true 

• Եթե services.yml դեռ չկա, պատճենեք default.services.yml և անվանեք services.yml։
• Եթե Drupal արդեն տեղադրված է, հնարավոր է ժամանակավորապես անհրաժեշտ լինի փոխել sites/default թղթապանակի գրանցման իրավունքները՝ գրելու թույլտվություն տալու համար։
• Ինչպես փոխել թղթապանակի իրավունքները
• Երբ services.yml-ը ստեղծված և խմբագրված է, վերադարձնեք իրավունքները, որ բլոկացնեք sites/default թղթապանակը։

Դեբագի ստուգում

Եթե օգտագործում եք Firebug (Firefox-ում), համոզվեք, որ "Show Comments" (Ցույց տալ մեկնաբանությունները) միացված է, կամ դիտեք էջի աղբյուրը անմիջապես՝

Ավտոմատ վերալիցքավորում

Twig կաղապարները կոմպիլացվում են PHP դասերի մեջ սկավառակի վրա արագացման համար, բայց սա նշանակում է, որ ձեր կաղապարները ըստ նախադրյալի չեն թարմացվի փոփոխությունների դեպքում։ Չմիացրեք սա արտադրական միջավայրում։

Ձեռնարկային կոմպիլյացիա անելու համար գործարկեք drush cr։ Զարգացման ժամանակ խնայելու համար միացրեք ավտոմատ վերալիցքավորումը՝ services.yml-ում twig.config.auto_reload: true-ի միջոցով (ավտոմատ վերալիցքավորումը ըստ նախադրյալի միացված է, երբ twig.config.debug: true է)։

Լրացուցիչ տեղեկությունների համար դիտեք https://drupal.org/node/1903374։

Փոփոխականների դիտում

Լավագույն եղանակը փոփոխականները դիտելու համար է Xdebug օգտագործելն է։

Եթե օգտագործում եք այլ՝ ոչ Xdebug մեթոդներ, որոնք նշված են ստորև, կունենաք բազմաթիվ ռեկուրսիվ ռենդերներ, որոնք կհանգեցնեն երկար և ոչ օգտակար տեղեկության։

Հիմնական առաջարկվող մոտեցումը՝ PHPStorm + Xdebug օգտագործելն է, քանի որ դրանց կոնֆիգուրացիան ամենահեշտն է, սակայն գրեթե բոլոր IDE-ներում կա Xdebug-ի հավելված։ Եթե ուզում եք անվճար և թեթև ռեդակտոր, ապա Microsoft-ի VSCode բաց կոդով ռեդակտորն է, որտեղ կան PHP և Xdebug հսկիչներ։

Xdebug-ի կարգավորում

Xdebug-ի կարգավորումը կարող է բարդ լինել, այնպես որ կարդացեք ձեր IDE-ի պլագինի հրահանգները և Xdebug-ի փաստաթղթերը։ Ինտերնետում ուղղակի անպատասխանատու հրահանգների ընթերցումը և սխալ միջավայրի համար փորձելը (օրինակ՝ Xdebug-ը տեղադրված է Vagrant, VirtualBox կամ Docker-ի ներսում) կարող է անհաջող լինել։ Այդ դեպքերում պետք է որոնել հեռավոր միացման հրահանգներ։

Drupal.org-ում կան Xdebug-ի ուղեցույցներ տարբեր ռեդակտորների համար՝ https://www.drupal.org/docs/develop/development-tools/xdebug-debugger

Երբ աշխատում եք Xdebug-ի հետ՝

Կաղապարներում փոփոխականներն ու PHP-ի վիճակը տեսնելու համար ձեր IDE-ում կարող եք տեղադրել երեք տեսակի breakpoint՝

• Օգտագործեք Twig-ի նոր դեբագավորման ֆունկցիան PHPStorm-ում (բլոգ, դոկումենտացիա)։ Դրա համար Drupal մոդուլներ պետք չեն։
• Devel մոդուլով

{{ devel_breakpoint() }}

• Twig Xdebug մոդուլով

{{ breakpoint() }}

Եթե չեք կարող տեղադրել Xdebug ...

... կարդացեք ստորև և հաջողություն, իմ բարեկամ։

{{ dump() }}

{{ dump(variable_name) }}

Հասանելի փոփոխականների ցանկը (վերևի մակարդակում)՝

{{ dump(_context|keys) }}

Եթե ունեք Devel-ի kint ենթամոդուլը (ներբեռնում է require-dev Composer-ով՝ composer require --dev drupal/devel 1.0-alpha1, ակտիվացնում Drush-ով՝ drush -y en kint), կարող եք տեսնել փոփոխականների հիանալի տեսողական ներկայացում՝

{{ kint() }}

Կարելի է, որ kint-ը մեծ ռենդերների դեպքում սառեցնի ձեր բրաուզերը։ Այդ դեպքում կարող եք օգտագործել հետևյալ մոդուլները՝

• https://www.drupal.org/project/vardumper

Կամ օգտագործեք Vardumper Twig մոդուլը, որը պարունակում է Twig-ի Vardumper։ Այն թույլ է տալիս նուրբ կերպով դիտել Twig-ի փոփոխականները՝

{{ dump() }}
{{ dump(variable_name) }}

{{ vardumper() }}
{{ vardumper(variable_name) }}

• https://www.drupal.org/project/twig_vardumper

... բայց հիշեք, որ մեկ կամ երկու ժամ ծախսել Xdebug-ի կարգավորման վրա, ձեր աշխատանքը շատ կպարզացնի, քանի որ այդպես ավելի լավ կիմանաք, թե ինչ փոփոխականներ կան։

Եթե սխալ մոտեցում եք օգտագործում ...

Եթե շատ կոդ եք գրում կաղապարի մակարդակում, պետք է խորհեք՝ իսկ արդյոք դա ճիշտ է անել այդ մակարդակում։ Օրինակ՝ ավելի լավ է արդյոք պատճենել գոյություն ունեցող դաշտի ֆորմատավորման plugin ֆայլը օգտվողի մոդուլում (հավատարիմ մնալով նույն թղթապանակի կառուցվածքին), փոխել plugin-ի անունը և PHP/HTML-ը՝ ձեր ուզածը անելու համար։ Drupal 8-ի plugin-ները պարզապես առանձին ֆայլեր են կոնկրետ թղթապանակներում, և դրանց հետ աշխատելը հեշտ է։

Լրացուցիչ դեբագավորման կարգավորումներ կարող եք գտնել այս բաժնում։