Html ve php'de yorumlar. HTML, CSS, PHP'de yorumlar

25.04.2017

Herkese merhaba!
PHP temellerini sıfırdan öğrenmeye devam edin!
Bu derste size PHP'de bir yorumun ne olduğunu anlatacağım ve pratikte yorumumuzu koda yazmaya çalışacağız. Ama hepsi bu değil. Ayrıca size kodu nasıl yorumlayacağınızı ve neden yapmanız gerektiğini anlatmak istiyorum.

yorum nedirPHP
yorum yapPHP- bu, kodda hızlı gezinme ve düzenlemeler için bir php geliştiricisinin ipucudur.

PHP'deki yorum, web sayfasını görüntülemek için açan kullanıcı tarafından görülmez. Kullanıcı sayfanın kaynak koduna bakmaya karar verse bile, tüm php.ini dosyalarından bu yana yorum yine görünmeyecektir.

PHP kodu yorumu

PHP kodu için 2 tür yorum vardır:

→ bir satır
→ çok satırlı

⇒ PHP için tek satırlık yorum
Tek satırlık bir yorum için "//" veya "#" sembollerini kullanın.

Bu karakterlerden sonra bir satıra yazılan her şey yok sayılacak ve yorum olarak kabul edilecektir.

Güncellemeye abone olun "; # abonelik (bu bir yorumdur)?>

Güncellemek için abone olun

⇒ PHP için çok satırlı yorum
PHP için çok satırlı bir yorum "/ *" ile başlar ve "* /" ile biter.
Bu karakterler arasındaki herhangi bir şey yok sayılır ve yorum olarak kabul edilir.
Kayıtta birden çok satır varsa, çok satırlı bir yorum kullanılır.

Ekranda yalnızca aşağıdaki metni göreceksiniz:

Merhaba blog okuyucuları - site !!!

Not: Her zaman kodunuzu yorumlayın. 1-2 yıl içinde kodda yaptığınız her şeyi hatırlayacağınızı düşünüyorsanız yanılıyorsunuz, şans çok az. Hatırlasanız bile neyi, nerede ve neden çalışmak için çok zaman harcamanız gerekecek...
Gelecekte kendiniz için hoş bir şey yapın - kodu yorumlayın ve ardından kendinize “TEŞEKKÜRLER !!!” diyeceksiniz.
Kodda bir yorum bırakın, 1 dakika sürecek, ancak gelecekte size tam bir gün kazandıracak.

PHP kodunu yorumlayın

Diyelim ki php kodu yazdınız ama nedense koddan 2 satırı çıkarmanız gerekiyor.
Koddan bir şey çıkarmak için acelem yok, özellikle de php koduysa, yorum yapmayı tercih ederim. Ya kodu iade etmeniz gerekirse. Yorumu kaldırmak, kodu yeni bir şekilde yazmaktan daha kolaydır.

İçindeki kod nasıl yorumlanırPHP
Tek satırlık yorum içeren örnek:

Güncellemeye abone olun ";?>

Çok satırlı yorum içeren bir örnek.

Yazardan: yorumlama, uygulaması kolay özelliklerden biridir. Aynı zamanda, bu düzenleme öğeleri, kodlarını elden ele veren geliştiricilere büyük fayda sağlayabilir. Bugün PhpStorm'da bir bloğu nasıl yorumlayacağınızı öğreneceksiniz. Programın içeriğini yorumlamak için geri kalan geliştirme ortamı işlevselliğini de dikkate alacağız.

Yorumlar: iyi ve kötü

Kod yorumlama çoğu programlama dilinde mevcuttur (muhtemelen hepsinde, ancak değişen derecelerde kullanılabilirlik ile). Tipik olarak, sözlü açıklamalar diğer ekip üyelerinin daha fazla gelişmesine yardımcı olmak için veya sadece bu alanın düzeltilmesi gerektiğini kendimize hatırlatmak için kullanılır (“BENİ DÜZELTME”).

Yazılanların izahı elbette bir lütuftur. Ancak yorumların yardımıyla kodun tüm iyi yönlerini de aşabilirsiniz. Bunun olmasını önlemek için yorum türlerini ayırt etmek gerekir:

belgelemek. İyi bir ilişkilendirme, çeşitli yazılımlar için dokümantasyon kavramı olacaktır. Bu tür yorumlar, kodu bir talimat gibi kullanmanıza yardımcı olur. Bu tür yorumlar gereksiz olarak algılanmaz, çünkü onsuz hiçbir şey yoktur. Birinin bir geliştirme çerçevesi kullandığını ve size programı nasıl kullanacağınızı söylemediğini hayal edin;

JavaScript. Hızlı başlangıç

açıklayan. İyi kod genellikle onlara ihtiyaç duymaz. Bir programda ne kadar çok yorum satırı görürseniz, programın kötü yazılmış olma olasılığı o kadar artar. Elbette bu mutlak bir kural değildir.

Açıklayıcı yorumlar ileride kodu düzeltecek olanlar için faydalı olabilir. Örneğin, birçok genç profesyonel, her yerde iyileştirme alanı görüyor. Kendilerinden önce her şeyin daha kötü olduğuna inanıyorlar ve şimdi her bir özelliği düzeltmenin zamanı geldi.

Bazen benzer bir duygu profesyonelleri bunaltıyor. Örneğin, her şey şaşırtıcı bir şekilde çarpık göründüğünde, daha iyi bir çözüm olmalı. Takipçileri en iyiyi aramaktan kurtarmak için programcı şöyle bir not bırakabilir: # time_spent_here = 24h

Bu tür sözlerden sonra, çok az insan bu kadar çok zaman geçirmek ister. Bu nedenle, birçok farklı seçeneğin zaten sıralanmış olduğu konusunda uyarıyorsunuz. Aynı zamanda şu tür saldırılardan da kaçınmalısınız: #i_hate_this, # try_to_do_better_ass %% le. Bu şekilde sadece profesyonel olmayan bir tutum sergilemiş olursunuz. Kendinizden ve işvereninizden ödün vermeyin.

Ancak kodun belgesel yorumu, programcı için bir balast haline gelebilir. Kural olarak, bunlar doğrudan programlamadan dikkati dağıtan büyük bölümlerdir. Ancak kodu yorumsuz görüntülemek için ana IDE'lerin karşılık gelen bir işlevi vardır. PhpStorm bir istisna olmamalı, ama ne yazık ki. Güncelleme belgelerinde özelliği arayın.

İşlevsel bir öğe olarak etiketleyin

Yorum yapmanın bir açıklama ve ekip gelişimine yardımcı olması amaçlanırken, bu özellikler yaygın olarak kullanılmaz. Kural olarak, etiketler kodun yürütülmesini durdurmak istedikleri yere yerleştirilir. Diyelim ki HTML'ye gömülü PHP'niz var. Ve onu silmek istemiyorsunuz, sadece sayfanın onsuz nasıl göründüğünü görmek istiyorsunuz. Bunu yapmak için aşağıdaki sözdizimini izlemelisiniz:

JavaScript

…

...

…< div > . . . < / div >

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

< div > . . . < / div >

Gördüğünüz gibi basit eylemlerle, karmaşık işlemler bile gerçekleştirmeden kodun yürütülmesini durdurabilirsiniz. Ama aslında, bu henüz optimizasyonun zirvesi değil. Geliştirici için ek kolaylık, phpStorm IDE'nin kendisi tarafından sağlanır. Vurgulama ve klavye kısayollarını kullanarak, özel etiketler eklemeden seçilen kod segmentini yorumlayabilirsiniz. Bu şöyle yapılabilir.

Sizin için uygun bir yöntem kullanarak bir metin parçası seçin (fare, kısayollar).

Ctr + Shift + / klavye kısayoluna basın

Ayrıca mevcut satıra yorum yapabilirsiniz. Her şey aynı, sadece Shift olmadan.

Bu tür yorumların avantajı, birkaç dili aynı anda kapsamasıdır. PHP nadiren kendi başınadır. Bu şekilde, her birini etiketlemek zorunda kalmazsınız. Ortam birkaç web dilini daha destekler. Sadece bir parça seçin ve kombinasyonu satın - bu çok dilli koddur ve yorumlanmıştır. Aynı şekilde aktif hale getirilebilir.

Bizim için bu kadar. Bu özellikleri daha önce kullanmadıysanız, başlamanızı öneririz. Kısaltmalar işi daha hızlı ve daha iyi hale getirir.

JavaScript. Hızlı başlangıç

Web uygulaması oluşturmaya yönelik uygulamalı bir örnekle JavaScript'in temellerini öğrenin

PHP'deki yorumlar, HTML'de kullanılan yorumlara benzer. PHP sözdiziminde, yorumlar her zaman özel bir karakter dizisiyle başlar ve bu özel karakterler arasında görünen tüm metinler yorumlayıcı tarafından yok sayılır.

HTML'de bir yorumun temel amacı, sitenizin kaynak kodunu görüntüleyebilen geliştiricilere bir not olarak hizmet etmektir. PHP yorumları, ziyaretçilere gösterilmemeleri bakımından farklılık gösterir. PHP yorumlarını görmenin tek yolu dosyayı düzenlemek için açmaktır. Bu, PHP yorumlarını yalnızca PHP programcıları için yararlı kılar.

HTML'de yorumların nasıl yapıldığını unuttuysanız veya bilmiyorsanız, aşağıdaki örneğe bakın.

Php yorum sözdizimi: tek satırlık yorum

Html'nin yalnızca bir tür yorumu varken, PHP'nin iki yorumu vardır. Tartışacağımız ilk tür, tek satırlık yorumdur. Yani yorumcuya yorumların sağındaki bu satırda olan her şeyi görmezden gelmesini söyleyen bir yorum. Bu yorumu kullanmak için "//" veya "#" karakterlerini kullanın ve sağdaki tüm metinler PHP yorumlayıcısı tarafından yok sayılır.

Psst ... "PHP yorumlarımı göremezsiniz!"; // yankı "hiçbir şey"; // echo "Adım Humperdinkle!"; # echo "Ben de hiçbir şey yapmıyorum";?>

Sonuç:

Selam Dünya! Psst ... PHP yorumlarımı göremezsiniz!

Yankı komutlarımızdan bazılarının, onları yorum özel karakterleriyle yorumladığımız için işlenmediğini unutmayın. Bu tür bir yorum genellikle karmaşık ve kafa karıştırıcı kodlar hakkında hızlı bir şekilde yazmak veya bir PHP kodu satırını geçici olarak kaldırmak (hata ayıklama için) için kullanılır.

Php yorum sözdizimi: çok satırlı yorum

HTML yorumları gibi, PHP çok satırlı yorumlar, büyük kod bloklarını yorumlamak veya birden çok satıra yorum yazmak için kullanılabilir. PHP'de çok satırlı yorumlar "/ *" ile başlar ve "* /" ile biter. Bu karakterler arasındaki herhangi bir şey yok sayılır.

Sonuç.

... bugün bu kısa ama faydalı yazıda, farklı program kodlarının nasıl yorumlandığını anlayacağız. Çok fazla bir şey söylemeyeceğim çünkü bununla ilgileniyorsanız, o zaman bu sorunun sorularıyla zaten karşılaştınız ve bunun hakkında bir fikriniz var.

Adrese geldiniz ... ancak netlik ve davanın yararı için birkaç kelime. Muhtemelen bunun CSS koduyla nasıl yapıldığını görmüşsünüzdür, çünkü css benim gibi birçok yeni başlayanın ilgisini çekiyor.

… İyi!

Ancak, yorumların şu durumlarda da kullanıldığını unutmayın. html ve php... Ancak yeni başlayanların çoğu, site ile çalışmalarının ilk aşamasında kafaları karışır ve kendileri için gerekli açıklamaları nasıl ekleyeceğini bilemez. Sonuçta, olur, örneğin, bir süre devre dışı bırakmanız gerekir. HTML Kodu, ve sonra tekrar işlevine devam edin - "kenar boşluklarında" kendiniz için notlar aldıysanız, uygulaması kolaydır, ancak ne olduğunu asla bilemezsiniz.

Ancak genel olarak "yorumlar" hakkında hatırlanması gerekenler - buradaki her şey, özellikle hangi dosyayla çalıştığınıza bağlıdır ve bu nedenle uygulama kodu farklıdır.

CSS kodunu yorumlama

a: üzerine gelin, a: odak (renk: # D5071E; metin-dekorasyon: Üst çizgi; / * ALT ÇİZGİ YUKARI * /)

Kendinizi bu şekilde açıklıyorsunuz. Veya bu css betiğini tamamen şu şekilde yorumlayabilirsiniz: sadece sarın

/ * burada KOD * /

/ * a: üzerine gelin, a: odak (renk: # D5071E; metin-dekorasyon: alt çizgi; / * ALT ÇİZGİ * /) * /

Dikkatinizi şu gerçeğe çekiyorum - css kodunun tüm döngüsünü bu şekilde yorumlayabilirsiniz, ancak !! o zaman tekrarlanan yorumları kaldırmanız / * ALT ÇİZGİ * / veya açıklama önemliyse eğik çizgi ile oynamanız gerekir))

Aksi takdirde bir hata olacaktır !!

Not:

Sayfanın kaynak kodunu açarsanız - Ctrl + U ve bir göz atarsanız ... yorumlanan css kodunun oluşturulan belgede güzel bir şekilde görüntülendiğini göreceğiz! bu, doğrudan html'de css kullanılmışsa (özellikler ayarlanmışsa)

Ve bildiğiniz gibi, kaynak kodundan aktif şablonunuzun css belgesine başvurarak giderseniz, birinin ihtiyacı varsa, tüm yorumlar gözlemlenebilir ve incelenebilir))). Ama bu pek olası değil)

İngilizce zarf (kelimeler) okunabilir olacaktır. Rus sembolizmi - hayır.

HTML kodunu yorumlama

XML dosyası aynı şekilde yorumlanır.

Önemli: Her zaman makalelerde verilen kodu en azından görsel olarak kontrol edin) aksi halde hatalar olabilir.

Biçimlendirme sırasındaki olağan dikkatsizlik zaman alıcı olabilir, örneğin, yukarıda gösterilen YORUMLANAN kod genellikle yanlıştır: iki kısa tire yerine bir uzun tire görünür:

Bilginize:

önceki açıklamada söylendiği gibi - yorum da öyle ... oluşturulan belgede html kodu görüntülenir!

Bunu aklında tut.

Ve işte başka bir şey:

yorumlanan kodun sayfanın kaynak kodunda görüntülenmesine ek olarak (yani sayfada da görünmez olmasına rağmen bir anlamda işlendiği anlamına gelir!) - birlikte bazı php işlevlerini kaldırmak daha iyidir etkin belgeden html ile.

Örneğin:

belgede ve işlevde görünecekişini harika bir şekilde yapacak: yani, bilgi ön uçta görünmeyecek, ancak kaynakta görünecek - net bir şekilde görüntülenecek! ve bu veritabanına özel bir istek: tüm bunlar önemsiz, ama bilmeniz gerekiyor!

Belgeden bir kod parçası çıkarmak istemiyorsanız bunu yapmak mümkündür:

açılıştan önce gerekli "ekstra" html kodunu ekleyin... satır içi işlev ... ve kapatılıyor mu?> ...

Tek kelimeyle, kod büyükse bunu şu şekilde yapabilirsiniz:

**/ ?>

o zaman kaynak temiz olacak!

Veya daha basit:

Html belgesinde işlevin kendisini yorumlayalım. Bu durumlarda kaynak kodu, işlevlerin geliştirilmesiyle ilgili olarak temiz olacaktır!

JavaScript nasıl yorumlanır

if (gösteriliyor || gösteriliyor) (// animasyonu tekrar tetikleme geri dön;) başka (// satırda HERHANGİ BİR YORUM uygula // satırda HERHANGİ BİR YORUM uygula // true;

Netlik için, noktalama işaretlerini biraz düzelterek bu örnek JavaScript kodunu netten aldım. Önemli değil ... Asıl mesele, prensibi anlamaktır ...

Anladığınız gibi, eğik çizgi "//" çifttir, bu yorumun İŞARET'idir ... TEK SATIR!

JS kodunun geri kalanı php gibi yorumlanmıştır, daha fazlası aşağıdadır:

açıklama: