التضمين (or require) بيان يأخذ كل النص / القانون / العلامات الموجودة في الملف ونسخه المحدد في الملف الذي يستخدم تتضمن بيان.
بما في ذلك ملفات مفيد جدا عندما تريد أن تدرج نفس PHP، HTML، أو النص على صفحات متعددة من موقع على شبكة الانترنت.
PHP تتضمن وتتطلب البيانات
ومن الممكن إدراج محتوى ملف PHP واحد في ملف PHP آخر (قبل خادم تنفيذ ذلك)، مع تضمين أو تتطلب بيان.
The include and require statements are identical, except upon failure:
- تتطلب سينتج خطأ فادح (E_COMPILE_ERROR) ووقف النصي
- تشمل سوف تنتج فقط تحذير (E_WARNING) وسيستمر البرنامج النصي
لذا، إذا كنت تريد تنفيذ للذهاب في والمستخدمين عرض الإخراج، حتى لو كانت تشمل ملف مفقود، استخدم تشمل البيان. خلاف ذلك، في حالة الإطار، CMS، أو معقدة الترميز PHP التطبيق، دائما استخدام تتطلب تصريح لتضمين ملف رئيسي لتدفق التنفيذ. وهذا يساعد على تجنب المساس بالأمن التطبيق الخاص بك والنزاهة، فقط في الحالات ملف رئيسي واحد مفقود عن طريق الخطأ.
بما في ذلك ملفات يوفر الكثير من العمل. هذا يعني أنه يمكنك إنشاء رأس أو تذييل الصفحة أو ملف القائمة موحد لجميع صفحات الويب الخاصة بك. ثم، عندما يحتاج رأس إلى تحديث، يمكنك تحديث فقط رأس يتضمن الملف.
بناء الجملة
include ' وتشمل الأمثلة PHP مثال 1
نفترض لدينا ملف تذييل معيار يسمى "footer.php" ، التي تبدو مثل هذا:
<?php
echo "<p>Copyright © 1999-" . date("Y") . "
w3ii.com</p>";
?>
لتضمين الملف تذييل في صفحة، استخدم يشمل البيان:
مثال
<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.html">Home</a> -
<a href="/html/default.html">HTML
Tutorial</a> -
<a href="/css/default.html">CSS Tutorial</a>
-
<a href="/js/default.html">JavaScript
Tutorial</a> -
<a href="default.html">PHP Tutorial</a>';
?> وينبغي لجميع الصفحات في موقع ويب استخدام هذا الملف القائمة. هنا هو كيف يمكن القيام به (we are using a <div> element so that the menu easily can be styled with CSS later) :
مثال
<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>
تشغيل المثال »
PHP تشمل مقابل تتطلب
يتم استخدام تتطلب البيان أيضا إلى تضمين ملف إلى رمز PHP.
ومع ذلك، هناك فرق واحد كبير بين تشمل وبحاجة إليها؛ عندما يتم تضمين ملف مع التضمين بيان وPHP لا يمكن العثور عليه، وسوف يستمر البرنامج النصي لتنفيذ:
مثال
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php include 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
تشغيل المثال » اذا لم نفعل نفس المثال باستخدام تتطلب البيان، لن يتم تنفيذ العبارة صدى لتنفيذ البرنامج النصي يموت بعد تتطلب عاد بيان خطأ فادح:
مثال
<html>
<body>
<h1>Welcome to my home page!</h1>
<?php require 'noFileExists.php';
echo "I have a $color $car.";
?>
</body>
</html>
تشغيل المثال » استخدام تتطلب عند طلب الملف من قبل التطبيق.
استخدام تتضمن عندما لم يكن مطلوبا من الملف ويجب أن تستمر التطبيق عندما لم يتم العثور على الملف.