Server Side Includes

Server Side Includes (הכללות צד-שרת, SSI) היא שפה שמפורשת על שרת כדי להפוך דפי HTML סטטיים לדינמיים יותר. היא לא מיועדת להחליף שפות צד-שרת מלאות כמו ASP או PHP, אלא לאפשר הכללת מידע דינמי מהשרת בתוך דפי HTML.

דפי HTML עם תגי SSI מקבלים בדרך-כלל סיומת shtml או shtm. בשרת IIS נפוצת גם הסיומת stm.

SSI הופיעה לראשונה בשרת NCSA HTTPd, שממנו התפתח שרת Apache. שרת IIS של מיקרוסופט תומך ב‑SSI באמצעות רכיב ISAPI בשם Ssinc.dll. Apache הרחיב את ה‑SSI עם מה שנקרא xSSI ומממש זאת במודול mod_include.

הוראות SSI נמצאות בתוך הערות HTML. זה אומר שאם השרת לא מפרש את ההוראה, ההערה לא תפריע לתצוגת הדף. כל הוראה מתחילה בסימון # ומכילה שם הוראה ורשימת פרמטרים בסגנון name="value".

תחביר ה‑SSI של שרת זה הוא הבסיס שעליו מבוססים היישומים האחרים.

בגרסה הבסיסית של שרת NCSA HTTPd יש שש הוראות עיקריות, שהן כל מה שצריך להכנסת תוכן דינמי פשוט.

ניתן להשתמש במשתני הסביבה שמקובלים ב‑CGI. CGI היא שיטה להריץ תוכניות בשרת ולקבל מידע. דוגמאות למשתנים: SERVER_NAME (שם השרת), QUERY_STRING (מחרוזת השאילתה), REMOTE_ADDR (כתובת המבקר). יש גם משתנים כמו DOCUMENT_NAME (שם הקובץ הנוכחי) ותאריך השרת.

מימוש ה‑SSI ב‑IIS תואם באופן כמעט מוחלט ל‑NCSA HTTPd. ב‑IIS ההוראה exec יכולה להפעיל גם דפי ASP ויישומי ISAPI (ממשק תוספים ל‑IIS), ולא רק תוכניות CGI. הוראת include ניתנת לשימוש גם בדפי ASP, כאשר מפרש ASP מבצע את ההכללה.

Apache תומך בהוראות הבסיסיות אך מרחיב אותן. ההרחבות כוללות שיפורים להוראות קיימות והוספת הוראות חדשות, מה שהופך את ה‑SSI ב‑Apache לכלי חזק יותר.

file is foo.shtml

file is bar.shtml

file is moo.shtml

I don't know which file is this

קטע הקוד דלעיל יציג הודעה שונה בהתאם לשם הקובץ שבו הושם.

Server Side Includes, או בקיצור SSI, פירושו הכללות צד-שרת. זו דרך לגרום לשרת לשנות דפי HTML ולהוסיף להם תוכן דינמי.

דפים עם SSI בדרך כלל מסתיימים ב‑shtml או ב‑shtm. ב‑IIS משתמשים גם ב‑stm.

SSI נוצרה לראשונה בשרת NCSA, שממנו נולד Apache. גם שרת IIS תומך ב‑SSI.

הוראות SSI כתובות בתוך תגי הערות של HTML. זה שומר על הדף אם השרת לא תומך בהוראות.

הקומנדות יכולות להכניס מידע מהשרת, כמו שם הקובץ, התאריך או כתובת המבקר. CGI היא דרך להריץ תוכניות בשרת לקבלת מידע כזה.

IIS ו‑Apache תומכים ב‑SSI. ב‑IIS ניתן להפעיל גם דפי ASP בעזרת הוראות מסוימות.

file is foo.shtml

file is bar.shtml

file is moo.shtml

I don't know which file is this

הקטע למעלה יראה הודעה שונה לפי שם הקובץ שבו הושם.