יצירת אפליקצית Yii ראשונה
בכדי לקבל ניסיון התחלתי עם Yii, אנו מתארים בחלק זה כיצד ליצור את האפליקציה הראשונה שלנו ב Yii. אנו נשתמש בכלי yiic המאפשר יצירה אוטומטית של קוד בעבור משימות מסויימות. לנוחות, אנו מניחים ש YiiRoot הינה התיקיה בה Yii מותקן, ו WebRoot הינה התיקיה הראשית של שרת הווב שלנו.
יש להריץ את yiic בשורת הפקודות בצורה הבאה:
» Note|הערה: בעת הרצת yiic על גבי מחשבים Mac OS, Linux או Unix, יהיה צורך בשינוי הרשאות של קובץ ה yiic בכדי שיהיה ניתן להריץ אותו. לחלופין, ניתן להריץ את הכלי בצורה הבאה,
» ~~~
» % cd WebRoot/testdrive
» % php YiiRoot/framework/yiic.php webapp WebRoot/testdrive
» ~~~
זה יצור שלד לאפליקצית Yii תחת התיקיה WebRoot/testdrive. לאפליקציה יש מבנה של תקיות שנחוץ למרבית אפליקציות ה Yii.
ללא צורך בכתיבת שורת קוד אחת, אנו יכולים לנסות את האפליקציה שיצרנו כרגע על ידי כניסה לקישור הבא בדפדפן:
כפי שניתן לראות, לאפליקציה יש ארבע עמודים: עמוד הבית, עמוד האודות, עמוד ההתחברות ועמוד היצירת קשר. עמוד יצירת הקשר מציג טופס יצירת קשר שמשתמש יכול להזין ולשלוח למנהל האתר, ועמוד ההתחברות מאפשר למשתמש לאמת את עצמו לפני שהוא ניגש לתוכן שהוא מוגבל לבעלי גישה בלבד.
עמוד הבית
עמוד יצירת הקשר
עמוד יצירת קשר עם שגיאות
עמוד יצירת קשר לאחר שליחת הטופס בהצלחה
עמוד התחברות
הדיאגרמה הבאה מציגה את מבנה התיקיות של האפליקציה שלנו. אנא קרא אודות מוסכמות בכדי לקבל הסבר מדוייק למבנה זה.
התחברות למסד נתונים
מרבית אפליקציות הווב מגובות בעזרת מסד נתונים. אפליקצית הניסיון שלנו היא אחת מהם. בכדי להשתמש במסד נתונים, אנו צריכים להגדיר לאפליקציה כיצד להתחבר אליה. זה נעשה בקובץ הגדרות האפליקציה אשר ממוקם WebRoot/testdrive/protected/config/main.php, המובלט בצורה הבאה,
הקוד למעלה מנחה את Yii שהאפליקציה צריכה להתחבר למסד נתונים SQLite תחת WebRoot/testdrive/protected/data/testdrive.db בעת הצורך. מסד הנתונים SQLite כבר כלול בשלד האפליקציה שיצרנו זה עתה. מסד נתונים מכיל טבלה אחת בלבד בשם tbl_user:
במידה והינך רוצה לעבוד עם מסד נתונים מסוג MySQL במקום, תוכל להשתמש בקובץ התרשים של MySQL המצורף הנמצא ב WebRoot/testdrive/protected/data/schema.mysql.sql בכדי ליצור את מסד הנתונים.
» Note|הערה: בכדי להשתמש באפשריות מסדי הנתונים, אנו צריכים להתקין ולהפעיל את תוסף ה PHP בשם PDO ואת התוספים הספציפים לדרייברים בהם אנו נשתמש. בעבור אפליקצית הבדיקה הזו אנו צריכים להפעיל את התוספים php_pdo ו php_pdo_sqlite.
יישום פעולו CRUD
עכשיו זה החלק המהנה. אנו נרצה ליישם את פעולות ה-CRUD שזה קיצור של יצירה, קריאה, עדכון, מחיקה (Create, Read, Update, Delete) עבור הטבלה User שהרגע יצרנו. אפשרות זו הכרחית עבור אפליקציות אשר תלויות במשתמשים במערכת. במקום לבזבז את הזמן לכתיבת הקוד עצמו, אנו נשתמש ב-Gii -- מחולל קוד מבוסס אינטרנט (ווב).
» Info|מידע: Gii קיים החל מגרסא 1.1.2. עבור גרסאות ישנות יותר, אנו יכולים להשתמש בכלי yiic בכדי להשיג את אותה המטרה. למידע נוסף, אנא עיין במדריך ליצירת פעולות CRUD על ידי הכלי yiic. יישום פעולות CRUD בעזרת yiic
הגדרת Gii
בכדי להשתמש ב Gii, אנו קודם צריכים לערוך את הקובץ WebRoot/testdrive/protected/config/main.php, הידוע בשמו כ-קובץ הגדרות האפליקציה.
לאחר מכן, יש לגשת לקישור http://hostname/testdrive/index.php?r=gii. אנו נראה מסך המבקש מאתנו להזין סיסמא, אותה סיסמא שציינו בשלב הקודם בקוד המוצג למעלה.
יצירת מודל משתמשים
לאחר ההתחברות, יש ללחוץ על הקישור Model Generator. זה יביא אותנו לעמוד יצירת מודל הבא,
יצירת מודל
בשדה של Table Name יש להזין tbl_user. בשדה של Model Class, יש להזין User. לאחר מכן יש ללחוץ על כפתור Preview. זה יציג לנו את הקוד שיווצר. כעת יש ללחוץ על כפתור Generate. קובץ חדש בשם User.php יווצר תחת התיקיה protected/models. כפי שאנו נסביר במהלך המדריך הזה, מחלקת המודל User שהרגע יצרנו מאפשרת לנו לתקשר עם הטבלה tbl_user אשר נמצאת תחת המחלקה באופן מונחה עצמים.
יצירת קוד CRUD
לאחר יצירת קובץ מחלקת המודל, אנו ניצור את הקוד אשר מיישם את פעולות ה CRUD עבור המשתמש. אנו בוחרים במחולל ה-CRUD במערכת ה-Gii, כפי שמוצג בתמונה למטה,
מחולל CRUD
בשדה Model Class, יש להזין User. בשדה Controller ID, יש להזין user (באותיות קטנות בלבד). עכשיו יש ללחוץ על כפתור התצוגה מקדימה - Preview ולאחר מכן על כפתור היצירה - Generate. סיימנו עם יצירת הקוד עבור פעולות ה-CRUD.
גישה לעמודים הנוצרו על ידי CRUD
הבא ונראה את התוצאה הסופית של העבודה שנעשתה:
עמוד זה יציג רשימה של רשומות משתמשים מהטבלה tbl_user.
לחץ על כפתור ה Create User בעמוד. אנו נעבור לעמוד ההתחברות במידה ולא התחברנו עדיין. לאחר ההחברות, אנו נראה טופס שמאפשר לנו להוסיף משתמש חדש. מלא את הטופס ולחץ על כפתור Create.
במידה וישנם שגיאות כלשהם בטופס או בתוכן שהוזן, תוצג שגיאה שתמנע מאיתנו לשלוח את הטופס. בחזרה לעמוד רשימת המשתמשים, אנו אמורים לראות את המשתמשים החדשים אותם יצרנו ברשימה.
חזור על השלבים למעלה כדי להוסיף עוד משתמשים. שים לב שעמוד רשימת המשתמשים יציג עמודים אוטומטית אם ישנם יותר מדי משתמשים המוצגים בעמוד אחד.
אם נתחבר כמנהלים עם הפרטים admin/admin, אנו נוכל לצפות בעמוד ניהול המשתמשים בקישור הבא:
עמוד זה יציג את רשימת המשתמשים בפורמט טבלאי. אנו נוכל ללחוץ על כותרות העמודות בכדי למיין את הרשימה לפי אותה עמודה עליה לחצנו. נוכל ללחוץ על הכפתורים בכל רשומה בכדי לצפות, לערוך או למחוק את אותה רשומה. אנו יכולים לצפות בעמודים שונים. כמו כן אנו יכולים לסנן ולחפש אחר מידע אותו אנו מחפשים.
כל האפשרויות הללו מגיעות ללא צורך בכתיבת שורת קוד אחת!
עמוד ניהול משתמשים
עמוד יצירת משתמש חדש
«div class="revision"»$Id: quickstart.first-app.txt 2125 2010-01-21 16:54:29Z qiang.xue $«/div»