ฟังก์ชัน include_once

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

ไวยากรณ์

include_once 'path/to/file.php';

ตัวอย่าง

รวมไฟล์ config.php เพียงครั้งเดียว:

<?php
	include_once 'config.php';
	include_once 'config.php'; // การเรียกค่านี้จะถูกละเว้น
?>

ตัวอย่าง

ลองรวมไฟล์ที่ไม่มีอยู่:

<?php
	include_once 'nonexistent.php'; // จะทำให้เกิดคำเตือน แต่จะไม่หยุดการทำงานของสคริปต์
	echo 'Script continues...';
?>

ผลลัพธ์จากการรันโค้ด:

Warning: include_once(nonexistent.php): failed to open stream: No such file or directory
Script continues...

ตัวอย่าง

การใช้ตัวแปรเพื่อระบุพาธ:

<?php
	$filePath = 'lib/functions.php';
	include_once $filePath;
?>

ดูเพิ่มเติม

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