แนะนำตัว
เช่นเดียวกับคำสั่ง include นั้น include_once ยังถ่ายโอนและประเมินสคริปต์ที่เขียนในไฟล์หนึ่งในอีกไฟล์หนึ่ง ความแตกต่างในสองไฟล์อยู่ในความจริงที่ว่า include_once ป้องกันไม่ให้ไฟล์เดียวกันโหลดซ้ำหากทำเสร็จแล้ว ตามชื่อที่ระบุ ไฟล์จะถูกรวมไว้เพียงครั้งเดียวแม้ว่าผู้ใช้จะพยายามรวมคำสั่งอีกครั้งก็ตาม
โดยทั่วไป คำสั่ง include_once จะใช้ในการตั้งค่าตัวแปรส่วนกลาง เปิดใช้งานไลบรารีหรือกิจกรรมใดๆ ที่คาดว่าจะทำในตอนเริ่มต้นของการดำเนินการแอปพลิเคชัน
นอกเหนือจากนี้ พฤติกรรมของคำสั่ง include_once จะคล้ายกับคำสั่ง include
รวม_ครั้งเดียว ตัวอย่าง
ในตัวอย่างต่อไปนี้ testscript.php มีอยู่ในโฟลเดอร์รูทเอกสารของเซิร์ฟเวอร์ Apache มันแทรก test.php โดยใช้คำสั่ง include_once
ตัวอย่าง
<?php echo "calling include_once statement\n"; $result=include_once "test.php"; ?> //test.php <?php echo "This file is included once\n"; ?>
ผลลัพธ์
ซึ่งจะให้ผลลัพธ์ต่อไปนี้ในเบราว์เซอร์หากให้ URL ของ testscript.php -
calling include_once statement
ไฟล์นี้รวมอยู่ในครั้งเดียว
คำเตือนสำหรับความล้มเหลวรวมถึง
parser ปล่อยคำเตือนหากไฟล์อาร์กิวเมนต์ og include_once ไม่พบคำสั่ง
ตัวอย่าง
<?php echo "inside main script<br />"; $var1=100; echo "now calling nosuchfile.php script"; include_once "nosuchfile.php"; echo "returns from nosuchfile.php"; ?>
ผลลัพธ์
ซึ่งจะให้ผลลัพธ์ตามมา โปรดทราบว่าโปรแกรมจะไม่หยุดทำงานเมื่อมีการเตือน -
inside main script now calling nosuchfile.php script PHP Warning: include_once(nosuchfile.php): failed to open stream: No such file or directory in line 5 PHP Warning: include_once(): Failed opening 'nosuchfile.php' for inclusion (include_path='C:\xampp\php\PEAR') in line 5 returns from nosuchfile.php
include_once โทรอีกครั้ง
ตัวอย่างต่อไปรวมถึง test.php พร้อมคำสั่ง include_once โปรดทราบว่าไฟล์เดียวกันจะไม่รวมอยู่อีก
ตัวอย่าง
//main script <?php echo "inside main script<br>"; echo "now including test.php script<br>"; include_once "test.php"; echo "now including again test.php script<br>"; ?> //test.php included <?php echo "This file is included once"; ?>
ผลลัพธ์
ซึ่งจะให้ผลลัพธ์ต่อไปนี้ในเบราว์เซอร์−
inside main script<br />now including test.php script<br />
ไฟล์นี้รวมอยู่ในครั้งเดียว
ตอนนี้รวมสคริปต์ test.php อีกครั้ง