require()

פקודת require( ) מספחת ומריצה או מעריכה קובץ מסויים .

פקודת require( ) מספחת ומריצה או מעריכה קובץ מסויים . הסבר מפורט לגבי אופן פעולת הסיפוח ניתן למצוא בתיעוד הפונקציה include( ) .

הפקודות require( ) ו - include( ) זהות בכל מובן חוץ מאשר האופן בו הן מטפלות בשגיאות או בחוסר הצלחה בסיפוח הקובץ . פקודת include( ) מייצרת אזהרה בעוד שפקודת require( ) מייצרת Fatal Error - שגיאה שתגרום לעצירת הריצה של הסקריפט . אם ברצונך למנוע את ריצת הסקריפט במקרה שקובץ לא נמצא , יש להשתמש ב - require( ) . פקודת include( ) אינה מתנהגת באופן כזה.כמו כן , מומלץ לקבוע את ערכו של include_path .

דוגמה 11-2 . דוגמה בסיסית של require( )






יש לעיין בתיעוד הפקודה include( ) לדוגמאות נוספות .

הערה : בגרסת PHP 4.0.2 ומטה , פקודת require( ) תנסה לקרוא את קובץ המטרה שלה גם אם היא לא מגיעה לעולם לידי ריצה בסקריפט . משפט התנייה לא ישפיע על require( ) אך אם השורה בה מופיעה פקודת require( ) לא תורץ , גם הקוד שמכיל ה - require( ) לא יורץ . גם require( ) שמורץ מספר פעמים מתוך לולאה יתנהג בצורה זהה . אולם הקוד עצמו יורץ מספר פעמים בלולאה אך פעולת הסיפוח תתרחש פעם אחת בלבד .

למידע נוסף,יש לעיין גם בתיעוד של include( ) , require_once( ) , include_once( ) , eval( ) , file( ) , readfile( ) , virtual( ) u - include_path .