require()
פקודת require() מספחת ומריצה או מעריכה קובץ מסויים.
פקודת require() מספחת ומריצה או מעריכה קובץ מסויים. הסבר מפורט לגבי אופן פעולת הסיפוח ניתן למצוא בתיעוד הפונקציה include().
הפקודות require() ו-include() זהות בכל מובן חוץ מאשר האופן בו הן מטפלות בשגיאות או בחוסר הצלחה בסיפוח הקובץ. פקודת include() מייצרת אזהרה בעוד שפקודת require() מייצרת Fatal Error - שגיאה שתגרום לעצירת הריצה של הסקריפט. אם ברצונך למנוע את ריצת הסקריפט במקרה שקובץ לא נמצא, יש להשתמש ב-require(). פקודת include() אינה מתנהגת באופן כזה.כמו כן, מומלץ לקבוע את ערכו של include_path.
Example#1 דוגמה בסיסית של require()
<?php
require 'prepend.php';
require $somefile;
require ('somefile.txt');
?>
יש לעיין בתיעוד הפקודה include() לדוגמאות נוספות.
Note: בגרסת PHP 4.0.2 ומטה, פקודת require() תנסה לקרוא את קובץ המטרה שלה גם אם היא לא מגיעה לעולם לידי ריצה בסקריפט. משפט התנייה לא ישפיע על require() אך אם השורה בה מופיעה פקודת require() לא תורץ, גם הקוד שמכיל ה-require() לא יורץ. גם require() שמורץ מספר פעמים מתוך לולאה יתנהג בצורה זהה. אולם הקוד עצמו יורץ מספר פעמים בלולאה אך פעולת הסיפוח תתרחש פעם אחת בלבד.
למידע נוסף,יש לעיין גם בתיעוד של include(), require_once(), include_once(), eval(), file(), readfile(), virtual() u- include_path.