Hướng dẫn sử dụng:Hướng dẫn cài đặt

This page is a translated version of the page Manual:Installation guide and the translation is 24% complete.


Hướng dẫn này cung cấp hướng dẫn về cách cài đặt và cấu hình MediaWiki, cả thủ công và dễ dàng hơn lựa chọn thay thế. Cài đặt nhiều wikicài đặt wiki hiện có cũng được đề cập. Appendices cung cấp các liên kết đến ghi chú cài đặt chi tiết hơn cho các cấu hình hệ thống cụ thể và các cách sử dụng phần mềm ít phổ biến khác.

Hướng dẫn nâng cấp

Nếu bạn đang chạy MediaWiki, hãy xem Hướng dẫn nâng cấp.

Cài đặt thủ công

Tóm tắt

MediaWiki is not compatible with PHP 7.3.0 - 7.3.18 và 7.4.0 - 7.4.8 due to an upstream bug. Use PHP 7.3.19+ or 7.4.9+ instead. See task T246594 for more information.

Đối với người dùng có kinh nghiệm, đây là phiên bản nhanh của hướng dẫn cài đặt. Hầu hết người dùng (chẳng hạn như nếu bạn không biết cách cài đặt hoặc kiểm tra phần mềm tiên quyết trên máy tính của mình) sẽ muốn làm theo hướng dẫn cài đặt chính.

  1. Kiểm tra xem hệ thống của bạn có đáp ứng các yêu cầu tối thiểu sau đây không. (Xem Yêu cầu cài đặt để biết thêm chi tiết. Đảm bảo cũng kiểm tra RELEASE NOTES được gửi bằng MediaWiki để biết các yêu cầu.) Có thể bạn sẽ cần: Hình thumbnailing yêu cầu chương trình bổ sung. Parsoid (được yêu cầu bởi VisualEditor) và các dịch
  2. Download MediaWiki (direct link to download the stable release version) and extract the archive to a web-accessible folder on your computer.
  3. Point your browser to the directory where MediaWiki was extracted and follow the link to the setup screen. It should be in the form http://domain/directory/mw-config/index.php. Replace directory with the path to your extracted MediaWiki folder. If installing on a local machine, replace domain with localhost. If you install locally and later want to access your wiki from domain, then you will need to change LocalSettings.php from localhost to domain. If installed on a remote server, replace domain with your server's domain name (e.g. www.myserver.com).
  4. Follow the on-screen instructions to complete the process.

These instructions are deliberately brief. There is a lot that could go wrong, so if in doubt, you are advised to read the full instructions!

Main installation guide

  • Before installing MediaWiki, read these:
  • Configuring MediaWiki

Alternatives to manual installation

If your head is swimming from reading the above — or you feel frustrated, stuck, or lost — this section is for you...

You can avoid manual installation by using a pre-integrated MediaWiki software appliance, hosting services with 1-click installation, or wiki farms.

If you are installing for development or testing, consider using MediaWiki-Vagrant, a set of configuration scripts for Vagrant that automate the creation and update of a virtual machine that runs MediaWiki and your choice of extensions and services.

Official docker images are released on Docker Hub.

You can also use community resources based on platforms such as Docker. This is managed by Jenkins and should be kept up-to-date for some time.

These are community based resources and should always be treated with some measure of caution. Use at your own risk.

  Warning: Programs provided by webhosts to automatically install applications such as MediaWiki can, and frequently do, mishandle the process, resulting in errors and a failure to install MediaWiki. If you encounter this problem, it does not mean that you cannot install MediaWiki; all it means is that you should install manually following these steps. There are benefits to doing this, including more control over where on the server and file path you want to install it, the ability to use a shared database, or the ability to control more features of the wiki during the installation.


Wiki families (multiple wikis)

Main page: Manual:Wiki family

A wiki family is more than one wiki installed on the same computer.

Installing MediaWiki more than once

One approach is to install multiple instances of MediaWiki (such as with a software bundle like the Bitnami MediaWiki Stack) in different directories – one for each wiki. For example, you want an enterprise wiki and a personal wiki, and you want to keep them totally separate.

Multiple wikis with one MediaWiki

You could use a single installation of MediaWiki for multiple wikis, by either:

  1. Using a different database for each wiki.

See $wgDBname .

  1. Using a different database prefix for each wiki.

See $wgDBprefix .

Installing an existing wiki

Some users wish to install MediaWiki with Wikipedia, Wiktionary, or some other wiki loaded. This is useful for reading offline, for conducting experiments, and for mirroring/forking.

The main (but not necessarily the easiest) method for doing this is to install MediaWiki and then import.

See Manual:FAQ#Wiki importing.

(Non-MediaWiki solutions, such as Xowa and Kiwix, can be found at w:Wikipedia:Database download, and are probably the best options).

Start small. It is advisable to try installing a small wiki first, such as the Simple English Wikipedia, as a test run, before loading a big one like the English Wikipedia.

Appendices

Advanced uses

The following pages give instructions about how to install/configure MediaWiki for other, less common purposes.

Advanced configuration

The following pages cover some of the more advanced configuration options:

Installation assistance

  • mediawiki-l is the high-traffic mailing list to ask for support.

System-specific instructions

The following pages give more detailed installation instructions aimed at specific systems. However, by and large Manual:Installing MediaWiki is more up to date, and better written than the per system docs, and as such it is recommended you first consult Manual:Installing MediaWiki before looking at a per system installation documents.

Notes

See also