ملفات PHP Include

استخدام SSI (Server-Side Include) لإنشاء وظائف أو رؤوس أو أقدام أو عناصر يمكن تكرار استخدامها في عدة صفحات.

تعبر جملة include (أو require) عن الحصول على جميع النصوص/الكود/العلامات الموجودة في الملف المحدد، ثم نسخها إلى الملف الذي يستخدم جملة include.

مهمة تحديد الملفات لتضمينها مفيدة، إذا كنت بحاجة إلى تضمين نفس PHP أو HTML أو نص في عدة صفحات على الموقع.

جملات include و require في PHP

من خلال استخدام جملات include أو require، يمكنك إدراج محتويات ملف PHP في ملف PHP آخر (قبل تنفيذه على الخادم).

تعبر جملات include و require مشابه هستند، باستثناء معالجة الأخطاء:

  • require يولد خطأ حاسم (E_COMPILE_ERROR) ويوقف السكربت
  • include يولد تحذيرًا فقط (E_WARNING)، ويستمر السكربت

لذلك، إذا كنت ترغب في استمرار التنفيذ وإخراج النتائج للمستخدم، حتى لو تم فقد ملف المضمين، فاستخدم include. وإلا، في إطار العمل أو CMS أو برمجة تطبيقات PHP معقدة، استخدم دائمًا require لتضمين ملفات مهمة في مسار التنفيذ. هذا يساعد في زيادة أمان وإكمال التطبيق، حتى في حالة فقد ملف مهم.

يُبسط include الكثير من العمل. هذا يعني أنك يمكنك إنشاء صفحة رأس أو قدم أو قائمة معيارية لجميع الصفحات. ثم، عند الحاجة إلى تحديث الصفحة الرأس، يمكنك فقط تحديث ملف الصفحة الرأس المضممن.

النحو

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>)، حيث يمكننا بسهولة تعيين النمط باستخدام CSS في المستقبل):

<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 vs. require

require 语句同样用于向 PHP 代码中引用文件。

不过，include 与 require 有一个巨大的差异：如果用 include 语句引用某个文件并且 PHP 无法找到它，脚本会继续执行：

实例

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

运行实例

如果我们使用 require 语句完成相同的案例，echo 语句不会继续执行，因为在 require 语句返回严重错误之后脚本就会终止执行：

实例

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

运行实例

注释：

请在此时使用 require：当文件被应用程序请求时。

请在此时使用 include：当文件不是必需的，且应用程序在文件未找到时应该继续运行时。