تابع include در PHP چیست؟ – به زبان ساده با مثال و کد

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

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

کاربرد تابع include در PHP چیست؟

علاوه بر این، استفاده از تابع include در PHP ویرایش و انجام تغییرات در کد را نیز آسان‌تر می‌کند، زیرا در صورت نیاز به انجام تغییرات در کد به جای ویرایش تمامی فایل‌ها تنها کافی است تا فایل منبع را ویرایش کنیم.

سینتکس تابع include در PHP

به منظور فراخوانی یک فایل PHP در فایلی دیگر کافی است تا مسیر مربوط به فایل را بعد از کلمه کلیدیinclude قرار دهید. قطعه کد زیر نحوه فراخوانی فایلfunctions.php را درون فایلindex.php با استفاده از دستور include نشان می‌دهد.

در صورتی که PHP نتواند فایلfunctions.php مشخص شده را در دایرکتوری اصلی پروژه پیدا کند، هشداری به صورت زیر در خروجی چاپ خواهد کرد.

Warning: include(functions.php): failed to open stream: No such file or directory in ... on line 4
Warning: include(): Failed opening 'functions.php' for inclusion (include_path='\xampp\php\PEAR') in ... on line 4

در صورت وجود فایلfunctions.php در مسیر اصلی پروژه با فراخوانی این فایل کدهای موجود در آن اجرا خواهند شد. به عنوان مثال، کدهای زیر درون فایلfunctions.php قرار داده شده است.

با فراخوانی فایلfunctions.php درون فایلindex.php خروجی حاصل بعد از اجرای کدindex.php به صورت زیر خواهد بود.

Copyright © 2021 by phptutorial.net. All Rights Reserved!

خروجی حاصل از اجرای قطعه کد بالا این مسئله را نشان می‌دهد که با به‌کارگیری دستور include کدهای موجود در فایلfunctions.php اجرا خواهند شد.

آموزش های برنامه نویسی و طراحی سایت فرادرس

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

• فیلم آموزش برنامه نویسی PHP فرادرس
• فیلم آموزش جاوا اسکریپت فرادرس
• فیلم آموزش چارچوب توسعه تحت وب ASP.NET MVC فرادرس
• فیلم آموزش پروژه محور MySQL و PHP فرادرس

مثالی ساده از فراخوانی فایل با استفاده از include در PHP

در ادامه فایل اصلی تحت عنوانMain.php قرار داده شده است که کدهای موجود در آن به صورت زیر است.

در قطعه کد بالا فایلPage1.php با دستور include در فایل اصلی فراخوانی شده است که در نتیجه تمام محتویات موجود در آن در فایل اصلی قرار خواهد گرفت. خروجی حاصل بعد از اجرای کدMain.php به صورت زیر خواهد بود.

کاربرد دستور include در طراحی سایت

مثالی از کاربرد عملی دستور include

در این بخش به منظور درک بهتر کاربرد دستور include در طراحی سایت نحوه استفاده از این دستور برای تفکیک مولفه‌های رابط کاربری سایت در قالب مثال عملی توضیح داده شده است. برای این منظور در گام نخست پوشه جداگانه‌ای با نامinc در دایرکتوری اصلی پروژه ایجاد می‌کنیم. در گام بعدی با توجه به دو مولفه مورد نیاز یعنی هدر و فوتر سایت دو فایل با نام‌هایfooter.php وheader.php در این پوشه ایجاد می‌کنیم. ساختار کلی پروژه به صورت زیر خواهد بود.

در ادامه به منظور ساخت هدر کدهای زیر را درون فایلheader.php قرار می‌دهیم.

همچنین، برای ساخت فوتر نیز کدهای زیر را درون فایلfooter.php قرار می‌دهیم.

در نهایت به منظور فراخوانی هدر و فوتر طراحی شده در صفحه اصلی باید از تابع include در PHP به صورت زیر استفاده کنیم.

با اجرای فایلindex.php کد اصلی پروژه به صورت زیر خواهد بود.

مزایای تابع include در PHP چیست؟

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

• قابلیت استفاده مجدد کد: با استفاده از include می‌توان از کدها و توابع پیاده‌سازی شده در سایر اسکریپت‌های PHP مجدداً استفاده کرد.
• بهبود خوانایی کد: با کاهش حجم کدهای مورد استفاده در برنامه خوانایی کد نیز بهبود پیدا می‌کند.
• ویرایش آسان: در صورت نیاز به انجام تغییرات در برنامه به جای ویرایش هر فایل به صورت جداگانه تنها کافی است تا فایل اصلی پروژه ویرایش شود.
• تفکیک مولفه‌های رابط کاربری: با استفاده از تابع include می‌توان مولفه‌های رابط کاربری مشترک در برنامه را به صورت جداگانه پیاده‌سازی کرد.

تابع include در PHP و محدوده دسترسی به متغیرها

فیلم آموزش برنامه‌نویسی PHP در فرادرس

کلیک کنید

وضعیت متغیرها بعد از فراخوانی فایل در PHP را در دو حالت مختلف مورد بررسی قرار خواهیم داد.

فراخوانی فایل خارج از بدنه تابع

در قطعه کد زیر متغیرهای$title و$content درون فایلfunctions.php تعریف شده‌اند.

با فراخوانی فایلfunctions.php درون فایلindex.php متغیرهای$title و$content به عنوان متغیر سراسری در این فایل در نظر گرفته می‌شوند. قطعه کد زیر فراخوانی فایلfunctions.php خارج از بدنه تابع را در فایلindex.php نشان می‌دهد.

بعد از فراخوانی فایلfunctions.php امکان دسترسی به متغیرهای$title و$content وجود خواهد داشت.

فراخوانی فایل درون بدنه تابع

در مثال بالا فایلfunctions.php درون بدنه تابعrender_article() فراخوانی شده است. بنابراین، متغیرهای$title و$content به عنوان متغیرهای محلی این تابع شناخته می‌شوند.

تابع require در PHP چیست؟

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

دستور require در PHP تمام محتویات موجود در فایل داده شده را در فایل اصلی کپی می‌کند. در واقع، دستور require و include در PHP فارغ از نحوه برخورد با شرایط خطا کاملاً یکسان هستند.

سینتکس تابع require در PHP

سینتکس پیاده‌سازی تابع require بسیار ساده است. قطعه کد زیر سینتکس دستور require در PHP را نشان می‌دهد.

برای فراخوانی یک فایل با استفاده از دستور require کافی است تا بعد از کلمه کلیدی require مسیر فایل مورد نظر آورده شود. در ادامه نحوه پیاده‌سازی منو در Html با استفاده از دستور require توضیح داده شده است. قطعه کد زیر فایلMenu1.html را نشان می‌دهد.

در ادامه در فایلMain.html با استفاده از دستور require این فایل فراخوانی شده است. قطعه کد زیر فایلMain.html را نشان می‌دهد.

خروجی حاصل از اجرای قطعه کد بالا به صورت زیر خواهد بود.

require و include در PHP چه تفاوتی با یکدیگر دارند؟

دستورات require و include شباهت بسیاری به یکدیگر دارند و هر دو به منظور فراخوانی فایل در PHP مورد استفاده قرار می‌گیرند. تنها تفاوت این دو دستور در نحوه مدیریت خطا توسط آن‌ها است.

• دستور require در صورت عدم وجود فایل مورد نظر یا بروز خطا با ایجاد یک «خطای مرگبار» (Fatal Error) اجرای ادامه دستورات را متوقف می‌کند.
• دستور include در صورت عدم وجود فایل مورد نظر یا بروز خطا تنها یک هشدار در خروجی چاپ کرده و اجرای دستورات را متوقف نمی‌کند.

یادگیری PHP با آموزش های رایگان فرادرس

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

اگر قصد یادگیری PHP به صورت رایگان را دارید می‌توانید فیلم‌های آموزشی رایگان PHP فرادرس را مشاهده کنید که لینک آن در ادامه آورده شده است.

• مجموعه فیلم‌های آموزش رایگان PHP فرادرس

برخی از فیلم‌های آموزشی پیشنهادی موجود در این مجموعه به شرح زیر هستند.

• فیلم آموزش رایگان آشنایی با PHP فرادرس
• فیلم آموزش رایگان متغیرها، انواع داده ها و ثوابت در PHP فرادرس
• فیلم آموزش رایگان آرایه‌ها در PHP فرادرس
• فیلم آموزش رایگان پیاده‌سازی یک پروژه وب کامل و ساده با PHP فرادرس

جمع‌بندی

فیلم مجموعه آموزش‌ برنامه نویسی پی اچ پی PHP – مقدماتی تا پیشرفته در فرادرس

کلیک کنید

در این مطلب ابتدا به بررسی سینتکس استفاده از تابع include پرداخته شد. در ادامه نیز کاربردها، مزایا و نکات مهم در استفاده از این تابع مورد بررسی قرار گرفت. در انتها نیز به بررسی تفاوت‌های تابع require و include پرداخته شد.