include_once (include_once)
«include_once در PHP» مثل دربان هوشمند است. فایل را فقط یک بار وارد می کند. اگر دوباره صدا بزنی، نادیده می گیرد. بنابراین، هم کد مرتب می شود، هم خطای تکراری کم می شود.
تعریف و کاربرد include_once
کلیدواژه include_once کد را از فایل دیگر می آورد. «دامنه متغیر (Scope)» یعنی محدوده دسترسی متغیر. اگر فایل قبلاً وارد شده باشد، دوباره وارد نمی شود. اگر فایل نبود، اخطار می دهد و ادامه می دهد.
نمونه: افزودن فوتر با include_once
<!DOCTYPE html>
<html>
<body>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
<?php include_once 'footer.php'; ?>
</body>
</html>
گام های عملی
- فایل مشترک بساز، مثلاً
footer.php. - در صفحه اصلی،
include_onceرا بنویس. - مسیر فایل را درست و امن تنظیم کن.
نکته: اگر فوتر را چندجا وارد کنی، include_once در PHP از ورود تکراری جلوگیری می کند.
هشدار: اگر نبود فایل فاجعه است، از require یا require_once استفاده کن.
مقایسه کوتاه
- include: در خطا ادامه می دهد؛ هر بار وارد می کند.
- include_once: در خطا ادامه می دهد؛ فقط یک بار.
- require: در خطا متوقف می شود.
- require_once: توقف در خطا؛ فقط یک بار.
منابع بیشتر: W3Schools: include_once و Include Files Tutorial.
جمع بندی سریع
include_onceاز تکرار جلوگیری می کند.- در نبود فایل، فقط اخطار می دهد.
- برای فایل های حیاتی،
require_onceبهتر است. - مسیر نسبی را با دقت تنظیم کن.