پی ایچ پی شامل فائل

شامل سرور (SSI) برای ایجاد توابع، سربرگ‌ها، پاورقی‌ها یا عناصر قابل استفاده در چندین صفحه استفاده می‌شود.

کلمات دستوری include (یا require) تمام متن/کد/نشان‌های موجود در فایل مشخص شده را دریافت می‌کنند و آن‌ها را به فایل‌هایی که از کلمه دستوری include استفاده کرده‌اند، کپی می‌کنند.

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

کلمات دستوری PHP include و require

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

include اور require کلمات دستوری مشابه هستند، اما در مورد مدیریت خطا تفاوت دارند:

  • require مرتکب خطری غلطی (E_COMPILE_ERROR) پیدا کرتا ہے اور اسکریپٹ متوقف ہوتا ہے
  • include صرف وارننگ (E_WARNING) پیدا کرتا ہے اور اسکریپٹ جاری رہتا ہے

لہذا، اگر آپ چاہتے ہیں کہ آپ آگے چل جائیں اور استعمال کنندگان کو نتیجے کی پیشکش کریں، تو اگر شامل فائل گم ہوگئی ہوئی ہو، تو include استعمال کریں۔ درغیر این، فریم ورک، CMS یا پیچیدہ PHP ایپلی کیشن پروگرامنگ میں، ہمیشہ require استعمال کریں تاکہ کلیدی فائل کو اجراء کریں اور اس کی سیکورٹی اور پورٹی کو بہتر بنائیں، اگر کسی کلیدی فائل کا نقصان آئیے تو.

فائل شامل کرنا بہت کم کاموں کو ختم کرتا ہے۔ یعنی آپ تمام پیجز کے لئے معیاری سرسرا، پیج فٹر یا منو فائل بناسکتے ہیں۔ تو، اگر سرسرا میں اپدیت کئے جانے والے وقت آئے تو، صرف اس سرسرا شامل فائل کو اپدیت کریں جو کہیں.

زبان

include 'filename';

یا

require 'filename';

PHP include مثال

مثال 1

جس میں ایک نا 'footer.php' معیاری پیج فٹر فائل موجود ہے، جیسا کہ اس طرح:

<?php
echo "<p>کاپی رائٹ © 2006-" . date("Y") . " codew3c.com</p>";
?>

اگر آپ اس پیج فٹر فائل کو اس پیج میں استعمال کرنا چاہتے ہیں تو، include جملہ استعمال کریں:

<html>
<body>
<h1>آپ کا خیر مقدم ہماری منزل پیج پر!</h1>
<p>کچھ متن.</p>
<p>کچھ متن.</p>
<?php include 'footer.php';?>
</body>
</html>

مثال اجرایی

مثال 2

جس میں ایک نا 'menu.php' معیاری منو فائل موجود ہے:

<?php
echo '<a href="/index.asp">منزل پہلا</a> -
<a href="/html/index.asp">HTML تعلیم</a> -
<a href="/css/index.asp">CSS تعلیم</a> -
<a href="/js/index.asp">JavaScript تعلیم</a> -
<a href="/php/index.asp">PHP تعلیم</a>';
?>

سائٹ میں تمام پیجز اس منو فائل کا استعمال کرتے ہیں۔مخصوص طور پر (ہم نے ایک <div> علامت استعمال کی، تاکہ مستقبل میں آسانی سے سی ایس ایس کا استعمال کیا جاسکے):

<html>
<body>
<div class="menu">
<?php include 'menu.php';?>
</div>
<h1>به خانه من خوش آمدید!</h1>
<p>کچھ متن.</p>
<p>کچھ مزید متن.</p>
</body>
</html>

مثال اجرایی

مثال 3

جسمانی طور کریں جس میں ایک فائل نا 'vars.php' موجود ہے، جس میں کچھ متغیرات کا تعریف کیا گیا ہے:

<?php
$color='نقره‌ای';
$car='بمبئی سدان';
?>

پس، اگر ما این فایل "vars.php" را اشاره کنیم، می‌توانیم از این متغیرها در فایل فراخوانی استفاده کنیم:

<html>
<body>
<h1>به خانه من خوش آمدید!</h1>
<?php
include 'vars.php';
echo "من یک" . $color . $car .
?>
</body>
</html>

مثال اجرایی

PHP include در مقابل require

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

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

مثال

<html>
<body>
<h1>به خانه من خوش آمدید!</h1>
<?php
include 'noFileExists.php';
echo "من یک $color $car دارم.";
?>
</body>
</html>

مثال اجرایی

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

مثال

<html>
<body>
<h1>به خانه من خوش آمدید!</h1>
<?php
require 'noFileExists.php';
echo "من یک $color $car دارم.";
?>
</body>
</html>

مثال اجرایی

نکته:

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

لطفاً در این زمان از include استفاده کنید: وقتی فایل ضروری نیست و برنامه باید در صورت عدم یافت فایل ادامه دهد.