מדריך:דרישות התקנה

בנוסף לתוכנת מדיה-ויקי עצמה, תצטרכו:

• תוכנת שרת אינטרנט להצגת דפי מדיה-ויקי לדפדפן האינטרנט.
• PHP כדי להריץ את מדיה-ויקי.
• שרת מסד נתונים לאחסון דפים ונתונים של מדיה-ויקי.

בנוסף, ישנם תלויות אופציונליות שונות הנדרשות אם ברצונך להשתמש בתכונות מתקדמות מסוימות (ראה להלן).

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

כדי להריץ סקריפטים לתחזוקה של מדיה-ויקי, תזדקק לגישה לשורת הפקודה.

התקנה בהורדה אחת

אם אתם משתמשים בלינוקס, עדיף להתקין את שרת האינטרנט Apache, את PHP ואת שרת מסד הנתונים MariaDB באמצעות מנהל החבילות שלכם. בדביאן ובאובונטו, בצעו את הפעולות הבאות:

sudo apt-get install apache2 mariadb-server php php-intl php-mbstring php-apcu php-curl php-mysql php-xml

חבילות תוכנה

במערכות הפעלה אחרות, השתמשו בחבילת תוכנה כמו XAMPP מאת https://www.apachefriends.org כדי להתקין ולקבוע את תצורת כל החבילות החשובות - שרת האינטרנט Apache, PHP ו-MariaDB - – בהורדה אחת בלבד. זה זמין עבור לינוקס, ווינדוס ומק. החל ממאי 2025, הגרסה האחרונה של XAMPP כוללת PHP 8.2 (מדיה-ויקי דורשת לפחות 8.1.0).

לחלופין, אם אתם משתמשים ב-macOS, תוכלו להשתמש ב-MAMP, שהוא המקביל ל-XAMPP. MAMP כולל את היכולת להריץ את שרת האינטרנט Apache ואת מסד הנתונים MySQL. זה זמין גם עבור ווינדוס וגם עבור מק, אך בדרך כלל משתמשים בו במק במקום בווינדוס.

שרת אינטרנט

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

מדיה-ויקי תואמת באופן כללי לכל שרתי האינטרנט העיקריים שיכולים להפעיל גרסה תואמת של PHP. רוב ההתקנות משתמשות בשרת האינטרנט Apache HTTPD. Nginx (דוגמת תצורה) גם היא בחירה טובה.

PHP

PHP היא שפת התכנות בה כתובה מדיה-ויקי, והיא נדרשת להפעלת התוכנה.

• עבור הגרסה היציבה האחרונה של מדיה-ויקי, נדרש לפחות PHP 8.1.0. ראה את הדף ב-Compatibility למידע נוסף.
• נדרשות הרחבות הליבה הבאות של PHP (אלה בדרך כלל מקומפלות כחלק מ-PHP עצמו): calendar, ctype, dom, fileinfo, iconv, json, openssl, xml, xmlreader. בדוק את הפלט של php -m כדי לגלות אילו הרחבות מופעלות כעת במקרה הספציפי שלך.
• גם הרחבות הליבה של PHP הבאות נדרשות:
  • intl - נדרש מאז מדיה-ויקי 1.36
  • mbstring - נדרש מאז מדיה-ויקי 1.27
  • bcmath או gmp - נדרש במערכות 32 סיביות
• בנוסף להרחבות הנדרשות, מומלצות ההרחבות הבאות:
  • apcu
  • curl
• מדיה-ויקי דורשת רק הרחבות PHP שמופעלות ב-PHP כברירת מחדל. אם ספק האירוח שלך מספק סביבת LAMP בסיסית ללא אלה, ייתכן שתצטרך להתקין או להפעיל אותם באופן ידני.
  • בדביאן/אובונטו, הפקודה הבאה מתקינה את כל הרחבות ה-PHP המומלצות המפורטות לעיל:

    sudo apt-get install php php-intl php-mbstring php-apcu php-curl

• אצל ספקי אירוח עם לוח בקרה כמו cPanel, לעתים קרובות ניתן להשתמש ב"בחירת גרסת PHP" (PHP Selector) כדי להפעיל את ההרחבות הללו. (לדוגמה, לאחר שראית את ההודעה "חסרה לך הרחבה נדרשת ל-PHP שמדיה-ויקי דורשת כדי לפעול. אנא התקן: intl")
• ברוב ההפצות המבוססות של דביאן/אובונטו, החבילה php-mysql נדרשת אם ברצונך שמדיה-ויקי תשתמש ב-MySQL.
• חלק מהתכונות של מדיה-ויקי עשויות לדרוש פונקציות PHP שמבצעות תהליכים חיצוניים, כמו צילום תמונות ממוזערות, שחלק מהמארחים הזולים בדרך כלל משביתים. אנא קחו זאת בחשבון אם אתם מתכננים להתקין את מדיה-ויקי על מארח משותף.
• הרחבות מדיה-ויקי עשויות לדרוש תכונות PHP נוספות, לדוגמה VisualEditor דורש תמיכה ב-libcurl (php-curl בהפצות מבוססות דביאן/אובונטו).

אם עליך לקמפל PHP מקוד המקור, עיין ב-PHP configuration עבור אפשרויות קומפילציה המשפיעות על מדיה-ויקי.

שרת מסד נתונים

מדיה-ויקי מאחסנת את כל הטקסט והנתונים (דפי תוכן, פרטי משתמש, הודעות מערכת וכו') במסד נתונים, אותו היא מסוגלת לשתף עם יישומים מבוססי אינטרנט אחרים (phpBB וכו'). תזדקק לאחד משרתי מסד הנתונים הבאים כדי להריץ את הגרסה העדכנית ביותר של מדיה-ויקי:

• MariaDB 10.3.0+ או MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.24.0+

מומלץ להשתמש ב-MariaDB או ב-MySQL מכיוון שויקימדיה משתמשת ב-MariaDB. כל שרתי מסד נתונים אחרים נבדקים פחות וסביר להניח שתיתקלו בכמה באגים.

MediaWiki no longer supports using Oracle or Microsoft SQL Server as of version 1.34 .

חלק מהמשתמשים מוצאים שזה מועיל להתקין תוכנות נוספות של לוח בקרה כגון phpMyAdmin ‏(MySQL/MariaDB) או phpPgAdmin ‏(PostgreSQL) כדי לסייע בניהול שרת מסד הנתונים. חלק משירותי אחסון מספקים גם תוכנה כזו.

דרישות חומרה

הדרישות המינימליות המומלצות הן 256MB של זיכרון RAM עבור אתר אינטרנט עם מחשב יחיד ו-85MB של אחסון, אם כי זה לא יספיק עבור אתר ציבורי עמוס או אתר שבו ניתן להעלות תוכן. חלק מהמשתמשים דיווחו על הפעלת מדיה-ויקי על מחשבים עם זיכרון RAM של 48 מגה-בייט בלבד.

תלויות אופציונליות

• נדרש ImageMagick או GD עבור הפקת תמונה ממוזערת.
• נדרשת גישה למעטפת כדי להריץ את Maintenance scripts ; שדרוג מדיה-ויקי עשוי להיות קשה יותר בלעדיה.
• שליחת התראות דוא"ל דרך השרת עצמו דורשת סוכן העברת הודעות (MTA).
• ניתן להשתמש ב-GNU diff3 כדי לפתור סכסוכים באופן אוטומטי.
• ניתן להשתמש ב-memcached לאחסון אובייקטים במטמון.

ראו גם

• Compatibility , למידע על האופן שבו דרישות ההתקנה של מדיה-ויקי צפויות להשתנות בעתיד.
• Manual:OS specific help