메뉴얼:윈도우에서 미디어위키 구동하기

From MediaWiki.org
Jump to: navigation, search
This page is a translated version of the page Manual:Running MediaWiki on Windows and the translation is 2% complete.

Other languages:
català • ‎Deutsch • ‎English • ‎español • ‎suomi • ‎français • ‎italiano • ‎日本語 • ‎한국어 • ‎Bahasa Melayu • ‎Nederlands • ‎polski • ‎português • ‎português do Brasil • ‎русский • ‎中文
설치 가이드Manual:Installation guide
FreeBSDManual:Running MediaWiki on FreeBSD
GNU/LinuxManual:Running MediaWiki on GNU/Linux
- ALT LinuxManual:Running MediaWiki on ALT Linux
- Arch LinuxManual:Running MediaWiki on Arch Linux
- DamnsmalllinuxManual:Running MediaWiki on Damnsmalllinux
- Debian or UbuntuManual:Running MediaWiki on Debian or Ubuntu
- FedoraManual:Running MediaWiki on Fedora
- GentooManual:Running MediaWiki on Gentoo Linux
- MandrivaManual:Running MediaWiki on Mandriva
- Red Hat Enterprise LinuxManual:Running MediaWiki on Red Hat Linux
- SlackwareManual:Running MediaWiki on Slackware Linux
Mac OS XManual:Running MediaWiki on Mac OS X
NetWareManual:Running MediaWiki on NetWare
SolarisManual:Running MediaWiki on Solaris
- Solaris 11 / opensolarisManual:Running MediaWiki on Solaris 11 / opensolaris
- Solaris 10Manual:Running MediaWiki on Solaris 10
WindowsManual:Running MediaWiki on Windows
- Windows Server 2016Manual:Installing MediaWiki on Windows Server 2016
on a stickManual:Wiki on a stick
- Uniform ServerManual:Installation on Uniform Server (Windows)
- XAMPPManual:Installing MediaWiki on XAMPP
Sourceforge.netManual:Installing MediaWiki on SourceForge.net

This page will give you information about installing MediaWikiMediaWiki on a Microsoft Windows system using standard installation methods. For Windows-only hosting environments, the WIMP stack (using IIS) was recommended over Apache, (WAMP stack) as of 1.18, for manual installs.

Nginx - an alternative to apache and IIS - may be useful if you support MediaWiki across other host operating systems and/or are already using Nginx for internal hosting.

Required software

요구 사항 요구 사항 요약
  • 데이터베이스 서버
    • $mysql 이상의 버전 (*)
    • 또는 $mariadb
    • 또는 $postgresql 이상의 버전
    • or $sqlite

Image thumbnailing and TeX require additional programs. Parsoid (required by VisualEditor) and other services have their own requirements.

(*) – MariaDB, a GPL fork of the MySQL code by Monty Widenius, the founder of MySQL, is an alternative and can also be used by MediaWiki. Debian/Ubuntu repos.

Getting required software

Although these products are not that difficult to configure under Windows, it can be extremely difficult to install (by difficult, it takes 30 minutes for WIMP) and configure Apache+MySQL+PHP one product at a time if completely new to apache/mysql/php. Under such circumstances it is highly recommended to look for a LAMP or WAMP pre-made combination which can just be installed and used. These will save you 99% of the trouble of configuring each package manually. The down-side is that some of these are trimmed down or modified versions which makes it hard to upgrade individual components, and other ones are seriously out of date.

XAMPP

The most popular of which is XAMPP:

WebPI

Microsoft Web Platform Installer can install required pre-requisites for you. See blog.

Bitnami

  • Bitnami is a free suite of compatible installers for open source software. It supports an Nginx stack [1], Microsoft WAMP [2]), a generic LAMP stack [3] and XAMPP (which it will not install itself and on which only XAMPP-specific bitnami installers work [4]). Bitnami installs Mediawiki 1.23 on any of those, and they work alongside Wordpress or other software bitnami supports. See Bitnami itself for instructions [5] and updated support data. This can be a good option if you intend to use only the long term stable supported mediawiki releases. Support for older versions is not guaranteed. See Manual:Running_MediaWiki_on_Windows/bitnami for experiences with this method.

WAMP

See http://www.wampserver.com/en/

WIMP

On Azure: [6].

Installing MediaWiki

숙련된 사용자라면 설치 과정에 대한 간단한 설명이 담긴 링크를 참고해주세요.

  1. 먼저 설치하려는 서버가 최소 사양을 넘는지 확인합니다.
  1. 미디어위키 다운로드 (최신 버전으로 직접 링크) 당신의 서버에 있는 웹에서 접근할 수 있는 폴더에 압축을 해제하세요.
  2. 미디어위키의 압축이 해제된 곳에 브라우저를 통해 접속하고, 설치를 진행하세요. 다음과 같은 형식이어야 합니다 : http://domain/directory/mw-config/index.php. directory를 압축 푼 미디어위키 폴더 경로로 바꿔주세요. 로컬 장치에 설치하신다면, domainlocalhost로 변경하세요. 로컬 사용 용도로 설치된 위키는 LocalSetting.php에서 [domain][localhost]로 변경해야 합니다. 원격 서버에 설치하셨다면, [domain]을 서버의 도메인 이름으로 바꿔주세요. (예 : www.myserver.com)
  3. 과정을 완성하기 위해 Follow the on-screen instructions

이 안내는 정말 요약적입니다. 설치 과정 중 충분히 문제가 생길 수도 있습니다. 따라서, 전체 안내문을 읽으시기를 권장합니다!


Optional Software

Diffutils

Diffutils (which contains diff3) can be downloaded from here, and File (file type checker) from here.

To activate the use of diffutils within MediaWiki, you have to ignore the fact that they won't be found during installation (they may actually be found if you install diff into your path) and open up LocalSettings.php to make the following changes:

$wgDiff3 = "/usr/bin/diff3";

becomes

$wgDiff3 = "C:/Program Files/GnuWin32/bin/diff3.exe";

and replace:

$wgMimeDetectorCommand = "file.exe -bi"; #use external mime detector (linux)

with

$wgMimeDetectorCommand = "C:/Program Files/GnuWin32/bin/file.exe -bi"; # use external mime detector

Please note that you have to replace "C:/Progra..." with the actual location where you installed the tools to.

ImageMagick

Note: PHP now comes with GD enabled by default which will work for thumbnailing. GD will not require any configuration or modification to be used. Therefore it's highly recommended to not install ImageMagick, since it is known to be unstable. In fact the $wgImageMagickConvertCommand and Image.php mentioned below does not exist in MW1.15.1. However, in MW 1.23 you have to disable ImageMagick in LocalSettings.php by setting $wgUseImageMagick to false.
Note: Settings for XAMPP v1.7.7 VC9 and MediaWiki v1.18.1

The "Q8" ImageMagick releases use 8 bits per channel, while the "Q16" releases use 16 bits per channel. Here is the download page for ImageMagick on Windows. To make image thumbnailing work, you will need to open includes/Image.php, locate the line that starts with $cmd = $wgImageMagickConvertCommand ., and remove the escapeshellarg() function, then do the same to the next line, so that the command variable builds like this:

 $cmd  =  $wgImageMagickConvertCommand .
       " -quality 85 -background white -geometry {$width} ".
       ($this->imagePath) . " " .
       ($thumbPath);

In addition, check to be sure that the $wgImageMagickConvertCommand in localsettings.php points to:

(your imagemagick folder path)/convert.exe
  • use the .exe extension! It won't work, if omitted.
  • use a path without spaces as install path for ImageMagick or use the short name of the path.

Another way to make this work is to add the ImageMagick path to your Windows PATH variable, and simply setting the $wgImageMagickConvertCommand in LocalSettings.php as follows (note that you must still modify Image.php as shown above):

$wgImageMagickConvertCommand = "convert.exe";

Make sure that the Internet Guest Account (Usually IUSR_MACHINENAME) has Read & Execute rights to the ImageMagick bin directory. Without this you might see an PHP shell execution error similar to what happens when it can't find the convert.exe file.

Inkscape

Inkscape can be used as an alternative SVG thumbnailing tool. Here is the download page for Inkscape on Windows. Here are some example settings to enable Inkscape as the SVG thumnailer in the LocalSettings.php file:

# Image Converter
$wgSVGConverter = 'Inkscape';

$wgSVGConverters = array(
	'Inkscape' => '"/Program Files/Inkscape/inkscape.com" -z -w $width -f $input -e $output',
);

# Image converter path
$wgSVGConverterPath = '/Program Files/Inkscape';

Mathematics Support

See Texvc#Windows.