وباکا

آموزش تخصصی برنامه نویسی وب

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

زمانی که می خواهید PHP، HTML، یا متن یکسانی در چندین صفحه وب استفاده کنید. ضمیمه کردن فایل ها بسیار مفید است.

دستورات include و require در پی اچ پی

شما می توانید، با دستور include یا require کل محتوای یک فایل پی اچ پی را در فایل پی اچ پی دیگری (قبل از اینکه سرور آن را اجرا می کند) قرار دهید.

عملکرد دستورات include و require مشابه  هم هستند مگر در صورت خطا:

  • دستور require به یک خطای مهلک (E_COMPILE_ERROR) ایجاد می کند و اسکریپت را متوقف می کند.

  • دستور include فقط هشدار (E_WARNING) را تولید می کند و اسکریپت ادامه خواهد یافت.

بنابراین پیشنهاد می شود:

اگر می خواهید هنگام اجرا، خروجی هایی را برای کاربران نشان دهید، حتی اگر فایل ضمیمه نشده باشد، از عبارت include استفاده کنید. در غیر این صورت، در مورد FrameWork، CMS یا برنامه کاربردی پیچیده PHP، همیشه از دستور require برای ضمیمه کردن فایل های کلیدی استفاده کنید. این کار به امنیت و یکپارچگی برنامه شما کمک می کند.

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

include 'filename';
or
require 'filename';

مثال ضمیمه کردن فایل ها

مثال 1
فرض کنید یک فایل پایه استاندارد با نام footer.php به صورت زیر داریم:

<?php
echo "<p>Copyright &copy; 1999-" . date("Y") . " W3Schools.com</p>";
?>

برای قرار دادن فایل footer در یک صفحه، از دستور include زیر استفاده کنید:

<html>
<body>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
<?php include 'footer.php';?>
</body>
</html>

مثال 2

فرض کنید ما یک فایل منو استاندارد به نام “menu.php” داریم:

<?php
echo '<a href="/default.asp">Home</a> -
<a href="/html/default.asp">HTML Tutorial</a> -
<a href="/css/default.asp">CSS Tutorial</a> -
<a href="/js/default.asp">JavaScript Tutorial</a> -
<a href="default.asp">PHP Tutorial</a>';
?>

تمام صفحات وب سایت باید از این فایل منو استفاده کنند. در اینجا هدف ما اینه که روش استفاده از آنرا نشان دهیم  (از عنصر <div> استفاده می کنیم تا بعداً با استایل شیت ها قالب دهی کنیم):

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>Welcome to my home page!</h1>
<p>Some text.</p>
<p>Some more text.</p>
</body>
</html>

مثال 3

فرض کنید یک فایل با نام vars.php داریم، که در آن چند متغیر تعریف شده:

<?php
$color='red';
$car='BMW';
?>

سپس، اگر فایل vars.php را ضمیمه کنیم، متغیرها را می توان در فایل های دیگر مورد استفاده قرار داد:

<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'vars.php';
echo "I have a $color $car.";
?>
</body>
</html>
 

مقایسه دستورات include و require

دستور require مشابه دستور include برای ضمیمه کردن فایل ها در کد PHP استفاده می شود.

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

پس توصیه می شود اگر فایلی که ضمیمه می کنید، ضروری است و باید حتماً باشد، از دستور require استفاده کنید و اگر فایل ضروری نیست از دستور include کمک بگیرید.

همچنین هر کدام دستورات inlude و require می توانند با پسوند once استفاده شوند بصورت زیر:

include_once
require_once

این دستورات می توانند به جای دستورات قبلی زمانی استفاده شوند ، که برنامه نویسی ممکن است یک فایل را در جاهای محتلف ضمیمه کند ، و در صورت وقوع این اشتباه مایل هستیم تنها در اولین مرتبه ، فایل ضمیمه شده و در دفعات بعدی از ضمیمه کردن فایل صرف نظر کند.

مطالب مرتبط

دیدگاهتان را بنویسید

نشانی ایمیل شما منتشر نخواهد شد. بخش‌های موردنیاز علامت‌گذاری شده‌اند *

فهرست مطالب