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_forent_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 "არც მე ვაკეთებ არაფერს"; ?>

შედეგი:

გამარჯობა მსოფლიო! Psst... თქვენ ვერ ხედავთ ჩემს PHP კომენტარებს!

გაითვალისწინეთ, რომ ჩვენი ექოს რამდენიმე ბრძანება არ დამუშავდა, რადგან ჩვენ მათ კომენტარი გავაკეთეთ სპეციალური კომენტარების სიმბოლოებით. ამ ტიპის კომენტარი ხშირად გამოიყენება რთული და ბუნდოვანი კოდის შესახებ სწრაფად დასაწერად, ან PHP კოდის ხაზის დროებით მოსაშორებლად (გამართვის მიზნით).

php კომენტარის სინტაქსი: მრავალხაზოვანი კომენტარი

HTML კომენტარების მსგავსად, PHP-ში მრავალსტრიქონიანი კომენტარები შეიძლება გამოყენებულ იქნას კომენტირებისას დიდი ბლოკების კომენტირებისთვის, ან კომენტარების დასაწერად რამდენიმე სტრიქონზე. მრავალხაზოვანი კომენტარები PHP-ში იწყება "/*"-ით და მთავრდება "*/-ით". ნებისმიერი რამ ამ პერსონაჟებს შორის იქნება იგნორირებული.

შედეგი.

... დღეს ჩვენ ვართ ამ მოკლე, მაგრამ სასარგებლო სტატიაში, ჩვენ გავარკვევთ, თუ როგორ არის კომენტირებული სხვადასხვა პროგრამის კოდი. ბევრს არ ვისაუბრებ, რადგან თუ ეს გაინტერესებთ, მაშინ უკვე წააწყდით ამ ამოცანის კითხვებს და გაქვთ ამის შესახებ წარმოდგენა.

თქვენ სწორ ადგილას მოხვედით... მაგრამ რამდენიმე სიტყვა სიცხადისა და სარგებლობისთვის. თქვენ უნდა გესმოდეთ, როგორ კეთდება ეს CSS კოდით, რადგან css ყველაზე მეტად აინტერესებს ბევრი დამწყები, როგორც მე.

… კარგი!

მაგრამ გაითვალისწინეთ, რომ კომენტარები ასევე გამოიყენება html და php... მაგრამ დამწყებთა უმეტესობა საიტთან მუშაობის საწყის ეტაპზე იბნევა და არ იცის როგორ დაუმატოს საკუთარ თავს საჭირო განმარტებები. ყოველივე ამის შემდეგ, ეს ხდება იგივე გზით, მაგალითად, თქვენ უნდა გამორთოთ გარკვეული დროით html კოდი, და შემდეგ კვლავ განაახლეთ მისი ფუნქცია - ამის განხორციელება მარტივია, თუ გააკეთეთ შენიშვნები "ზღვრებზე", მაგრამ არასოდეს იცით რა.

მაგრამ რა უნდა გვახსოვდეს ზოგადად "კომენტარების" შესახებ - აქ ყველაფერი მკაცრად არის დამოკიდებული იმაზე, თუ რომელ ფაილთან მუშაობთ კონკრეტულად და, შესაბამისად, განაცხადის კოდი განსხვავებულია.

CSS კოდის კომენტირება

a:hover, a:focus (ფერი: #D5071E; ტექსტის დეკორაცია: გადახაზული; /*ხაზი ზევით*/ )

ასე აგიხსნით საკუთარ თავს. ან შეგიძლიათ ზოგადად კომენტარი გააკეთოთ ამ css სკრიპტის ასე: უბრალოდ გადაიტანოთ

/* კოდი აქ */

/*a:hover, a:focus ( ფერი: #D5071E; ტექსტის დეკორაცია: ხაზგასმული; /*ქვედა ხაზგასმული*/ )*/

თქვენს ყურადღებას ვაქცევ იმ ფაქტს, რომ - შეგიძლიათ კომენტარი გააკეთოთ css კოდის სრულ ციკლზე ამ გზით, მაგრამ !! მაშინ მოგიწევთ განმეორებითი კომენტარების ამოღება /* UnderstrING BELOW */, ან თამაში ხაზებით, თუ განმარტება მნიშვნელოვანია))

წინააღმდეგ შემთხვევაში იქნება შეცდომა!!

Შენიშვნა:

თუ გახსნით გვერდის საწყის კოდს - Ctrl + U და დააკვირდებით... დავინახავთ, რომ კომენტირებული css კოდი იდეალურად არის ნაჩვენები გენერირებულ დოკუმენტში! ეს არის თუ css გამოყენებული (თვისებები დაყენებულია) პირდაპირ html-ში

და, როგორც გესმით, თუ მიჰყვებით ბმულს საწყისი კოდიდან თქვენი აქტიური შაბლონის css დოკუმენტამდე, შეგიძლიათ დააკვირდეთ და შეისწავლოთ ყველა კომენტარი)) თუ ვინმეს ეს სჭირდება. მაგრამ ეს ნაკლებად სავარაუდოა.)

ინგლისური დიალექტი (სიტყვები) იკითხება. რუსული სიმბოლოები - არა.

HTML კოდის კომენტირება

XML ფაილი კომენტირებულია იმავე გზით.

მნიშვნელოვანია: ყოველთვის შეამოწმეთ სტატიებში შემოთავაზებული კოდი, მინიმუმ ვიზუალურად, წინააღმდეგ შემთხვევაში შეიძლება იყოს შეცდომები.

მარტივი ფორმატირების უყურადღებობა შეიძლება დრო დაუჯდეს, მაგალითად, ზემოთ ნაჩვენები COMMENTED კოდი ხშირად არასწორია: ორი მოკლე დეფისის ნაცვლად ჩნდება em ტირე:

თქვენი ინფორმაციისთვის:

როგორც წინა შენიშვნაში იყო აღნიშნული - კომენტარიც... html კოდი ნაჩვენებია გენერირებულ დოკუმენტში!

გაითვალისწინეთ ეს.

და აი კიდევ რაღაც:

გარდა იმისა, რომ კომენტირებული კოდი ნაჩვენებია გვერდის საწყის კოდში (და, შესაბამისად, დამუშავებულია გარკვეული გაგებით, თუმცა გვერდზე უხილავი იქნება!) - უმჯობესია ამოიღოთ ზოგიერთი php ფუნქცია html-თან ერთად. აქტიური დოკუმენტიდან.

Მაგალითად:

ხილული იქნება დოკუმენტში და ფუნქციაშიის შესანიშნავად შეასრულებს თავის საქმეს: ანუ ფრონტ-ენდში ინფორმაცია არ ჩანს, მაგრამ საწყის კოდში - ნათლად იქნება ნაჩვენები! და ეს არის უსაფუძვლო მოთხოვნა მონაცემთა ბაზისადმი: ეს ყველაფერი წვრილმანია, მაგრამ თქვენ უნდა იცოდეთ!

ამის გაკეთება შესაძლებელია, თუ არ გსურთ დოკუმენტიდან კოდის ამოღება:

დაამატეთ საჭირო "დამატებითი" html კოდის გახსნამდე… inline ფუნქცია… და იხურება?> …

ერთი სიტყვით, ეს არის ის, რისი გაკეთებაც შეგიძლიათ, თუ კოდი დიდია:

**/ ?>

მაშინ წყარო სუფთა იქნება!

ან უფრო მარტივად:

მოდით კომენტარი გავაკეთოთ თავად ფუნქციაზე html დოკუმენტში. წყაროს კოდი ამ შემთხვევებში ფუნქციების განვითარებასთან დაკავშირებით სუფთა იქნება!

როგორ გავაკეთო კომენტარი Javascript

if (beingShown || ნაჩვენები) ( // არ გააქტიუროთ ანიმაცია ისევ დაბრუნდით; ) სხვა ( // გამოიყენეთ ნებისმიერი კომენტარი ხაზზე // გამოიყენეთ ნებისმიერი კომენტარი ხაზზე // true;

JavaScript კოდის ეს ნიმუში - მე, სიცხადისთვის, ავიღე ქსელში, ოდნავ ვასწორებ პუნქტუაციას. არა უშავს... მთავარია პრინციპის გაგება...

როგორც გესმით, ხაზგასმული "//" ორმაგია, ეს არის კომენტარის ნიშანი ... SINGLE-LINE!

და დანარჩენი JS კოდი კომენტირებულია, როგორც php, უფრო მეტი ამის შესახებ ქვემოთ:

შენიშვნა:

PHP კოდის კომენტირება

... და ... აქ მსგავსია - სლეშ-სლეში ... ერთხაზოვანი.

მაგრამ გაითვალისწინეთ, რომ მასზე კომენტარის გაკეთება შესაძლებელია ისევე, როგორც CSS კოდი.

... ან შეგიძლიათ კომენტარი გააკეთოთ ასე - ერთსტრიქონიანი ვერსია, როდესაც ვიყენებთ არა ორ SLASHES-ს, არამედ BEKAR-ს (ჰეშს) კომენტარის ხაზამდე:

...რა თქმა უნდა, კომენტარის გაკეთება ფრთხილად უნდა იყოს კოდის ციკლში!

... ან ამ გზით - ზემოთ ნაჩვენები CSS მაგალითის მსგავსი ... ე.ი. ეს /* კოდი */ კომენტარის ვარიანტი შესაფერისია როგორც CSS, ასევე JS კოდებისთვის!

მაგრამ ამ გზით შეგიძლიათ კომენტარი გააკეთოთ PHP კოდის უფრო მოცულობითი განმარტებით, სადღაც მის მთავარ მაგალითებს შორის ...

ასევე შეგიძლიათ კომენტარი გააკეთოთ php ციკლებში, თუ კოდი შერეულია ... php და რატომღაც html

ზემოთ აღწერილის მსგავსი:

მაგალითად, ზოგიერთი ასეთი ფუნქცია ... სადღაც ზოგად კოდში (ან მარყუჟი html-ში):- შეგიძლიათ კომენტარი გააკეთოთ, ანუ დაამატოთ თქვენი ლეიბლი ასე:

ან ასე: ერთი ლაინერი…

ინტელექტი:

php კოდი არ ჩანს არცერთ წყაროში!! მხოლოდ მისი ფუნქციონალური შედეგი ჩანს - მუშაობს!

სულ ეს იყო, რისი თქმაც მინდოდა დღეს!

ახლა შეგიძლია ექსპერიმენტი... წარმატებები.

და რა თქმა უნდა, წაიკითხეთ საიტის სტატიები და გამოიწერეთ:
მე ვიზიარებ ჩემს მწარე გამოცდილებას - გარკვეულ ცოდნას, თქვენი ტკბილი კეთილდღეობისთვის))

... ვებ მასტერების ქალაქი Michalika.ru© - მარტივად WordPress-ით