25.04.2017

Ողջույն բոլորին!
Շարունակում ենք սովորել PHP-ի հիմունքները զրոյից:
Այս ձեռնարկում ես ձեզ կասեմ, թե ինչ է մեկնաբանությունը PHP-ում և գործնականում մենք կփորձենք գրել մեր մեկնաբանությունը կոդի մեջ։ Բայց սա դեռ ամենը չէ: Ես նաև ուզում եմ ձեզ ասել, թե ինչպես մեկնաբանել կոդը և ինչու է դա անհրաժեշտ ընդհանրապես անել:

Ինչ է մեկնաբանությունումPHP
ՄեկնաբանությունPHP- սա php մշակողի հուշում է կոդի մեջ արագ նավարկելու, ինչպես նաև խմբագրումների համար։

PHP-ի մեկնաբանությունը տեսանելի չէ այն օգտվողին, ով բացել է վեբ էջը դիտելու համար: Նույնիսկ եթե օգտատերը որոշի նայել էջի սկզբնական կոդը, մեկնաբանությունը դեռ տեսանելի չի լինի, քանի որ բոլոր php-ները:

PHP կոդի մեկնաբանություն

PHP կոդի համար կա 2 տեսակի մեկնաբանություն.

→ մեկ տող
→ բազմագիծ

⇒ Մեկ տող մեկնաբանություն PHP-ի համար
Մեկ տողով մեկնաբանության համար օգտագործեք «//» կամ «#» նշանները

Այս նիշերից հետո մեկ տողում գրված ամեն ինչ անտեսվելու է և դիտարկվելու է որպես մեկնաբանություն։

Բաժանորդագրվեք թարմացման համար "; # բաժանորդագրություն (սա մեկնաբանություն է)?>

Բաժանորդագրվեք թարմացման համար

⇒ Բազմակի մեկնաբանություն PHP-ի համար
PHP-ի մի քանի տող մեկնաբանություն սկսվում է «/ *»-ով և ավարտվում «* /»-ով:
Այս կերպարների միջև եղած ցանկացած բան անտեսվելու է և կդիտարկվի որպես մեկնաբանություն:
Բազմատող մեկնաբանություն օգտագործվում է, եթե գրառման մեջ մի քանի տող կա:

Էկրանի վրա կտեսնեք միայն հետևյալ տեքստը.

Բարև բլոգի ընթերցողներ - կայք !!!

P.S.:Միշտ մեկնաբանեք ձեր կոդը: Եթե ​​կարծում եք, որ կհիշեք այն ամենը, ինչ արել եք կոդում 1-2 տարի հետո, ապա սխալվում եք, հնարավորությունը շատ փոքր է։ Նույնիսկ եթե հիշեք, ստիպված կլինեք շատ ժամանակ ծախսել՝ ուսումնասիրելու համար, թե ինչ, որտեղ և ինչու…
Ապագայում ձեզ համար ինչ-որ հաճելի բան արեք՝ մեկնաբանեք կոդը, այնուհետև ինքներդ կասեք «ՇՆՈՐՀԱԿԱԼՈՒԹՅՈՒՆ !!!»:
Կոդում մեկնաբանություն թողեք, դա կտևի 1 րոպե, բայց ապագայում կխնայի մի ամբողջ օր։

Մեկնաբանեք PHP կոդը

Ենթադրենք, դուք գրել եք php կոդ, բայց ինչ-ինչ պատճառներով պետք է կոդի վրայից 2 տող հեռացնել։
Ես չեմ շտապում ինչ-որ բան հեռացնել կոդից, մանավանդ եթե դա php կոդ է, ավելի լավ է մեկնաբանել։ Ինչ անել, եթե ձեզ անհրաժեշտ է վերադարձնել կոդը: Ավելի հեշտ է չմեկնաբանել, քան կոդը գրել նոր ձևով:

Ինչպես մեկնաբանել կոդըPHP
Օրինակ մեկ տողով մեկնաբանությամբ.

Բաժանորդագրվեք թարմացմանը «;?>

Օրինակ՝ բազմատող մեկնաբանությամբ։

Հեղինակից.մեկնաբանելը այն հատկանիշներից է, որը հեշտ է իրականացնել: Միևնույն ժամանակ, այս խմբագրման տարրերը կարող են մեծ օգուտ բերել ծրագրավորողներին, ովքեր իրենց կոդը ձեռքից ձեռք են փոխանցում: Այսօր դուք կսովորեք, թե ինչպես մեկնաբանել բլոկը PhpStorm-ում: Ծրագրի բովանդակությունը մեկնաբանելու համար մենք կդիտարկենք նաև զարգացման միջավայրի մնացած ֆունկցիոնալությունը:

Մեկնաբանություններ՝ լավ և վատ

Կոդերի մեկնաբանումը հասանելի է ծրագրավորման լեզուների մեծ մասում (հնարավոր է բոլորը, բայց մատչելիության տարբեր աստիճաններով): Սովորաբար, բանավոր պարզաբանումները օգտագործվում են թիմի մյուս անդամներին օգնելու համար ավելի զարգանալ, կամ պարզապես հիշեցնել ինքներս մեզ, որ այս հատվածը ուղղումների կարիք ունի («FIX ME»):

Իհարկե, գրվածի բացատրությունը օրհնություն է։ Բայց մեկնաբանությունների օգնությամբ կարող եք նաև հատել կոդի բոլոր լավ կողմերը։ Որպեսզի դա տեղի չունենա, անհրաժեշտ է տարբերակել մեկնաբանությունների տեսակները.

փաստաթղթավորում. Լավ ասոցիացիան կլինի տարբեր ծրագրերի համար փաստաթղթերի հայեցակարգը: Նման մեկնաբանությունները օգնում են ձեզ օգտագործել կոդը հրահանգի նման։ Նման մեկնաբանությունն ավելորդ չի ընկալվում, քանի որ առանց դրա ոչինչ չկա։ Պատկերացրեք, որ ինչ-որ մեկը օգտագործել է հեղինակային շրջանակ և չի ասում ձեզ, թե ինչպես օգտագործել ծրագիրը.

JavaScript. Արագ մեկնարկ

բացատրելով. Լավ կոդը սովորաբար դրանց կարիքը չունի: Ինչքան շատ մեկնաբանությունների տողեր տեսնեք ծրագրում, այնքան ավելի հավանական է, որ ծրագիրը վատ գրված լինի: Իհարկե, սա բացարձակ կանոն չէ։

Բացատրական մեկնաբանությունները կարող են օգտակար լինել նրանց համար, ովքեր ապագայում կուղղեն ծածկագիրը։ Օրինակ, շատ երիտասարդ մասնագետներ ամենուր բարելավման դաշտ են տեսնում: Նրանք կարծում են, որ իրենցից առաջ ամեն ինչ ավելի վատ էր, և այժմ ժամանակն է ուղղելու յուրաքանչյուր հատկանիշ:

Երբեմն նմանատիպ զգացողություն է պատում մասնագետներին։ Օրինակ, երբ ամեն ինչ զարմանալիորեն ծուռ է թվում, պետք է ավելի լավ լուծում լինի։ Որպեսզի հետևորդներին փրկի լավագույնը փնտրելուց, ծրագրավորողը կարող է այսպիսի նշում թողնել՝ # time_spent_here = 24h

Նման խոսքերից հետո քչերն են ցանկանում այդքան ժամանակ անցկացնել։ Այսպիսով, դուք զգուշացնում եք, որ շատ տարբեր տարբերակներ արդեն դասավորված են: Միաժամանակ պետք է խուսափել նման հարձակումներից՝ #ես_ատում_այս, #փորձեք_ավելի_ավելի_անել %% լե։ Այս կերպ դուք միայն ոչ պրոֆեսիոնալ վերաբերմունք եք ցուցաբերում։ Մի զիջեք ինքներդ ձեզ և ձեր գործատուին:

Բայց կոդի վավերագրական մեկնաբանությունը կարող է բալաստ դառնալ ծրագրավորողի համար: Որպես կանոն, դրանք զանգվածային բաժիններ են, որոնք ուղղակիորեն շեղում են ուշադրությունը ծրագրավորումից։ Բայց կոդը առանց մեկնաբանությունների ցուցադրելու համար հիմնական IDE-ներն ունեն համապատասխան գործառույթ։ PhpStorm-ը բացառություն չպետք է լինի, բայց ավաղ: Փնտրեք գործառույթը թարմացման փաստաթղթերում:

Նշել որպես ֆունկցիոնալ տարր

Թեև մեկնաբանությունները նախատեսված են որպես բացատրություն և օժանդակություն թիմի զարգացման համար, այս հատկանիշները սովորաբար չեն օգտագործվում: Որպես կանոն, թեգերը տեղադրվում են այնտեղ, որտեղ ցանկանում են դադարեցնել կոդի կատարումը։ Ենթադրենք, դուք ունեք PHP ներկառուցված HTML-ում: Եվ դուք չեք ցանկանում ջնջել այն, պարզապես ուզում եք տեսնել, թե ինչպիսի տեսք ունի էջն առանց դրա: Դա անելու համար դուք պետք է հետևեք հետևյալ շարահյուսությանը.

JavaScript

…

…< div > . . . < / div > < ? -- закомментированныйкоднаphp -- > < div > . . . < / div >

Ինչպես տեսնում եք, պարզ գործողություններով կարող եք դադարեցնել կոդի կատարումը՝ նույնիսկ առանց որևէ բարդ գործողություններ կատարելու։ Բայց, ըստ էության, սա դեռ օպտիմալացման բարձրակետը չէ։ Մշակողի համար հավելյալ հարմարավետություն տրամադրվում է հենց phpStorm IDE-ի կողմից: Օգտագործելով ընդգծում և ստեղնաշարի դյուրանցումներ՝ կարող եք մեկնաբանել կոդի ընտրված հատվածը՝ առանց հատուկ պիտակներ կցելու: Դա կարելի է անել հետևյալ կերպ.

Օգտագործելով ձեզ հարմար մեթոդ, ընտրեք տեքստի մի հատված (մկնիկ, դյուրանցումներ):

Սեղմեք ստեղնաշարի դյուրանցումը Ctr + Shift + /

Բացի այդ, դուք կարող եք մեկնաբանել ընթացիկ տողը: Ամեն ինչ նույնն է, միայն առանց Shift-ի։

Այս տեսակի մեկնաբանությունների առավելությունը մի քանի լեզուների միաժամանակյա լուսաբանումն է։ PHP-ն հազվադեպ է ինքնուրույն լինում: Այս կերպ դուք ստիպված չեք լինի դիմել յուրաքանչյուրին պիտակավորելու: Շրջակա միջավայրն աջակցում է ևս մի քանի վեբ լեզուների: Պարզապես ընտրեք մի հատված և վաճառեք համադրությունը. սա բազմալեզու ծածկագիր է և մեկնաբանված: Նույն կերպ այն կարելի է ակտիվացնել։

Այսքանը մեզ համար է: Եթե ​​նախկինում չեք օգտագործել այս հնարավորությունները, խորհուրդ ենք տալիս սկսել: Հապավումները դարձնում են աշխատանքը ավելի արագ և ավելի լավ:

JavaScript. Արագ մեկնարկ

Իմացեք JavaScript-ի հիմունքները վեբ հավելված կառուցելու գործնական օրինակով

PHP-ի մեկնաբանությունները նման են HTML-ում օգտագործվող մեկնաբանություններին: PHP-ի շարահյուսությունում մեկնաբանությունները միշտ սկսվում են նիշերի հատուկ հաջորդականությամբ, և բոլոր տեքստերը, որոնք հայտնվում են այս հատուկ նիշերի միջև, անտեսվելու են թարգմանչի կողմից:

HTML-ում մեկնաբանության հիմնական նպատակը ծրագրավորողների համար որպես նշում ծառայելն է, ովքեր կարող են դիտել ձեր կայքի սկզբնական կոդը: PHP մեկնաբանությունները տարբերվում են նրանով, որ դրանք չեն ցուցադրվի այցելուներին: PHP-ի մեկնաբանությունները տեսնելու միակ միջոցը ֆայլը խմբագրելու համար բացելն է: Սա PHP մեկնաբանությունները դարձնում է օգտակար միայն PHP ծրագրավորողների համար:

Եթե ​​մոռացել եք կամ չգիտեիք, թե ինչպես են մեկնաբանությունները կատարվում HTML-ում, տես ստորև բերված օրինակը:

Php մեկնաբանության շարահյուսություն. մեկ տողով մեկնաբանություն

Մինչդեռ html-ն ունի միայն մեկ տեսակի մեկնաբանություն, PHP-ն ունի երկու: Առաջին տեսակը, որը մենք կքննարկենք, մեկ տողով մեկնաբանությունն է: Այսինքն՝ մեկնաբանություն, որը թարգմանչին ասում է անտեսել այն ամենը, ինչ տեղի է ունենում այս տողում՝ մեկնաբանություններից աջ: Այս մեկնաբանությունն օգտագործելու համար օգտագործեք «//» կամ «#» նիշերը, և աջ կողմում գտնվող ամբողջ տեքստը անտեսվելու է PHP թարգմանչի կողմից:

Psst ... Դուք չեք կարող տեսնել իմ PHP մեկնաբանությունները: // արձագանքել «ոչինչ»; // echo «Իմ անունը Համպերդինկլ է»; # echo «Ես էլ ոչինչ չեմ անում»;?>

Արդյունք:

Բարեւ աշխարհ! Psst ... Դուք չեք կարող տեսնել իմ PHP մեկնաբանությունները:

Նկատի ունեցեք, որ մեր echo հրամաններից մի քանիսը չեն մշակվել, քանի որ մենք դրանք մեկնաբանել ենք մեկնաբանության հատուկ նիշերով: Մեկնաբանությունների այս տեսակը հաճախ օգտագործվում է բարդ և շփոթեցնող կոդի մասին արագ գրելու կամ PHP կոդի տողը ժամանակավորապես հեռացնելու համար (վրիպազերծման համար):

Php մեկնաբանության շարահյուսություն. բազմագիծ մեկնաբանություն

Ինչպես HTML մեկնաբանությունները, PHP-ի բազմակողմ մեկնաբանությունները կարող են օգտագործվել կոդի մեծ բլոկներ մեկնաբանելու կամ բազմաթիվ տողերում մեկնաբանություններ գրելու համար: PHP-ում բազմատող մեկնաբանությունները սկսվում են «/ *»-ով և ավարտվում «* /»-ով: Այս կերպարների միջև եղած ցանկացած բան անտեսվելու է:

Արդյունք.

Այսօր այս կարճ, բայց օգտակար հոդվածում մենք կպարզենք, թե ինչպես է մեկնաբանվում տարբեր ծրագրի կոդը: Ես շատ բան չեմ ասի, քանի որ եթե դա ձեզ հետաքրքրում է, ապա դուք արդեն հանդիպել եք այս խնդրի հարցերին, և դուք դրա մասին պատկերացում ունեք։

Դուք եկել եք հասցեով ... բայց մի քանի խոսք պարզության և գործի օգուտի համար: Դուք հավանաբար տեսել եք, թե ինչպես է դա արվում CSS կոդով, քանի որ css-ն ամենաշատը հետաքրքրում է շատ սկսնակների, ինչպես ինձ:

… Լավ!

Բայց նշեք, որ մեկնաբանությունները նույնպես օգտագործվում են html և php... Բայց սկսնակներից շատերը աշխատանքի սկզբնական փուլում շփոթվում են կայքի հետ և չգիտեն, թե ինչպես ավելացնել իրենց համար անհրաժեշտ բացատրությունները: Ի վերջո, դա տեղի է ունենում, օրինակ, դուք պետք է անջատեք որոշ ժամանակով html կոդը, և այնուհետև նորից վերսկսել իր գործառույթը. դա հեշտ է իրականացնել, եթե դուք ինքներդ գրառումներ եք կատարել «լուսանցքներում», բայց երբեք չգիտեք, թե ինչ:

Բայց ինչ պետք է հիշել ընդհանրապես «մեկնաբանությունների» մասին. այստեղ ամեն ինչ խստորեն կախված է նրանից, թե կոնկրետ որ ֆայլի հետ եք աշխատում, և, հետևաբար, դիմումի կոդը տարբեր է:

Մեկնաբանելով CSS կոդը

ա՝ սավառնել, ա՝ ֆոկուս (գույն՝ # D5071E; տեքստի ձևավորում՝ համընդհանուր; / * ԸՆՏՐԵՑՎԵԼ ԵՆ * /)

Այսպես ես քեզ բացատրում. Կամ դուք կարող եք նույնիսկ մեկնաբանել այս css սցենարը ամբողջությամբ այսպես. պարզապես փաթեթավորեք

/ * այստեղ ԿՈԴ * /

/ * a: սավառնել, a: ֆոկուս (գույն՝ # D5071E; տեքստի ձևավորում՝ ընդգծված; / * ԸՆՏՐԵԼ * /) * /

Ձեր ուշադրությունն եմ հրավիրում այն ​​փաստի վրա, որ դուք կարող եք մեկնաբանել css կոդի ամբողջական ցիկլը այս կերպ, բայց !! ապա դուք պետք է հեռացնեք կրկնվող մեկնաբանությունները / * ԸՆՏՐԵՔ ՆԵՐՔԻՆ * /, կամ խաղալ շեղերով, եթե բացատրությունը կարևոր է))

Հակառակ դեպքում սխալ կլինի !!

Նշում:

Եթե ​​դուք բացեք էջի սկզբնական կոդը՝ Ctrl + U և նայեք ... կտեսնենք, որ մեկնաբանված css կոդի հատվածը գեղեցիկ կերպով ցուցադրված է ստեղծված փաստաթղթում: սա այն է, եթե css-ն օգտագործվեր (հատկությունները դրված էին) անմիջապես html-ում

Եվ, ինչպես գիտեք, եթե դուք գնում եք սկզբնաղբյուրից՝ հղում կատարելով ձեր ակտիվ ձևանմուշի css փաստաթղթին, բոլոր մեկնաբանությունները կարելի է դիտարկել և ուսումնասիրել)), եթե դա ինչ-որ մեկին պետք է։ Բայց դա քիչ հավանական է)

Անգլերեն բայերը (բառերը) ընթեռնելի կլինեն: Ռուսական սիմվոլիկան - ոչ:

Մեկնաբանելով HTML կոդը

XML ֆայլը մեկնաբանվում է նույն կերպ։

Կարևոր է. միշտ ստուգեք հոդվածներում ներկայացված կոդը, գոնե տեսողականորեն), հակառակ դեպքում կարող են լինել սխալներ:

Ֆորմատավորման ժամանակ սովորական անփութությունը կարող է ժամանակատար լինել, օրինակ՝ վերը նշված ՄԵԿՆԱԲԱՆՎԱԾ ծածկագիրը հաճախ սխալվում է. երկու կարճ գծիկների փոխարեն հայտնվում է em գծիկ.

Ձեր տեղեկատվության համար.

ինչպես ասվեց նախորդ նկատառման մեջ, այսպես է մեկնաբանությունը… html կոդը ցուցադրվում է ստեղծված փաստաթղթում:

Սա նկատի ունեցեք:

Եվ ահա ևս մեկ բան.

բացի նրանից, որ մեկնաբանված կոդը ցուցադրվում է էջի սկզբնաղբյուրում (ինչը նշանակում է, որ այն ինչ-որ իմաստով մշակված է, թեև էջում նույնպես անտեսանելի կլինի): Ավելի լավ է php-ի որոշ գործառույթներ համատեղությամբ հեռացնել: html-ով ակտիվ փաստաթղթից:

Օրինակ:

տեսանելի կլինի փաստաթղթում և գործառույթումայն հիանալի կաշխատի իր գործը. այսինքն՝ տեղեկատվությունը չի երևա ճակատային մասում, այլ սկզբնաղբյուրում՝ այն հստակ կցուցադրվի: և սա հատուկ խնդրանք է տվյալների բազայի համար. այս ամենը մանրուք է, բայց դուք պետք է իմանաք:

Դա հնարավոր է անել, եթե չես ցանկանում փաստաթղթից կոդի մի կտոր հանել.

անհրաժեշտ «լրացուցիչ» html կոդից առաջ ավելացրեք բացումը... inline ֆունկցիա ... և փակվո՞ւմ:> ...

Մի խոսքով, եթե կոդը մեծ է, այսպես կարող եք դա անել.

**/ ?>

ապա աղբյուրը մաքուր կլինի:

Կամ ավելի պարզ.

Եկեք մեկնաբանենք գործառույթն ինքնին html փաստաթղթում: Աղբյուրի կոդը այս դեպքերում մաքուր կլինի գործառույթների մշակման հետ կապված:

ինչպես մեկնաբանել JavaScript-ը

եթե (ցույց է տրված || ցույց է տրված) (// մի գործարկեք անիմացիան նորից վերադարձեք;) այլապես (// տողում կիրառեք ՑԱՆԿԱՑԱԾ ՄԵԿՆԱԲԱՆՈՒԹՅՈՒՆ // տողում կիրառեք ցանկացած մեկնաբանություն // ճշմարիտ;

Պարզության համար ես վերցրեցի այս օրինակ JavaScript կոդը ցանցում՝ մի փոքր ուղղելով կետադրական նշանները: Կարևոր չէ ... Հիմնական բանը սկզբունքը հասկանալն է ...

Ինչպես հասկանում եք, «//» կտրվածքը կրկնակի է, սա մեկնաբանության ՆՇԱՆՆ է ... ՄԵԿ ՏԵՂ!

JS ծածկագրի մնացած մասը մեկնաբանվում է php-ի նման, դրա մասին ավելին ստորև.

դիտողություն:

Մեկնաբանելով PHP կոդը

... եւ ... այստեղ նույնն է՝ շեղ-շեղ ... մի տող:

Բայց նկատի ունեցեք, որ այն կարող է ծանոթագրվել ճիշտ այնպես, ինչպես CSS- կոդը:

... կամ այնպես, որ դուք կարող եք մեկնաբանել՝ մեկ տողով տարբերակ, երբ մեկնաբանված տողից առաջ օգտագործում ենք ՈՉ ԵՐԿՈՒ շեղ, այլ BECAR (հեշ).

... Բնականաբար, դուք պետք է ուշադիր մեկնաբանեք կոդի հանգույցում:

... կամ նույն կերպ - նման է վերը նշված օրինակին CSS-ի համար ... այսինքն. այս / * կոդը * / մեկնաբանելու տարբերակը կաշխատի ինչպես CSS, այնպես էլ JS կոդերի համար:

Բայց այս կերպ, դուք կարող եք մեկնաբանել PHP կոդի ավելի ծավալուն բացատրություն, ինչ-որ տեղ դրա հիմնական օրինակների միջև ...

Կարող եք նաև մեկնաբանել php loop-ներում այսպես, եթե կոդը խառնված է ... php և ինչ-որ կերպ html

Վերևի նման.

Օրինակ, ինչ-որ ֆունկցիա ... ինչ-որ տեղ ընդհանուր կոդի մեջ (կամ հանգույց html-ում).- կարող եք մեկնաբանել, այսինքն՝ ավելացնել ձեր սեփական պիտակը այսպես.

կամ այսպես՝ մեկ տողանոց տարբերակ...

Խելք:

php կոդը տեսանելի չէ ոչ մի կոդով !! տեսանելի է միայն նրա ֆունկցիոնալ արդյունքը.

Ընդհանրապես, սա այն ամենն է, ինչ ես ուզում էի հաղորդել այսօր:

Այժմ դուք կարող եք փորձարկել ... Հաջողություն:

Եվ իհարկե, կարդացեք կայքի հոդվածները և բաժանորդագրվեք.
Ես կիսում եմ իմ դառը փորձը `որոշ գիտելիքներ, ձեր քաղցր բարեկեցության համար))

... վեբ վարպետների քաղաքը Mikhalika.ru© - Հեշտությամբ WordPress-ով