راهنما: الزامات نصب

Install MediaWiki : Requirements • بارگیری • Extract • Upload • Set up database • Install • Configure • Customize

FAQ • Common issues • Get help and support

علاوه بر خود |نرم افزار شما میبایست کار های زیر را نیز انجام دهید Special:MyLanguage/Download

• یک وب‌سرور برای رسیدگی به صفحات درخواست شده از سوی کلاینت لازم است.

• پی‌اچ‌پی برای اجرا کردن نرم‌افزار لازم است.

• یک سرور پایگاه داده برای ذخیره صفحات و داده‌های وبگاه لازم است.

نرم افزار های اختیاری #Optional dependencies[[ ]]همچنین برای بهره بردن از بعضی از قابلیت های نرم افزار می بایست برخی را نیز نصب کرد

اگر وبسایت شما توسط شخص دیگری راه اندازی شده و شما کنترلی بر ان ندارید انگاه می بایست با مسول فناوری یا شرکتی که وبسایت را برای شما راه اندازی کرده تماس بگیرید تا اطمینان حاصل کنید که این نرم افزار ها به خوبی نصب شده اند و قابل دسترسی هستند

To run MediaWiki maintenance scripts, you will need command line access.

نصب ساده و تنها با یک دانلود

If you are using Linux, it's best to install the Apache web server, PHP, and the MariaDB database server using your package manager. On Debian and Ubuntu, do the following:

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

بسته‌های نرم‌افزار

On other operating systems, use a software bundle like XAMPP from https://www.apachefriends.org to install and configure all of the important packages – Apache web server, PHP, and MariaDB – with only one download. It is available for Linux, Windows, Mac and Solaris. As of ژانویه ۲۰۲۱, the latest version of XAMPP includes PHP 8.0 (MediaWiki requires at least 7.4.3).

Alternatively, if you run Mac OS, you can use MAMP, which is the equivalent to XAMPP. MAMP includes the ability to run the Apache web server and a MySQL database. It is available for both Windows and Mac, but is generally used on Mac instead of Windows.

وب سرور

In order to serve wiki pages to browsers, MediaWiki requires some web server software. Often you will not have a choice of which software to use – it will be the one provided by your hosting provider.

MediaWiki is broadly compatible with all major web servers that can invoke a compatible version of PHP. Most installations use the Apache HTTPD web server. Nginx (configuration example) is a good choice as well.

پی‌اچ‌پی

PHP is the programming language in which MediaWiki is written, and is required in order to run the software.

• For the latest stable version of MediaWiki, at least PHP 7.4.3 is required.

See the page on Compatibility for further information.

مدیاویکی با PHP 7.4.0 - 7.4.2 به‌دلیل یک اشکال بالادست ناسازگار است. Use PHP 7.4.3+ instead. برای اطلاعات بیشتر وظیفه T246594 ببینید.

If using PHP8 we recommend using MediaWiki 1.38.4+ or 1.39.0+. PHP8 is not in use by Wikimedia wikis, and thus gets less testing, but other groups do use MediaWiki with PHP8 without issue. If you encounter any bugs when using MediaWiki with PHP8 please report them. برای اطلاعات بیشتر وظیفه T248925 ببینید.

• The following extensions are required:

• • calendar (required since 1.33)
  • dom (required since 1.34)
  • fileinfo (required since 1.30)
  • intl (required since 1.36)
  • json (required since 1.22)
  • mbstring (required since 1.27, recommended for earlier versions)
  • xml (required since 1.27, recommended for earlier versions)
  • xmlreader (required since 1.36)

• Normally all of these are enabled in PHP by default.

But some host providers may only provide basic LAMP or LNMP environment. In that case you should install these extensions manually.

• • In Debian/Ubuntu, the following command can install PHP and the extensions listed above: sudo apt install php php-calendar php-dom php-fileinfo php-intl php-json php-mbstring php-xml php-xmlreader
• If using graphical hosting control panel software such as cPanel, you can often use "Select PHP Version" (PHP Selector) to check and enable extensions. (example error message: "You are missing a required extension to PHP that MediaWiki requires to run. Please install: intl")

• On most Debian/Ubuntu-based distros the php-mysql package is required if you want MediaWiki to use MySQL.

• Some features of MediaWiki may require PHP functions that execute external processes, like image thumbnailing, that some cheap hosts usually disable.

Please take this into consideration if you plan to install MediaWiki on a shared host.

• MediaWiki extensions may require additional PHP features, e.g. VisualEditor requires libcurl support (php-curl on Debian/Ubuntu-based distros).

If you need to compile PHP from source, then see PHP configuration for compilation options that affect MediaWiki.

Database server

MediaWiki stores all the text and data (content pages, user details, system messages, etc.) in a database, which it is capable of sharing with other web-based applications (phpBB, etc.). You will need one of the following database servers to run the latest version of MediaWiki:

• MariaDB 10.3.0+ or MySQL 5.7.0+
• PostgreSQL 10.0+
• SQLite 3.8.0+

Using MariaDB or MySQL is recommended as Wikimedia uses MariaDB. Any other database servers are less tested and you may likely run into some bugs.

Since مدیاویکی ۱٫۳۴ , we no longer support using Oracle and Microsoft SQL Server . We strongly advise to no longer use these.

Some users find it helpful to install additional control panel software such as phpMyAdmin (MySQL/MariaDB) or phpPgAdmin (PostgreSQL) to help administer the database server. Some خدمات میزبانی also provide such software.

Hardware requirements

The recommended minimum requirements are 256MB of RAM for a single-computer website and 85MB of storage, although this will not suffice for a busy public site or a site with uploading enabled. Some users have reported running MediaWiki on computers with as little as 48MB of RAM.

The install size can be reduced to around 50MB for a developer install and to around 26MB for a non-developer, end-user install. See Manual:Reduce size of the installation .

Optional dependencies

• ImageMagick or GD is required for Image thumbnailing .

• TeX is required for inline display of mathematical formulae.

In most Debian/Ubuntu-based distros, this is in the texlive package.

• Shell access is required to run اسکریپت‌های تعمیر و نگهداری ; upgrading MediaWiki may be more difficult without it.

• Sending email notifications via the server itself requires a message transfer agent (MTA).

• GNU diff3 can be provided to automatically resolve conflicts.

• memcached can be used for object caching.

جستارهای وابسته

• Compatibility , for information about how MediaWiki's installation requirements are likely to change in the future

• Manual:OS specific help