כיצד לקרוא הגדרה של פונקציה (אב-טיפוס)

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

Note: תנאי מוקדם: הבנה בסיסית של סוגי משתנים אף על פי ש- PHP היא שפה המודפסת באופן חופשי למדי, זה חשוב שיהיה הבנה בסיסית של סוגי משתנים כיוון שיש להם משמעות חשובה.

הגדרות פונקציות מגלים לנו איזה סוג של ערך מוחזר, הבה נשתמש בהגדרה של strlen() כדוגמא ראשונה שלנו:

strlen

(PHP 3, PHP 4 >= 4.0.0)
strlen -- קבלת אורך מחרוזת

תיאור
מספר שלם strlen ( מחרוזת str )

מחזיקה את האורך של מחרוזת.
    

אנחנו יכולים לשכתב את הגדרת הפונקציה הנ"ל בדרך כללית יותר:

      סוג משתנה מוחזר    שם הפונקציה    ( סוג הפרמטר   שם הפרמטר )
     

פונקציות רבות משתמשות בפרמטרים מרובים, כמו in_array(). הדגם הראשוני שלה כדלקמן:

    
      bool in_array ( מעורב מחט, מערך ערימת_שחת [, בוליאני strict])
     

מה זה אומר? in_array() מחזירה ערך בוליאני , TRUE במקרה של הצלחה (הפרמטר מחט נמצא בתוך ערימת_שחת ) או FALSE במקרה של כישלון (הפרמטר מחט לא נמצא בתוך ערימת_שחת ). הפרמטר הראשון מכונה בשם מחט והוא יכול להיות הרבה סוגי משתנים, אז לכן אנחנו מכנים אותו "מעורב". מחט המעורב הזה (מה שאנחנו מחפשים אחריו) יכול להיות ערך בודד (מחרוזת, מספר שלם, או שבר), או מערך. ערימת_שחת (המערך שבו אנחנו מחפשים בו) הוא הפרמטר השני. הפרמטר השלישי האופציונלי הוא מכונה בשם strict . כל הפרמטרים האופציונלים נכתבים ב- [ סוגריים ]. המדריך קובע כי ברירת המחדל של הפרמטר הבוליאני strict הוא FALSE. ראה את עמוד המדריך לכל פונקציה לפרטים כיצד איך הן עובדות.