+- الدعم العربي (https://www.mybbarab.com)
+-- قسم : :: . + تطوير المواقع و المنتديات و لغات برمجة المواقع + . :: (https://www.mybbarab.com/forum-78.html)
+--- قسم : قسم تطوير المنتديات والمواقع ولغات البرمجه (https://www.mybbarab.com/forum-117.html)
+---- قسم : نقاش عام حول PHP و MYSQL (https://www.mybbarab.com/forum-49.html)
+---- الموضوع : تضمين الملفات باستخدام include و require (/thread-469.html)
تضمين الملفات باستخدام include و require - Pepo - 2007-03-21
السلام عليكم ورحمة الله وبركاته
من أسهل الدوال التي نتعامل معها بكثرة في برمجياتنا، هي دوال تضمين الملفات، وتستخدم هذه الدوال عند الرغبة في تنفيذ الكود الموجود داخل ملف PHP من ملف آخر.
وكأمثلة على استخدامات هذه الدوال: (الأمثلة على سبيل المثال لا الحصر)
- تضمين ملف عام - يحتوي على مجموعة من الاجراءات العامة اللازمة لكل ملفات السكريبت - في جميع صفحات السكريبت حتى يتم تنفيذه دائماً.
- تضمين ملف يحتوي على بيانات قاعدة البيانات في جميع صفحات السكريبت حتى يسهل عملية الاتصال بقاعدة البيانات.
- تضمين ملف يحتوي على الاعدادات العامة للسكريبت والتي يتم التحقق منها في اماكن كثيرة بالسكريبت.
- تضمين ملف يحتوي على قائمة عامة يجب ان تتواجد بكل الصفحات، وعند الرغبة في تحديث هذه القائمة يتم تحديثها فقط في ملف واحد فتنعكس التحديثات على جميع صفحات السكريبت.
- include()
- include_once()
- require()
- require_once()
أولاً: الدالة include():
تقوم الدالة include بكل بساطة بنسخ الكود الموجود داخل الملف المراد تضمينه والذي يتم تمريره للدالة، ووضعه داخل الملف الأصلي وتنفيذه.
وتستخدم بالطريقة التالي:
PHP كود :
<?
include("filename.ext");
?>filename هو إسم الملف المراد تضمينه، ext هو امتداد الملف.
وتقبل الدالة include اي نوع ملف فلا يشترط ان يكون الملف من النوع php.
مثال1:
بفرض أننا أردنا انشاء ملف يحتوي على قائمة رئيسية يتم استخدامها بكل صفحات السكريبت، وليكن اسمه menu.php، ويحتوي على الكود التالي:
PHP كود :
<html>
<body>
<a href="index.php">الرئيسية</a> -
<a href="about.php">حول الموقع</a> -
<a href="links.php">روابط</a> -
<a href="contact.php">اتصل بنا</a> <br />
PHP كود :
<?php include("menu.php"); ?>
<p>مرحباً في الصفحة الرئيسية</p>
</body>
</html>
سيروا القائمة الرئيسية وتحتها كلمة مرحباً..
وعند محاولة استعراض مصدر الصفحة يظهر الكود التالي:
PHP كود :
<html>
<body>
<a href="index.php">الرئيسية</a> -
<a href="about.php">حول الموقع</a> -
<a href="links.php">روابط</a> -
<a href="contact.php">اتصل بنا</a> <br />
<p>مرحباً</p>
</body>
</html>
ثانياً: الدالة reauire():
الدالة require تعمل نفس عمل الدالة include المشروحة بأعلى، مع فرق واحد قد لا يعلمه الكثيرون، وهو عند استخدام الدالة include في تضمين ملف غير موجود او اسمه خاطيء يظهر فقط تحذير بأن الملف غير موجود ويستمر السكريبت في العمل بشكل طبيعي.
اما مع require فالوضع مختلف، فعند عدم وجود الملف المطلوب تظهر رسالة خطأ ويتوقف السكريبت عن العمل.
ولتوضيح الفرق بينهما لاحظ المثالين التاليين..
مثال2:
PHP كود :
<?php
include("WrongFileName.php");
echo "مرحباً";
?>كود :
[B]Warning[/B]: main(WrongFileName.php): failed to open stream: No such file or directory in [B]/home/xxxx/index.php[/B] on line [B]2[/B] [COLOR=red]Warning[/COLOR]: main(): Failed opening 'WrongFileName.php' for inclusion (include_path='.:/usr/lib/php:/usr/local/lib/php') in [B]/home/xxxx/index.php[/B] on line 2
مرحباًمثال3:
PHP كود :
<?php
require("WrongFileName.php");
echo "مرحباً";
?>كود :
[B]Warning[/B]: main(WrongFileName.php): failed to open stream: No such file or directory in [B]/home/xxxx/index.php[/B] on line [B]2[/B]
[COLOR=red]Fatal error[/COLOR]: main(): Failed opening required 'WrongFileName.php' (include_path='.:/usr/lib/php:/usr/local/lib/php') in [B]/home/xxxx/index.php[/B] on line 2مما يعني ان require تتطلب التأكد من وجود الملف وصحة اسمه حتى لا يتوقف السكريبت عن العمل، بعكس include التي يكمل السكريت العمل بعدها حتى لو لم يكن الملف موجوداً...
للأمانة منقول من منتدى بى اتش بى