include_once في PHP

(PHP 4, PHP 5, PHP 7)

تُضمِّن العبارة include_once الملفّ المحدد وتعالجه أثناء تنفيذ الشيفرة. هذه السلوك مشابه لعبارة include والفرق الوحيد هنا هو إن كانت شيفرة ذلك الملف مضمّنة من قبل فإنّها لن تُضمِّنَه مرة أخرى، وترجع include_once القيمة TRUE، وهذا السلوك متوقع من اسم العبارة.

يمكن استخدام include_once في الحالات التي يمكن لنفس الملف أن يُضمَّن ويُعالَج لأكثر من مرة خلال مرحلة معيّنة من مراحل تنفيذ الشيفرة، وفي هذه الحالة يمكن تجنب بعض المشاكل مثل إعادة تعريف الدوال أو إعادة إسناد المتغيرات، وما إلى ذلك.

راجع توثيق include للحصول على المزيد من المعلومات عن طريقة عمل هذه الدالة.

ملاحظة: في PHP 4، تختلف وظيفة ‎ _onceباختلاف حساسية النظام لحالة الأحرف (مثل نظام ويندوز) فعلى سبيل المثال:

المثال 1: استخدام include_once في نظام حساس لحالة الأحرف في PHP 4

<?php
include_once "a.php";
// سيضمّن هذا الملف في الشيفرة
include_once "A.php";
// سيُضمّن الملف السابق مرة أخرى وذلك في الإصدار 4 من اللغة فقط
?>

تغيّر هذا السلوك في PHP 5 فعلى سبيل المثال في نظام ويندوز تُعالج المسارات في البداية لذا يُعدّ المسار C:\PROGRA~1\A.php مطابقًا للمسار C:\Program Files\a.php وسيُضمَّن الملف مرة واحدة فقط.

مصادر

• صفحة include_once في توثيق PHP الرسمي.