القائمة الرئيسية

الصفحات

 PHP - File Inclusion



يمكنك تضمين محتوى ملف PHP في ملف PHP آخر قبل أن ينفذه الخادم. هناك نوعان من وظائف PHP التي يمكن استخدامها لتضمين ملف PHP واحد في ملف PHP آخر.

  • The include() Function
  • The require() Function
هذه نقطة قوية في PHP تساعد في إنشاء وظائف أو رؤوس أو تذييلات أو عناصر يمكن إعادة استخدامها في صفحات متعددة. سيساعد هذا المطورين على تسهيل تغيير تخطيط موقع الويب الكامل بأقل جهد. إذا كان هناك أي تغيير مطلوب ، فبدلاً من تغيير آلاف الملفات ، قم فقط بتغيير الملف المضمن.

You can include the content of a PHP file into another PHP file before the server executes it. There are two PHP functions which can be used to included one PHP file into another PHP file.

  • The include() Function
  • The require() Function

This is a strong point of PHP which helps in creating functions, headers, footers, or elements that can be reused on multiple pages. This will help developers to make it easy to change the layout of complete website with minimal effort. If there is any change required then instead of changing thousand of files just change included file.

The include() Function

The include() function takes all the text in a specified file and copies it into the file that uses the include function. If there is any problem in loading a file then the include() function generates a warning but the script will continue execution.

Assume you want to create a common menu for your website. Then create a file menu.php with the following content.


تأخذ وظيفة include () كل النص في ملف محدد وتنسخه في الملف الذي يستخدم وظيفة التضمين. إذا كانت هناك أي مشكلة في تحميل ملف ، فإن الوظيفة include () تولد تحذيرًا ولكن البرنامج النصي سيستمر في التنفيذ. افترض أنك تريد إنشاء قائمة مشتركة لموقع الويب الخاص بك. ثم قم بإنشاء ملف menu.php بالمحتوى التالي.

<a href="http://www.tutorialspoint.com/index.htm">Home</a> - 
<a href="http://www.tutorialspoint.com/ebxml">ebXML</a> - 
<a href="http://www.tutorialspoint.com/ajax">AJAX</a> - 
<a href="http://www.tutorialspoint.com/perl">PERL</a> <br />

Now create as many pages as you like and include this file to create header. For example now your test.php file can have following content.


الآن قم بإنشاء أي عدد تريده من الصفحات وقم بتضمين هذا الملف لإنشاء رأس الصفحة. على سبيل المثال ، يمكن الآن أن يحتوي ملف test.php على المحتوى التالي.


<html>
   <body>
   
      <?php include("menu.php"); ?>
      <p>This is an example to show how to include PHP file!</p>
      
   </body>
</html>

It will produce the following result −النتيجة هذه

Include

The require() Function

The require() function takes all the text in a specified file and copies it into the file that uses the include function. If there is any problem in loading a file then the require() function generates a fatal error and halt the execution of the script.

So there is no difference in require() and include() except they handle error conditions. It is recommended to use the require() function instead of include(), because scripts should not continue executing if files are missing or misnamed.

You can try using above example with require() function and it will generate same result. But if you will try following two examples where file does not exist then you will get different results.

تأخذ الدالة تتطلب () كل النص الموجود في ملف محدد وتقوم بنسخه في الملف الذي يستخدم وظيفة التضمين. إذا كانت هناك أي مشكلة في تحميل ملف ، فإن الوظيفة تتطلب () تولد خطأ فادحًا وتوقف تنفيذ البرنامج النصي. لذلك لا يوجد فرق في تتطلب () وتضمين () فيما عدا أنها تتعامل مع حالات الخطأ. من المستحسن استخدام وظيفة تتطلب () بدلاً من تضمين () ، لأنه يجب ألا تستمر البرامج النصية في التنفيذ إذا كانت الملفات مفقودة أو تم تسميتها بشكل خاطئ. يمكنك محاولة استخدام المثال أعلاه مع وظيفة تتطلب () وسوف تولد نفس النتيجة. ولكن إذا حاولت اتباع مثالين حيث لا يوجد الملف ، فستحصل على نتائج مختلفة.



<html>
   <body>
   
      <?php include("xxmenu.php"); ?>
      <p>This is an example to show how to include wrong PHP file!</p>
      
   </body>
</html>

This will produce the following result −

This is an example to show how to include wrong PHP file!

Now lets try same example with require() function.

<html>
   <body>
       
       <?php require("xxmenu.php"); ?>
       <p>This is an example to show how to include wrong PHP file!</p>
   
   </body>
</html>

This time file execution halts and nothing is displayed.

NOTE − You may get plain warning messages or fatal error messages or nothing at all. This depends on your PHP Server configuration.

ملاحظة - قد تحصل على رسائل تحذير بسيطة أو رسائل خطأ فادح أو لا شيء على الإطلاق. هذا يعتمد على تكوين خادم PHP الخاص بك.

أقرا المزيد

هل اعجبك الموضوع :

تعليقات