Forum und email

mysql_pconnect

(PHP 4, PHP 5, PECL mysql:1.0)

mysql_pconnect — פותחת חיבור עקבי לשרת MySQL

תיאור

משאב mysql_pconnect ([ מחרוזת $שרת [, מחרוזת $שם משתמש [, מחרוזת $סיסמא [, ערך שלם $דגלי_לקוח ]]]] )

מחזיר מזהה_חיבור חיובי בהצלחה, או FALSE בכשלון.

mysql_pconnect() יוצרת חיבור אל שרת MySQL. ברירות המחדל הבאות נכנסות לתוקף במידה וחסרים אחד מהפרמטרים האופציונליים: שרת = 'localhost:3306', שם משתמש = שם המשתמש שמריץ את תהליך (process) השרת, ו סיסמא = סיסמא ריקה. הפרמטר דגלי_לקוח יכול להיות צירוף של הקבועים MYSQL_CLIENT_COMPRESS, MYSQL_CLIENT_IGNORE_SPACE או MYSQL_CLIENT_INTERACTIVE.

הפרמטר שרת יכול גם להכיל מספר פורט. לדוגמא: "hostname:port" או נתיב אל socket, לדוגמא ":/path/to/socket" עבור localhost.

Note: תמיכה ב ":port" נוספה ב 3.0B4.
תמיכה ב ":/path/to/socket" נוספה ב 3.0.10.

mysql_pconnect() מתנהגת בצורה דומה ל mysql_connect() מלבד שני הבדלים עיקריים.

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

השני: הקישור אל שרת ה SQL לא ייסגר כאשר הסקריפט מסתיים. במקום זה, הקישור יישאר פתוח עבור שימוש עתידי (mysql_close()) לא תסגור קישורים שנוצרו על ידי mysql_pconnect()).

הפרמטר האופציונלי דגלי_לקוח הפך לזמין ב PHP 4.3.0.

סוג קישור זה, לפיכך, נקרא 'עקבי'.

Note: שימו לב, שסוג זה של קישורים פועל רק אם אתם משתמשים בגירסת המודול של PHP. ראו את מדור קישורי מסד נתונים עקביים לאינפורמציה נוספת.

Warning

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