Коментарі PHP, Include/Include_once, Require/Require_once
Навіщо використовувати коментарі?
- Якщо ви деякий час не працюєте над вихідним кодом, легко забути, що він робить. Коментування вихідного коду допомагає запам’ятати, що він робить.
- Коментування вихідного коду також дуже важливо, коли кілька розробників працюють над одним проектом. Зміни, внесені одним розробником, можуть бути легко зрозумілі іншим розробникам, просто прочитавши коментарі.
- Як найкраща практика, ви повинні мати 3 рядки коментарів на кожні 10 рядків коду
Коментарі PHP
- Коментарі допомагають нам зрозуміти код
- Коментарі – це пояснення, які ми включаємо у вихідний код. Ці коментарі для людського розуміння.
- Однорядкові коментарі починаються з подвійної похилої риски // і закінчуються в одному рядку.
-
- Багаторядкові коментарі починаються з похилої риски, за якою йде зірочка /*, і закінчуються зірочкою, за якою йде похила риска */.
-
На діаграмі нижче показано PHP-файл із багаторядковими та однорядковими коментарями
Приклад PHP
PHP Include & PHP Include_once
Інструкція «include» php використовується для включення інших файлів у файл PHP.
Він має дві варіації, include і include_once. Include_once ігнорується інтерпретатором PHP, якщо файл буде включено.
Оператор include має такий синтаксис
<?php include 'file_name'; ?>
Оператор include_once має такий синтаксис
<?php include_once 'file_name'; ?>
ТУТ,
- «Include/include_once» — це оператор, який включає файл
- “'file_name'” – це ім’я файлу, який буде включено.
Приклад: Include / Include_once
Припустімо, ви розробляєте веб-сайт, який містить однакове меню навігації на всіх сторінках.
Ви можете створити загальний заголовок, а потім включити його на кожну сторінку за допомогою оператора include. Давайте подивимося, як це можна зробити.
- Ми створимо 2 імена файлів
- header.php, index.php
Нижче наведено коди для; 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'; ?>
Виведеться заголовок сторінки вище
PHP Require & PHP require_once
Оператор require має дві варіації, require і require_once.
Інструкція require/require_once використовується для включення файлу.
Require_once ігнорується, якщо необхідний файл уже додано будь-яким із чотирьох операторів включення.
Він має такий синтаксис
<?php require 'file_name'; ?>
<?php require_once 'file_name'; ?>
ТУТ,
- “require/require_once” – це оператор, який включає файл
- “'file_name'” – це ім’я файлу, який буде включено.
Приклад: Вимагати
Припустімо, що ми розробляємо програму на базі даних.
Ми можемо створити файл конфігурації, який можна включити в усі сторінки, які підключаються до бази даних за допомогою оператора require. config.php
<?php $config['host'] = 'localhost'; $config['db'] = 'my_database'; $config['uid'] = 'root'; $config['password'] = ''; ?>
Давайте тепер розглянемо зразок коду, для якого потрібен файл конфігурації. Pages_model.php
<?php require 'config.php'; //require the config file //other code for connecting to the database ?>
PHP включає проти вимагає
Різниця між включати / вимагати
Include | Вимагати |
---|---|
Видає попередження, коли виникає помилка | Не видає попередження |
Виконання сценарію продовжується, коли виникає помилка | Виконання сценарію припиняється, коли виникає помилка. |
Зазвичай рекомендується використовувати оператор include, щоб у разі виникнення помилки виконання сценарію продовжувало відображати адресу електронної пошти веб-майстра або сторінку зв’язку з нами.
Оператор require слід використовувати, якщо весь сценарій не може працювати без запитуваного файлу.
Оператори «include» і «require» можна використовувати в будь-якому рядку вихідного коду, де ви хочете, щоб код з’явився.
Підсумки
- Один HTML-код, як-от верхні, нижні колонтитули, бічні панелі тощо, можна використовувати на багатьох сторінках. Це спрощує оновлення веб-сайту, оновивши лише один файл.
- PHP -код такі як параметри конфігурації бази даних, спеціальні функції тощо, можна використовувати на багатьох сторінках, гарантуючи, що веб-сайт/додаток використовує однакові налаштування.
- Коментарі використовуються, щоб допомогти зрозуміти вихідний код. Вони для людського розуміння
- Однорядкові коментарі починаються з подвійної похилої риски //.
- Багаторядкові оператори коментарів укладено між /* операторами */.
- Інструкції «include, include_once, require і require_once» використовуються для включення файлів.
- Include_once/require_once ігнорується, якщо запитуваний файл уже включено за допомогою будь-якого з чотирьох операторів.
- Оператор «include» видає попередження та продовжує виконання, якщо запитуваний файл не знайдено.
- Інструкція require викликає фатальну помилку та зупиняє виконання сценарію.
- Інструкція «include» має бути в більшості випадків, за винятком ситуацій, коли без запитуваного файлу, який потрібно включити, весь сценарій не може запуститися.