כדי לחבר קובץ נוסף לסקריפט PHP, השתמש בפונקציה המיוחדת include. לאחר חיבור מסמך חיצוני, למתכנת יש אפשרות להשתמש בקוד הכתוב או בתוכן אחר ביישום הנוכחי.
כלול פונקציה
הכלל כולל את התחביר הבא:
כוללים "שם קובץ";
השם הוא נתיב יחסי או מוחלט עם סיומת המסמך הכלול. אם לא צוין שום מיקום, PHP יבדוק אוטומטית את תוכן התצורה php.ini, המציין include_path - ספריה בה ניתן למקם ספריות נוספות. אם ההנחיה ריקה או שהקובץ הנדרש לא נמצא בנתיב שצוין בה, לא יתעלם מביטוי הכלול.
לאחר הפעלתו, תוכלו להשתמש בתוכן הרצוי בסקריפט, להקצות משתנים, להשתמש במבנים מוצהרים וכו '. לדוגמא, ישנם 2 קבצים 1.php ו- 2.php. התוכן של 1.php נראה כך:
<? php
$ first = "משתנה מהקובץ הראשון";
$ שנית = "ערך מיובא";
?>
כדי לכלול את המשתנים לעיל ב- 2.php, תוכל לבצע את הפעולה הבאה:
<? php
כלול "1.php";
מהדהד $ ראשית;
$ emerge = "$ שנייה";
הד $ מופיע; ?>
בסקריפט זה של הקובץ השני, הפקודה include כוללת את תוכן המסמך הראשון, ולאחריו משתמשים במשתנים המוצהרים ב- 1.php להצגת הערכים הדרושים על המסך.
ניתן להשתמש ב- Include גם בתחילת הקובץ וגם בתוך הפונקציה המוצהרת בכל חלק של המסמך. לא רצוי להשתמש בפונקציה כדי לחבר קבצים הממוקמים בשרת מרוחק. אם ברצונך ליישם תכונה זו, תצטרך להפעיל את אפשרות allow_url_fopen בקובץ php.ini בשרת המקומי או המרוחק שלך.
לִדרוֹשׁ
פונקציית הדרישה דומה לכלול. הפקודות אינן שונות בתחביר ובטכנולוגיית הביצוע. ההבדל היחיד הוא שאם הקובץ שצוין חסר, הדרישה מסיימת את הסקריפט, בעוד שכלול ימשיך לבצע את הסקריפט ויציג את אזהרת E_WARNING המתאימה, שניתן לדכא באמצעות התו המיוחד @. לדוגמה:
<? php
דורשים "1q.php";
הד "סקריפט מפסיק לעבוד"; ?>
בדוגמה זו צוין הנתיב למסמך 1q.php שאינו קיים. אם הקובץ חסר, הסקריפט לא יבצע את פקודת ההד, ומסך המשתמש יציג גיליון ריק או הודעת שגיאה (תלוי בהגדרות php.ini). אם תזין קוד דומה באמצעות כלול:
<? php
כוללים "1q.php";
הד "התסריט ממשיך"; ?>
פקודת ההד תבוצע והטקסט המתאים יופיע בתצוגה.
