הערות למפתחים

בעוד ההתקנה בפועל של XOOPS לשימוש בפיתוח דומה להתקנה הרגילה שתוארה כבר, ישנם הבדלים עיקריים בעת בניית מערכת מוכנה למפתחים.

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

הבדל נוסף הוא שהספריות xoops_data ו_xoops_lib_ יכולות בדרך כלל להישאר במקומן ללא שינוי שמות, כל עוד מערכת הפיתוח שלך אינה נגישה ישירות באינטרנט הפתוח (כלומר ברשת פרטית, כמו מאחורי נתב).

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

תוכל למצוא מידע נוסף ב- Tools of the Trade פֶּרֶק.

Git ומארחים וירטואליים

רוב המפתחים רוצים להיות מעודכנים עם המקורות הנוכחיים, ולתרום שינויים בחזרה למעלה הזרם XOOPS/XoopsCore27 repository on GitHub. זה אומר שבמקום להוריד ארכיון מהדורות, תרצו fork עותק של XOOPS והשתמש ב-git כדי clone המאגר הזה לתיבת ה-dev שלך.

מכיוון שלמאגר יש מבנה ספציפי, במקום להעתיק קבצים מהספרייה htdocs לשרת האינטרנט שלך, עדיף להפנות את שרת האינטרנט שלך לתיקיית htdocs בתוך המאגר המשובט המקומי שלך. כדי להשיג זאת, אנו בדרך כלל יוצרים Virtual Host חדש, או vhost שמצביע על קוד המקור הנשלט על ידי git.

ב א WAMP סביבה, ברירת המחדל localhost בדף יש בקטע כלים קישור ל-הוסף מארח וירטואלי שמוביל לכאן:

באמצעות זה אתה יכול להגדיר ערך VirtualHost שייכנס ישירות למאגר הנשלט (עדיין) git שלך.

הנה דוגמה לערך ב wamp64/bin/apache/apache2.x.xx/conf/extra/httpd-vhosts.conf

<VirtualHost *:80>
    ServerName xoops.localhost
    DocumentRoot "c:/users/username/documents/github/xoopscore27/htdocs"
    <Directory  "c:/users/username/documents/github/xoopscore27/htdocs/">
        Options +Indexes +Includes +FollowSymLinks +MultiViews
        AllowOverride All
        Require local
    </Directory>
</VirtualHost>

ייתכן שתצטרך גם להוסיף ערך ב Windows/System32/drivers/etc/hosts:

127.0.0.1    xoops.localhost

עכשיו, אתה יכול להתקין על http://xoops.localhost/ לבדיקה, תוך שמירה על המאגר שלך שלם, ושמירה על שרת האינטרנט בתוך ספריית htdocs עם URL. בנוסף, אתה יכול לעדכן את העותק המקומי שלך של XOOPS למאסטר העדכני ביותר בכל עת מבלי להתקין מחדש או להעתיק קבצים. בנוסף, אתה יכול לבצע שיפורים ותיקונים לקוד כדי לתרום לו בחזרה XOOPS בְּאֶמצָעוּת GitHub.

Composer תלות

XOOPS 2.7.0 שימושים Composer לנהל את זה PHP תלות. עץ התלות חי בו htdocs/xoops_lib/ בתוך מאגר המקור:

• composer.dist.json היא הרשימה הראשית של התלות שנשלחה עם המהדורה.
• composer.json הוא העותק המקומי, אותו תוכל להתאים אישית עבור סביבת הפיתוח שלך במידת הצורך.
• composer.lock מצמיד גרסאות מדויקות כך שהתקנות ניתנות לשחזור.
• vendor/ מכיל את הספריות המותקנות (Smarty 4, PHPMailer, HTMLPurifier, firebase/php-jwt, מונולוג, symfony/var-dumper, xoops/xmf, xoops/regdom, ואחרים).

לשכפול git טרי של XOOPS 2.7.0, החל משורש הריפו, הרץ:

cd htdocs/xoops_lib
composer install

שימו לב שאין composer.json בשורש הריפו - הפרויקט חי תחתיו htdocs/xoops_lib/, אז אתה חייב cd לתוך הספרייה הזו לפני ההפעלה Composer.

שחרור tarballs ספינה עם vendor/ מאוכלס מראש, אבל ייתכן שלא שיבוטים של git. לִשְׁמוֹר vendor/ ללא פגע בהתקנות פיתוח - XOOPS יטען את התלות שלו משם בזמן ריצה.

ה XMF (XOOPS Module Framework) ספרייה ספינות כמו א Composer תלות ב-2.7.0, כך שתוכל להשתמש Xmf\Request, Xmf\Database\TableLoad, ושיעורים קשורים בקוד המודול שלך ללא כל התקנה נוספת.

מודול DebugBar

XOOPS 2.7.0 שולח מודול DebugBar המבוסס על Symfony VarDumper. זה מוסיף סרגל כלים של ניפוי באגים לדפים שעובדו שחושף מידע על בקשה, מסד נתונים ותבניות. התקן אותו מאזור הניהול של המודולים באתרי פיתוח והיערכות. אל תשאיר אותו מותקן באתר הפקה הפונה לציבור אלא אם כן אתה יודע שאתה רוצה.