Dlaczego warto korzystać z komentarzy?
- Jeśli nie pracujesz nad kodem źródłowym przez jakiś czas, łatwo zapomnieć, co robi kod. Komentowanie kodu źródłowego pomaga zapamiętać, co robi kod.
- Komentowanie kodu źródłowego jest również bardzo ważne, gdy wielu programistów musi pracować nad tym samym projektem. Zmiany wprowadzone przez jednego programistę mogą być łatwo zrozumiane przez innych programistów, po prostu czytając komentarze.
- Zgodnie z najlepszą praktyką musisz mieć 3 wiersze komentarzy na każde 10 wierszy kodu
W tym samouczku nauczysz się:
- Komentarze PHP
- PHP Include & PHP Include_once
- Przykład: Include / Include_once
- Wymaganie PHP i jednorazowe wymaganie PHP
- Przykład: Wymagaj
- PHP include vs require
Komentarze PHP
- Komentarze pomagają nam zrozumieć kod
- Komentarze to wyjaśnienia, które umieszczamy w naszym kodzie źródłowym. Te komentarze mają na celu zrozumienie przez ludzi.
- Komentarze jednowierszowe zaczynają się od podwójnych ukośników // i kończą w tym samym wierszu.
- Komentarze w wielu wierszach rozpoczynają się od ukośnika, po którym następuje gwiazdka / * i kończą się gwiazdką, po której następuje ukośnik * /.
Poniższy diagram przedstawia plik PHP z komentarzami wielowierszowymi i jednowierszowymi. Przykład PHP
PHP Include & PHP Include_once
Instrukcja php „include” służy do dołączania innych plików do pliku PHP.
Ma dwie odmiany, include i include_once. Include_once jest ignorowane przez interpreter PHP, jeśli plik ma zostać dołączony.
Instrukcja include ma następującą składnię
Instrukcja include_once ma następującą składnię
TUTAJ,
- „Include / include_once” to instrukcja zawierająca plik
- „Nazwa_pliku” to nazwa dołączanego pliku.
Przykład: Include / Include_once
Załóżmy, że tworzysz witrynę internetową, która zawiera to samo menu nawigacyjne na wszystkich stronach.
Możesz utworzyć wspólny nagłówek, a następnie umieścić go na każdej stronie za pomocą instrukcji include. Zobaczmy, jak można to zrobić.
- Stworzymy 2 nazwy plików
- header.php, index.php
Poniżej znajdują się kody; header.php
HomeAbout usServicesContact Us
index.php
Zostanie wyświetlona strona nagłówkowa powyżej
Wymaganie PHP i jednorazowe wymaganie PHP
Instrukcja require ma dwie odmiany, require i require_once.
Instrukcja require / require_once jest używana do dołączania pliku.
Require_once jest ignorowana, jeśli wymagany plik został już dodany przez którąkolwiek z czterech instrukcji include.
Ma następującą składnię
TUTAJ,
- „Require / require_once” to instrukcja zawierająca plik
- „Nazwa_pliku” to nazwa dołączanego pliku.
Przykład: Wymagaj
Załóżmy, że tworzymy aplikację opartą na bazie danych.
Możemy utworzyć plik konfiguracyjny, który możemy umieścić na wszystkich stronach, które łączą się z bazą danych za pomocą instrukcji require. config.php
Spójrzmy teraz na przykładowy kod, który wymaga pliku konfiguracyjnego. Pages_model.php
PHP zawiera vs wymaga
Różnica między include / require
| Zawierać | Wymagać |
|---|---|
| Wysyła ostrzeżenie, gdy wystąpi błąd | Nie generuje ostrzeżenia |
| Wykonywanie skryptu jest kontynuowane, gdy wystąpi błąd | Wykonywanie skryptu zatrzymuje się, gdy wystąpi błąd. |
Ogólnie zaleca się użycie instrukcji include, aby w przypadku wystąpienia błędu wykonanie skryptu nadal wyświetlało adres e-mail webmastera lub stronę kontaktową.
Należy użyć instrukcji require, jeśli cały skrypt nie może zostać uruchomiony bez żądanego pliku.
Instrukcje „include” i „require” mogą być używane w dowolnym wierszu kodu źródłowego, w którym ma się pojawić kod.
Podsumowanie
- Pojedynczy kod HTML, taki jak nagłówki, stopki, paski boczne itp., Może być udostępniany na wielu stronach. Ułatwia to aktualizację witryny poprzez aktualizację pojedynczego pliku.
- Kod PHP, taki jak ustawienia konfiguracji bazy danych, niestandardowe funkcje itp., Można udostępniać na wielu stronach, zapewniając, że witryna / aplikacja korzysta z tych samych ustawień.
- Komentarze pomagają zrozumieć kod źródłowy. Są dla ludzkiego zrozumienia
- Jednowierszowe instrukcje komentarza rozpoczynają się od podwójnych ukośników //.
- Wielowierszowe instrukcje komentarzy znajdują się między / * instrukcjami * /.
- Instrukcje „include, include_once, require i require_once” są używane do dołączania plików.
- Include_once / require_once jest ignorowane, jeśli żądany plik został już uwzględniony przy użyciu jednej z czterech instrukcji.
- Instrukcja „include” generuje ostrzeżenie i kontynuuje wykonywanie, jeśli żądany plik nie został znaleziony.
- Instrukcja require zgłasza błąd krytyczny i zatrzymuje wykonywanie skryptu.
- Instrukcja „include” powinna występować w większości przypadków, z wyjątkiem sytuacji, w których bez żądanego pliku do dołączenia nie można uruchomić całego skryptu.