קונפיגורציה של PHP

אם הצלחת להתקין את PHP על המערכת שלך, אז נשאר לך כעת "לקנפג" את PHP כדי להתאים אותה למערכת שלך ובהתאם לדרישות שלך. קובץ ה-php.ini מגיע עם ערכים אופטימליים, אך ישנם כמה כניסות שצריך לשנות את הערכים שלהם בהתאם לכל מערכת. לכל כניסה בקובץ הקונפיגורציה צמוד הסבר על הפעולה שלה ועל הערכים שהיא מקבלת, ורצוי מאוד לקרוא את ההסברים לפני שינוי הערכים.
לאחר ביצוע שינויים בקובץ הקונפיגורציה, יש לאתחל מחדש את השרת על-מנת שהשינויים יכנסו לתוקף.

הערכים On, True ו-Yes - ערכם הוא אמת, כן.
הערכים Off, False ו-No - ערכם הוא שקר, לא.
הערך None - ערכו הוא כמו ערך ריק (null).
(הכניסות והערכים בקובץ הקונפיגורציה לא case-sensitive, כלומר אין הבדל בין אותיות גדולות וקטנות).

פתח את הקובץ php.ini באמצעות עורך טקסט פשוט מהמקום בו שמרת אותו בהתקנה. חפש בקובץ (Find...) את הכניסות הבאות ושנה את ערכן לפי ההסברים ולפי דרישותיך.

• General Options
• Session Options
• MySQL Options

allow_url_fopen = On

מאפשר פתיחת קבצים משרתים אחרים, למשל באמצעות http:// או ftp://.

short_open_tag = On

מאפשר לך שימוש בתג מקוצר של PHP (<?). אם Off אז רק התגים <?php ו-<SCRIPT language="PHP"> מוכרים.

asp_tags = Off

מאפשר לך להשתמש בתג PHP בסגנון של ASP. רצוי לכבות אפשרות זו כדי למנוע סיבוכים עם ASP.

auto_append_file = None

מקבל שם של קובץ שירוץ אחרי כל סקריפט.

auto_prepend_file = None

מקבל שם של קובץ שירוץ לפני כל סקריפט.

disable_functions = None

מקבל רשימה של פונקציות (מופרדים עם פסיקים) שרוצים לחסום, בדר"כ למטרות אבטחה.

display_errors = On

מאפשר הדפסת שגיאות לפלט כקוד HTML. הדפסת שגיאות לפלט עלולה לחשוף מידע מאובטח של האתר, כגון דרכים לקבצים ובסיסי נתונים. אם אתה משתמש ב-PHP בשרת ציבורי, רצוי מאוד לשנות את ערכו ל-Off, ולהשתמש בכניסה error_log.

doc_root = None

מקבל את הספריה הראשית של קבצי ה-PHP. בדר"כ לא שמים בו ערך.

engine = On

שימושי בעיקר עבור שרת Apache. מאפשר שימוש בהרצת קבצי PHP עבור virtualhosts שונים (בקובץ httpd.conf של Apache). רצוי שיהיה דלוק.

error_log = None

מקבל את שם הקובץ או ה-system log בו ישמרו השגיאות. אם לא משתמשים באפשרות של log_errors ניתן להשאיר ערך ריק.

log_errors = Off

קובע האם לשמור את השגיאות ב-Error Log של המערכת.

error_reporting = E_ALL & ~E_NOTICE

קובע את רמת ההערות ש-PHP תתייחס אליהם. מידע על רמות ההערות תמצא בקובץ הקונפיגורציה.

file_uploads = On

מאפשר העלאת קבצים לשרת דרך HTTP. עובד עם upload_tmp_dir ו-upload_max_filesize.

upload_tmp_dir = "<directory>"

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

upload_max_filesize = 2M

מקבל את גודל הקובץ המקסימלי שניתן יהיה לעלות לשרת.

html_errors = Off

כאשר PHP מדפיסה הודעת שגיאה, אפשרות זו קובעת האם להשתמש בתגי HTML. במידה ומשתמשים אז נוצרים קישורים לדפי הסבר על השגיאה שארעה או על הפונקציה שגרמה לשגיאה. עובד עם docref_root ו-docref_ext.

docref_root = "http://www.php.net/manual/en/"

הספריה בה נמצאים דפי העזרה (יכול להיות ספריה מקומית או מחוץ לשרת). חייב להסתיים ב-'/'.

docref_ext = ".php"

הסיומת של דפי ההסבר. חייב להתחיל ב-'.'.

open_basedir = None

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

variables_order = "EGPCS"

קובע את הסדר בה PHP מאתחלת משתנים גלובליים (כשהאפשרות register_globals פועלת). E=Enviorment, G=GET, P=POST, C=Cookies, S=Server. האותיות הימניות משכתבות את האותיות השמאליות במקרה של אותו שם משתנה.

ignore_user_abort = True

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

implicit_flush = Off

אם דלוק אז הוא מנקה את ה-buffer של הפלט אחרי כל הוצאה של פלט, למשל דרך echo(), print() או בלוקים של HTML. רצוי לכבות את האפשרות הזו, ובעיקר משתמשים בה ב-debug. ניתן לנקות את ה-buffer בזמן ריצה עם הפונקציה flush().

include_path = "."

מגדיר רשימה של ספריות שבהם יש לחפש את הקבצים כאשר משתמשים ב-include() ו-require(). רשימת הספריות מופרדות עם '; ב-Windows, ועם ',' ב-Unix.

magic_quotes_gpc = On

קובע האם להוסיף backslash (\) אוטומטית לפני: " ' \ למשתנים שמגיעים דרך GPC (GET, POST, Cookies).

magic_quotes_runtime = Off

קובע האם להוסיף backslash (\) אוטומטית לפני: " ' \ למחרוזות שמוחזרות מרוב הפונקציות של שימוש בקבצים ובסיסי נתונים.

magic_quotes_sybase = Off

אם דלוק, אז כאשר משתמשים ב-magic quotes, לסימן ' יוסף ' במקום \ לפניו.

max_execution_time = 30

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

memory_limit = 8M

קובע את גודל הזיכרון המקסימלי בבתים שמותר לסקריפט לתפוס בזמן ריצה. מונע מסקריפטים לתפוס זיכרון רב מדי על השרת.

precision = 14

קובע את רמת הדיוק של מספרים עם נקודה עשרונית (מספר ספרות אחרי הנקודה).

register_argc_argv = On

קובע האם ליצור את המשתנים argc ו-argv בתוך המשתנה הגלובלי $_SERVER שיחזיקו מידע על משתנים של GET. בדר"כ לא נוהגים להשתמש במשתנים אלו, וניתן לכבות אותם להגביר קצת יותר את היעילות של PHP.

post_max_size = 4M

גודל מקסימלי בבתים ש-PHP תהיה מוכנה לקבל דרך מתודת POST. גודל זה כולל בתוכו גודל של קבצים, ולכן שים לב שערך זה יהיה גדול מ-upload_max_filesize. כמו-כן שים לב שערך זה יהיה קטן מ-memory_limit.

register_globals = On

קובע האם ליצור משתנים גלובליים מ-EGPCS (Enviorment, GET, POST, Cookie, Server).
אם ערך זה מופעל, אז למשל: ה-URL http://localhost/test.php?id=036 ייצור משתנה גלובלי $id. והמשתנה $PHP_SELF יווצר מהמשתנה $_SERVER["PHP_SELF"].
עד גרסה PHP4.2.0 ערך זה היה אמת כברירת מחדל, אך בגרסאות החדשות ערך זה מאותחל כשקר. יש יתרונות ברורים לכבות את האפשרות הזו, בעיקר מסיבות אבטחה ומניעה של שינוי משתנים גלובליים בתוכנית. כשאפשרות זו לא פועלת, אז הגישה למשתני EGPCS נעשית ע"י המשתנים הגלובליים המתאימים (למשל: $_GET, $_SERVER וכו').

track_errors = On

אם דלוק, אז PHP שומרת את הודעת השגיאה האחרונה במשתנה הגלובלי $php_errormsg.

user_dir = None

מקבל את שם הספריה שממנה יש לפתוח ספריות המשתמשים כשמשתמשים ב-/~username. בדר"כ לשימוש עבור מערכות Unix רבי משתמשים.

enable_dl = True

מאפשר שימוש בפונקציה dl() לטעינת extensions נוספים ל-PHP. הפונקציה הזו לא עובדת בשרתים שהם multithreaded, כגון IIS ו-Zeus, ויש לכבות אפשרות זו עבור שרתים אלו. למעשה, אפשרות זו עובדת בצורה הכי טובה עבור Apache Module.

extension_dir = "<directory>"

הספריה בה PHP מחפשת את ה-extensions שטוענים.

extension = "<extension-file>"

קובץ ה-extension ש-PHP טוענת כאשר היא מתחילה. ב-Unix, הקבצים נגמרים בסיומת '.so', וב-Windows בסיומת '.dll'.

browscap = "browscap.ini"

מקבל את שם הקובץ שמגדיר ל-PHP את יכולות הדפדפנים. הוסף לערך גם את הדרך לקובץ browscap.ini.

session.save_handler = files

צורת השמירה של ה-sessions.

session.save_path = <directory>

הספריה בה שומרים את קבצי ה-sessions. יש לדאוג להרשאות כתיבה לכל המשתמשים.

session.use_cookies = 1

האם להשתמש בעוגיות כדי לשמור את מספר הזיהוי של ה-session. לא כל הדפדפנים תומכים בעוגיות, אך אופציה זו בטיחותית יותר מהעברת מספר הזיהוי של ה-session דרך ה-URL.

session.name = PHPSESSID

משמש כשם לעוגיה (אם משתמשים) או למשתנה שמעביר את מספר הזיהוי של ה-session.

session.auto_start = 0

מאפשר לפתוח session באופן אוטומטי בכל הרצת סקריפט. רצוי לכבות אפשרות זו, כדי ש-session יתחיל רק כאשר מבקשים אותו (עם session_start()).

session.cookie_lifetime = 0

אורך החיים של העוגיה בשניות בה נשמר מספר הזיהוי של ה-session. זמן 0 פרושו עד שהדפדפן נסגר.

session.cookie_path = /

עץ הספריה בו העוגיה של ה-session תקפה.

session.cookie_domain =

ה-domain בו העוגיה של ה-session תקפה.

session.serialize_handler = php

האחראי על שמירת הנתונים בקובץ ה-session.

session.gc_probability = 1

הסיכוי (בין 0 ל-1) שרוטינת מחיקת קבצי ה-session הישנים (garabage collection) תופעל בכל התחלה של session.

session.gc_maxlifetime = 1440

הזמן בשניות שקבצי ה-session תקפים. הזמן נמדד מה-access time האחרון לקובץ ה-session, או מה-creation time של קובץ ה-session במידה ומערכת הקבצים לא תומכת ב-access time.

session.referer_check =

מחרוזת לבדיקה ב-HTTP Referer, שאם לא נמצאת אז היא תסמן את עוגיית ה-session כלא תקפה. בדר"כ לא שמים ערך בכניסה זה.

session.entropy_file =

מקבל קובץ חיצוני שמוציא פלט, כדי שישמש ביצירת מספר זיהוי רנדומלי ל-session, למשל: /dev/random שמצוי ברוב מערכות Unix. בדר"כ לא משתמשים באפשרות זו ונותנים ל-PHP ליצור מספר רנדומלי באופן אוטומטי.

session.entropy_length =

מספר הבתים שייקראו מתוך הפלט של הקובץ המצויין ב-session.entropy_file.

session.cache_limiter = nocache

מציין את קביעת ה-cache בדפים שמשתמשים ב-sessions. יכול להיות: none/nocache/private/private_no_expire/public.

session.cache_expire = 180

הזמן בדקות בו הדף שמשתמש ב-cache יהיה תקף. אין לערך זה השפעה על none או nocache.

session.use_trans_sid = 0

קובע האם להעביר את מספר הזיהוי של ה-session דרך ה-URL. אופציה זו לא ממש בטיחותית, אך לפעמים אין ברירה וחייבים להשתמש בה, כי לא כל הדפדפנים תומכים בעוגיות.

mysql.allow_persistent = On

מאפשר לשמור את הקישור ל-MySQL גם אחרי שהרצת הסקריפט הסתיימה. שמירת הקישור לא יוצרת בעיות אבטחה בבסיסי נתונים, אך היא מייעלת את PHP. אפשרות זו לא משפיעה על CGI module PHP.

mysql.max_persistent = 1

מספר מקסימלי של קישורים שמורים ל-MySQL לכל תהליך בשרת.

mysql.max_links = 1

מספר מקסימלי של קישורים (שמורים ורגילים) ל-MySQL בכל תהליך.

mysql.default_port =

ברירת המחדל של ה-TCP port שמשמש לקישור אל MySQL.

mysql.default_socket =

ברירת המחדל של ה-socket שמשמש לקישור אל MySQL.

mysql.default_host =

ברירת המחדל של ה-host שמשמש לקישור אל MySQL.

mysql.default_user =

ברירת המחדל של שם המשתמש שמשמש לקישור אל MySQL. רצוי לא לשים בו ערך משיקולי אבטחה.

mysql.default_password =

ברירת המחדל של הססמא שמשמשת לקישור אל MySQL. רצוי לא לשים בו ערך משיקולי אבטחה.