De ce să folosești comentarii?
- Dacă nu lucrați la codul sursă de ceva timp, este ușor să uitați ce face codul. Comentarea codului sursă vă ajută să vă amintiți ce face codul.
- Comentarea codului sursă este, de asemenea, foarte importantă atunci când mai mulți dezvoltatori trebuie să lucreze la același proiect. Modificările făcute de un dezvoltator pot fi ușor înțelese de alți dezvoltatori prin simpla citire a comentariilor.
- Ca cea mai bună practică, trebuie să aveți 3 rânduri de comentarii pentru fiecare 10 rânduri de cod
În acest tutorial, veți învăța-
- Comentarii PHP
- PHP Include & PHP Include_once
- Exemplu: Include / Include_once
- PHP Require și PHP require_once
- Exemplu: Solicitați
- PHP include vs cere
Comentarii PHP
- Comentariile ne ajută să înțelegem codul
- Comentariile sunt explicații pe care le includem în codul nostru sursă. Aceste comentarii sunt pentru înțelegerea umană.
- Comentariile cu o singură linie încep cu bare oblice duble // și se termină în aceeași linie.
- Comentariile cu mai multe linii încep cu o bară directă urmată de asterisc / * și se termină cu asteriscul urmat de o bară directă * /.
Diagrama de mai jos arată un fișier PHP cu comentarii atât pe linie multiplă, cât și pe linie simplă Exemplu PHP
PHP Include & PHP Include_once
Instrucțiunea php „include” este utilizată pentru a include alte fișiere într-un fișier PHP.
Are două variante, include și include_once. Include_once este ignorat de interpretul PHP dacă fișierul care urmează să fie inclus.
Instrucțiunea include are următoarea sintaxă
Declarația include_once are următoarea sintaxă
AICI,
- „Include / include_once” este declarația care include fișierul
- „'File_name'” este numele fișierului care trebuie inclus.
Exemplu: Include / Include_once
Să presupunem că dezvoltați un site web care conține același meniu de navigare pe toate paginile.
Puteți crea un antet comun, apoi îl puteți include în fiecare pagină folosind declarația include Să vedem cum se poate face acest lucru.
- Vom crea 2 nume de fișiere
- header.php, index.php
Mai jos sunt codurile pentru; header.php
HomeAbout usServicesContact Us
index.php
Va apărea pagina antet de mai sus
PHP Require și PHP require_once
Declarația require are două variante, require și require_once.
Declarația require / require_once este utilizată pentru a include fișierul.
Require_once este ignorat dacă fișierul necesar a fost deja adăugat de oricare dintre cele patru instrucțiuni de includere.
Are următoarea sintaxă
AICI,
- „Require / require_once” este declarația care include fișierul
- „'File_name'” este numele fișierului care trebuie inclus.
Exemplu: Solicitați
Să presupunem că dezvoltăm o aplicație bazată pe baze de date.
Putem crea un fișier de configurare pe care îl putem include în toate paginile care se conectează la baza de date folosind instrucțiunea require. config.php
Să vedem acum exemplul de cod care necesită fișierul de configurare. Pages_model.php
Php include vs require
Diferența dintre include / require
| Include | Cere |
|---|---|
| Emite un avertisment atunci când apare o eroare | Nu emite un avertisment |
| Executarea scriptului continuă atunci când apare o eroare | Executarea scriptului se oprește atunci când apare o eroare. |
În general, se recomandă utilizarea instrucțiunii include, astfel încât atunci când apare o eroare, executarea scriptului continuă să afișeze adresa de e-mail a webmasterului sau pagina de contactare.
Instrucțiunea require trebuie utilizată dacă întregul script nu poate rula fără fișierul solicitat.
Instrucțiunile „include” și „require” pot fi utilizate pe orice linie din codurile sursă unde doriți să apară codul.
rezumat
- Codul HTML unic, cum ar fi anteturi, subsoluri, bare laterale etc., pot fi partajate pe mai multe pagini. Acest lucru facilitează actualizarea site-ului web doar prin actualizarea unui singur fișier.
- Codul PHP, cum ar fi setările de configurare a bazei de date, funcțiile personalizate etc. pot fi partajate pe mai multe pagini, asigurându-vă că site-ul web / aplicația utilizează aceleași setări.
- Comentariile sunt folosite pentru a înțelege codul sursă. Ele sunt pentru înțelegerea umană
- Declarațiile de comentarii cu o singură linie încep cu bare oblice duble //.
- Declarațiile de comentarii cu mai multe linii sunt cuprinse între / * declarațiile * /.
- Declarațiile „include, include_once, require și require_once” sunt utilizate pentru a include fișiere.
- Include_once / require_once este ignorat dacă fișierul solicitat a fost deja inclus folosind oricare dintre cele patru instrucțiuni.
- Declarația „include” emite un avertisment și continuă cu execuția dacă fișierul solicitat nu a fost găsit.
- Instrucțiunea require ridică o eroare fatală și oprește executarea scriptului.
- Instrucțiunea „include” ar trebui să fie în majoritatea cazurilor, cu excepția situațiilor în care fără ca fișierul solicitat să fie inclus, întregul script nu poate rula.