Comentarii PHP, Include/Include_once, Require/Require_once

De ce să folosiți 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 de înțeles de către 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

Comentarii PHP

• Comentariile ne ajută să înțelegem codul
• Comentariile sunt explicații pe care le includem în codul sursă. Aceste comentarii sunt pentru înțelegerea umană.
• Comentariile pe o singură linie încep cu bare oblice duble // și se termină în aceeași linie.
• 
• Comentariile pe mai multe rânduri încep cu o bară oblică urmată de asterisc /* și se termină cu asteriscul urmat de bara oblică */.
• 

Diagrama de mai jos arată un fișier PHP cu comentarii atât cu mai multe rânduri, cât și cu o singură linie

Exemplu PHP

PHP Include și PHP Include_once

Declarația php „include” este folosită 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 trebuie inclus.

Instrucțiunea include are următoarea sintaxă

<?php
include 'file_name';
?>

Instrucțiunea include_once are următoarea sintaxă

<?php
include_once 'file_name';
?>

AICI,

• „Include/include_once” este declarația care include fișierul
• „'file_name'” este numele fișierului care urmează să fie inclus.

Exemplu: Include / Include_once

Să presupunem că dezvoltați un site web care conține același meniu de navigare în toate paginile.

Puteți crea un antet comun, apoi includeți-l în fiecare pagină folosind instrucțiunea 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

<a href="index.php">Home</a>

<a href="aboutus.php">About us</a>

<a href="services.php">Services</a>

<a href="contactus.php">Contact Us</a>

index.php

<?php

include 'header.php';

?>

Se va afișa pagina antet de mai sus

PHP Require și PHP require_once

Declarația require are două variante, require și require_once.

Instrucțiunea 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 include.

Are următoarea sintaxă

<?php
require 'file_name';
?>

<?php
require_once 'file_name';
?>

AICI,

• „require/require_once” este declarația care include fișierul
• „'file_name'” este numele fișierului care urmează să fie inclus.

Exemplu: Necesită

Să presupunem că dezvoltăm o aplicație bazată 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

<?php

$config['host'] = 'localhost';

$config['db'] = 'my_database';

$config['uid'] = 'root';

$config['password'] = '';

?>

Să ne uităm acum la exemplul de cod care necesită fișierul de configurare. Pagini_model.php

<?php

require 'config.php'; //require the config file

//other code for connecting to the database

?>

PHP include vs require

Diferența dintre include / require

Include	Necesita
Emite un avertisment atunci când apare o eroare	Nu emite un avertisment
Execuția scriptului continuă atunci când apare o eroare	Execuția 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, execuția scriptului să continue să afișeze adresa de e-mail pentru webmaster sau pagina de contact.

Declarația require ar trebui să fie utilizată dacă întregul script nu poate rula fără fișierul solicitat.

Declarațiile „include” și „require” pot fi folosite la orice linie din codurile sursă în care doriți să apară codul.

Rezumat

• Un singur cod HTML, cum ar fi anteturile, subsolurile, barele laterale etc. poate fi partajat pe mai multe pagini. Acest lucru facilitează actualizarea site-ului web prin actualizarea unui singur fișier.
• Cod 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-se că site-ul web/aplicația utilizează aceleași setări.
• Comentariile sunt folosite pentru a ajuta la înțelegerea codului sursă. Sunt pentru înțelegerea umană
• Declarațiile de comentariu pe o singură linie încep cu bare oblice duble //.
• Declarațiile de comentarii cu mai multe rânduri sunt incluse între instrucțiunile /* */.
• Instrucțiunile „include, include_once, require and require_once” sunt folosite 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.
• Declarația require generează o eroare fatală și oprește execuția scriptului.
• Declarația „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.