آموزش رایگان PHP

آموزش کامل include و require در PHP + تفاوت‌های کلیدی و کاربردی

1405/05/01 20:28 محراب حسن زاده
آموزش کامل include و require در PHP + تفاوت‌های کلیدی و کاربردی

مقدمه: ماژولار نویسی در PHP چیست؟

یکی از بزرگ‌ترین مزایای برنامه‌نویسی مدرن، امکان تقسیم‌بندی کدها به بخش‌های کوچک‌تر و مدیریت آسان‌تر آن‌هاست. در PHP، ابزارهای اصلی برای این کار دستورات include و require هستند. با استفاده از این دستورات، می‌توانید فایل‌های مشترک مانند هدر، فوتر، تنظیمات پایگاه داده و توابع کمکی را در فایل‌های جداگانه ذخیره کرده و در صفحات مختلف فراخوانی کنید.

آموزش دستور include در PHP

دستور include برای وارد کردن محتوای یک فایل مشخص به درون یک فایل دیگر استفاده می‌شود. اگر فایل مورد نظر پیدا نشود، برنامه متوقف نمی‌شود؛ بلکه یک پیام هشدار (Warning) صادر کرده و بقیه کدهای صفحه را اجرا می‌کند.

مثال زیر نحوه بارگذاری یک فایل هدر ساده را با این دستور نشان می‌دهد:


// index.php
include 'header.php';
echo "

"; // این بخش محتوای اصلی صفحه است.

 

"; include 'footer.php'; ?>

آموزش دستور require در PHP

دستور require نیز دقیقاً مانند include عمل می‌کند، با این تفاوت که برای فایل‌های حیاتی و ضروری سیستم استفاده می‌شود. اگر فایلی که با require فراخوانی شده است وجود نداشته باشد یا آدرس آن اشتباه باشد، PHP یک خطای کشنده (Fatal Error) صادر کرده و بلافاصله اجرای کل اسکریپت را متوقف می‌کند.


// db_connection.php برای اتصال به پایگاه داده حیاتی است
require 'config.php';
require 'database.php';

echo "اتصال به پایگاه داده با موفقیت انجام شد.";

تفاوت‌های کلیدی میان include و require

انتخاب بین این دو دستور به اهمیت فایلی که می‌خواهید بارگذاری کنید بستگی دارد. جدول زیر تفاوت‌های اصلی این دو را مشخص می‌کند:

  • سطح خطا (Error Level): دستور include خطای نوع E_WARNING تولید می‌کند، در حالی که require خطای نوع E_COMPILE_ERROR تولید می‌کند.
  • ادامه اجرای کد: پس از بروز خطا در include، مرورگر بقیه المان‌های صفحه را نشان می‌دهد. اما در require، با بروز خطا، صفحه کاملاً سفید شده یا پیام خطا نمایش داده می‌شود و چیزی رندر نمی‌گردد.
  • بهترین سناریوی کاربرد: برای فایل‌های قالب گرافیکی (مثل منو یا فوتر) از include و برای فایل‌های هسته، کانفیگ، کتابخانه‌ها و توابع امنیتی از require استفاده کنید.

نسخه‌های include_once و require_once

برخی اوقات در پروژه‌های بزرگ ممکن است یک فایل را به صورت اشتباهی چند بار فراخوانی کنید (مثلاً فراخوانی مجدد فایل توابع یا اتصالات دیتابیس). این کار باعث بروز خطای تداخل توابع یا مصرف بی‌مورد منابع سرور می‌شود. برای حل این مشکل، PHP نسخه‌های پسوند دار _once را ارائه داده است.

این دستورات ابتدا بررسی می‌کنند که آیا فایل مورد نظر قبلاً در طول اجرای اسکریپت بارگذاری شده است یا خیر. اگر بارگذاری شده باشد، از بارگذاری مجدد آن جلوگیری می‌کنند.


// بارگذاری فایل توابع فقط برای یک بار
require_once 'functions.php';
require_once 'functions.php'; // این خط نادیده گرفته می‌شود و خطایی رخ نمی‌دهد

استانداردهای پیشنهادی گوگل و Best Practices

  1. مسیردهی مطلق به جای نسبی: همیشه سعی کنید آدرس فایل‌ها را با استفاده از ثابت __DIR__ به صورت مطلق تعریف کنید تا سرعت لود فایلهای سیستم افزایش یابد و امنیت مسیرها تضمین شود.
  2. استفاده هوشمندانه از _once: تا حد امکان برای لود کلاس‌ها از Autoloader ها (مانند Composer) استفاده کنید، اما برای فایل‌های پیکربندی معمولی، require_once بهترین و امن‌ترین گزینه است.

// استاندارد بهینه برای آدرس‌دهی فایل‌ها در PHP
require_once __DIR__ . '/config/database.php';

پیشنمایش

پرسش و پاسخ

نظری یافت نشد

مطالب مشابه

راهنمای کامل تگ‌های متنی HTML و اصول سئو برای محتوا
1402/05/18 00:40

راهنمای کامل تگ‌های متنی HTML و اصول سئو برای محتوا

مطالعه بیشتر
مقدمه‌ای بر CSS و نحوه اضافه کردن آن به HTML: راهنمای ساده و کامل برای مبتدیان
1402/06/04 23:43

مقدمه‌ای بر CSS و نحوه اضافه کردن آن به HTML: راهنمای ساده و کامل برای مبتدیان

مطالعه بیشتر
آموزش کامل توابع در PHP: از مقدماتی تا پیشرفته با استانداردهای گوگل
1405/04/16 01:02

آموزش کامل توابع در PHP: از مقدماتی تا پیشرفته با استانداردهای گوگل

مطالعه بیشتر
کنترل زمان‌بندی و اندازه‌گیری دقیق انیمیشن‌ها در CSS: آموزش جامع و اصول استاندارد
1402/06/18 22:55

کنترل زمان‌بندی و اندازه‌گیری دقیق انیمیشن‌ها در CSS: آموزش جامع و اصول استاندارد

مطالعه بیشتر
روش‌های کار با Conditional و Loop در Vue.js | آموزش v-if، v-show و v-for
1404/09/28 21:24

روش‌های کار با Conditional و Loop در Vue.js | آموزش v-if، v-show و v-for

مطالعه بیشتر
آموزش توسعه بازی‌های ساده با استفاده از جاوا اسکریپت و Canvas API: راهنمای گام به گام
1403/08/05 21:06

آموزش توسعه بازی‌های ساده با استفاده از جاوا اسکریپت و Canvas API: راهنمای گام به گام

مطالعه بیشتر
آموزش جامع کار با فرم‌ها در PHP (امنیت و اعتبارسنجی طبق استاندارد گوگل)
1405/04/27 22:01

آموزش جامع کار با فرم‌ها در PHP (امنیت و اعتبارسنجی طبق استاندارد گوگل)

مطالعه بیشتر
آموزش جامع و استاندارد کار با رشته‌ ها در PHP
1405/04/27 20:59

آموزش جامع و استاندارد کار با رشته‌ ها در PHP

مطالعه بیشتر
آموزش کامل ارسال درخواست HTTP با cURL در PHP (مطابق استاندارد گوگل)
1405/08/02 15:53

آموزش کامل ارسال درخواست HTTP با cURL در PHP (مطابق استاندارد گوگل)

مطالعه بیشتر
چگونه اسکریپت‌های ساده جاوا اسکریپت را در مرورگر بنویسیم و اجرا کنیم: راهنمای کامل برای مبتدیان
1402/07/02 21:37

چگونه اسکریپت‌های ساده جاوا اسکریپت را در مرورگر بنویسیم و اجرا کنیم: راهنمای کامل برای مبتدیان

مطالعه بیشتر
آموزش اضافه کردن ویدئو و صدا به وب‌سایت: نحوه استفاده از تگ‌های video و audio در HTML
1402/05/23 23:10

آموزش اضافه کردن ویدئو و صدا به وب‌سایت: نحوه استفاده از تگ‌های video و audio در HTML

مطالعه بیشتر
الگوهای رایج برنامه‌نویسی ناهمگام در جاوا اسکریپت: Promise.race، Promise.all، و Promise.any کامل و مثال‌ها
1403/08/01 19:08

الگوهای رایج برنامه‌نویسی ناهمگام در جاوا اسکریپت: Promise.race، Promise.all، و Promise.any کامل و مثال‌ها

مطالعه بیشتر

تمامی حقوق معتلق به ناشر سایت است و کپی از آن پیگرد قانونی دارد