ฟังก์ชัน require_once

ฟังก์ชัน require_once เชื่อมต่อไฟล์ที่ระบุเข้ากับสคริปต์ปัจจุบัน หากไฟล์ถูกเชื่อมต่อมาก่อนหน้านี้แล้ว ฟังก์ชันจะไม่เชื่อมต่อมันอีกครั้ง สิ่งนี้มีประโยชน์เป็นพิเศษสำหรับการเชื่อมต่อไฟล์ที่มีคลาสหรือฟังก์ชัน ซึ่งการเชื่อมต่อซ้ำอาจทำให้เกิดข้อผิดพลาด

ไวยากรณ์

require_once 'path/to/file.php';

ตัวอย่าง

มาเชื่อมต่อไฟล์ config.php:

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

ผลลัพธ์ของการดำเนินการโค้ด (หากใน config.php กำหนดอาร์เรย์ $config ไว้):

'My Site'

ตัวอย่าง

ความพยายามในการเชื่อมต่อไฟล์เดียวกันซ้ำ:

<?php
	require_once 'functions.php';
	require_once 'functions.php'; // การเรียกนี้จะถูกละเว้น
	echo sum(2, 3);
?>

ผลลัพธ์ของการดำเนินการโค้ด:

5

ความแตกต่างจาก require

แตกต่างจาก require, ฟังก์ชัน require_once ตรวจสอบว่าไฟล์ถูกเชื่อมต่อไปแล้วหรือไม่ และไม่ดำเนินการเชื่อมต่อซ้ำ สิ่งนี้ป้องกันข้อผิดพลาดจากการรวมไฟล์เดียวกันหลายครั้ง

ดูเพิ่มเติม

ฟังก์ชัน include,
ซึ่งเชื่อมต่อไฟล์ด้วยเช่นกัน แต่ไม่ตรวจสอบการรวมซ้ำ
ฟังก์ชัน include_once,
ซึ่งทำงานคล้ายคลึงกับ require_once แต่ไม่เกิดข้อผิดพลาดร้ายแรงหากไม่มีไฟล์