Funcția require_once

Funcția require_once include fișierul specificat în scriptul curent. Dacă fișierul a fost deja inclus anterior, funcția nu îl va include din nou. Acest lucru este util în special pentru includerea fișierelor cu clase sau funcții, unde includerea repetată poate provoca erori.

Sintaxă

require_once 'path/to/file.php';

Exemplu

Să includem fișierul config.php:

<?php
	require_once 'config.php';
	echo $config['site_name'];
?>

Rezultatul executării codului (dacă în config.php este definit array-ul $config):

'My Site'

Exemplu

Încercarea de a include același fișier din nou:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // Acest apel va fi ignorat
	echo sum(2, 3);
?>

Rezultatul executării codului:

5

Diferența față de require

Spre deosebire de require, funcția require_once verifică dacă fișierul a fost deja inclus și nu efectuează includerea repetată. Acest lucru preîntâmpină erorile la includerea multiplă a aceluiași fișier.

Vezi și

funcția include,
care de asemenea include fișiere, dar nu verifică includerea lor repetată
funcția include_once,
care funcționează similar cu require_once, dar nu provoacă o eroare fatală la absența fișierului