手册:在Windows上运行MediaWiki

This page is a translated version of the page Manual:Running MediaWiki on Windows and the translation is 98% complete.

此页面的内容主要被Manual:Running MediaWiki on Windows Subsystem for Linux 取代。

此页面将为您提供有关使用标准安装方法在Microsoft Windows系统上安装MediaWiki 的信息。对于仅限Windows的托管环境，建议使用WIMP堆栈（使用IIS），而不是1.18版的Apache（WAMP堆栈），以进行手动安装。

Nginx，apache和IIS的替代方案，如果您跨其他主机操作系统支持MediaWiki和/或已经在使用Nginx进行内部托管，则可能很有用。

所需软件

See Manual:安装要求 .

获取所需的软件

虽然这些产品在Windows下配置起来并不困难，但它可能“非常”难以安装（困难到WIMP需要30分钟），并且如果全新的话，一次配置Apache+MySQL+PHP一个产品阿帕奇/MySQL/ PHP。在这种情况下，强烈建议寻找可以安装和使用的LAMP或WAMP预制组合。这些将为您节省99％的手动配置每个包的麻烦。缺点是其中一些被削减或修改版本，这使得单个组件升级变得困难，而其他组件严重过时。

XAMPP

最受欢迎的是XAMPP：

XAMPP

WebPI

Microsoft Web Platform Installer可以为您安装必需的先决条件。參見網誌。

Bitnami

Bitnami是一套免费的开源软件兼容安装程序。它支持Nginx堆栈[1]、Microsoft WAMP [2]、一个通用LAMP堆栈[3]和XAMPP（它不会自行安装，只有XAMPP特定的bitnami安装程序工作[4]）。 Bitnami在其中任何一个上安装MediaWiki，它们与Wordpress或其他软件bitnami支持一起工作。 有关指令[5]和更新的支持数据，请参阅Bitnami本身。 如果您打算仅使用长期稳定支持的mediawiki版本，这可能是一个不错的选择。不保证支持旧版本。

WAMP

参见 http://www.wampserver.com/en/

WIMP

See https://learn.microsoft.com/en-us/iis/application-frameworks/install-and-configure-php-applications-on-iis/mediawiki-on-iis

可选软件

Diffutils

Diffutils（包含diff3）可以从这里下载，File（文件类型检查器）可以从这里下载。

要在MediaWiki中激活diffutils的使用，你必须忽略它们在安装过程中不会被找到的事实（如果你在你的路径中安装了diff，它们实际上可能会被找到）并打开LocalSettings.php进行以下更改：

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

- $wgMimeDetectorCommand = "file.exe -bi"; #use external mime detector (linux)
+ $wgMimeDetectorCommand = "C:/Program Files/GnuWin32/bin/file.exe -bi"; # 使用外部mime探测器

请注意，您必须将“C://Program……”替换为安装工具的实际位置。

ImageMagick

PHP现在默认启用GD，可用于缩略图。 GD不需要使用任何配置或修改。因此，强烈建议“不要”安装ImageMagick，因为它已知不稳定。在MediaWiki中，在LocalSettings.php设置$wgUseImageMagick为false来禁用ImageMagick。

下载Windows上的ImageMagick。要使图像缩略图工作，您需要打开includes/Image.php，找到以$cmd = $wgImageMagickConvertCommand .开头的行，并删除escapeshellarg()函数，然后执行相同操作下一行，以便命令变量构建如下：

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

另外，检查以确保localsettings.php中的$wgImageMagickConvertCommand指向：

(你的imagemagick文件夹路径)/convert.exe

使用.exe扩展名！如果省略，它将无法工作。
使用路径不带空格作为ImageMagick的安装路径或使用路径的短名称。

另一种方法是将ImageMagick路径添加到Windows PATH变量中，只需在LocalSettings.php中设置$wgImageMagickConvertCommand，如下所示（请注意，您仍必须修改Image.php，如上所示））：

$wgImageMagickConvertCommand = "convert.exe";

确保Internet Guest帐户（通常为IUSR MACHINENAME）具有ImageMagick bin目录的读取和执行权限。如果没有这个，您可能会看到一个PHP shell执行错误，类似于找不到convert.exe文件时发生的错误。

Inkscape

Inkscape可以用作替代SVG缩略图工具。下载Windows上的Inkscape。以下是在LocalSettings.php文件中启用Inkscape作为SVG thumnailer的一些示例设置：

# Image Converter
$wgSVGConverter = 'Inkscape';

$wgSVGConverters = array(
	'Inkscape' => '"/Program Files/Inkscape/inkscape.exe" --export-filename $output -w $width $input',
);

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

数学公式支持

参见 Texvc#Windows。