Include Files

یکی از قابلیت‌های مهم PHP اینه که می‌تونیم یک فایل PHP رو داخل فایل دیگه استفاده کنیم.
این کار باعث کاهش تکرار کدها و مدیریت بهتر پروژه میشه.

🔹 دستور include

با استفاده از include می‌تونیم یک فایل خارجی رو وارد کنیم.

مثال:

📂 ساختار فایل‌ها:

header.php
index.php

header.php

<h1>Welcome to My Website</h1>
<p>This is the header section.</p>

index.php

<!DOCTYPE html>
<html>
<body>

<?php include 'header.php'; ?>

<p>This is the main content of the page.</p>

</body>
</html>

📌 خروجی:

Welcome to My Website
This is the header section.
This is the main content of the page.

🔹 تفاوت include و require

  • include → اگر فایل وجود نداشته باشه، یک warning میده اما اجرای بقیه کد ادامه پیدا می‌کنه.

  • require → اگر فایل وجود نداشته باشه، یک fatal error میده و اجرای کد متوقف میشه.

مثال:

<?php
include("file_not_exists.php"); 
echo "Hello World"; // همچنان اجرا میشه

require("file_not_exists.php");
echo "This will not be executed"; // این اجرا نمیشه
?>

🔹 include_once و require_once

برای جلوگیری از وارد کردن چندباره یک فایل، از نسخه‌های _once استفاده می‌کنیم.

مثال:

<?php
include_once "header.php";
include_once "header.php"; // دوباره وارد نمیشه

require_once "config.php";
require_once "config.php"; // فقط یکبار وارد میشه
?>

✅ نکات مهم

  • برای فایل‌های تکراری مثل header, footer, menu بهترین راه استفاده از include/require هست.

  • اگر وجود فایل خیلی حیاتی باشه (مثل فایل تنظیمات دیتابیس) → از require استفاده کنید.

  • اگر وجود فایل حیاتی نباشه (مثل تبلیغات یا بخش جانبی سایت) → از include استفاده کنید.