MediaWiki共享数据库表初始化与$wgSharedTables配置指南

MediaWiki共享数据库机制概述

mediawiki允许通过共享数据库在多个wiki实例之间共享某些核心数据表，例如用户（user）、用户组（user_groups）和参与者（actor）等。这对于管理一系列相关wiki（即“wiki家族”）的用户账户非常有用，可以避免用户在每个wiki上都注册一次。

要实现这一功能，需要配置以下关键变量：

• $wgSharedDB: 指定共享数据库的名称。
• $wgSharedPrefix: 指定共享表中使用的前缀（如果与主Wiki表前缀不同）。
• $wgSharedTables: 一个数组，列出所有需要共享的表名。

然而，在初始化或升级过程中，$wgSharedTables的配置方式常常引发问题，导致共享表无法正确创建或更新。

$wgSharedTables的正确配置方法

配置$wgSharedTables的关键在于确保每个共享表名都是数组的一个独立元素，而不是将多个表名作为一个子数组添加到$wgSharedTables中。

错误的配置示例：

$wgSharedDB = 'wiki_shared';
$wgSharedTables[] = array('user','user_groups','actor'); // 错误：将一个数组添加为单个元素
$wgSharedPrefix = '';

上述代码会导致$wgSharedTables被错误地解析为一个包含一个子数组的数组，MediaWiki将无法识别其中的表名，从而导致共享表无法创建。

正确的配置方法：

以下是两种推荐的正确配置$wgSharedTables的方式：

方法一：使用array_merge()合并数组

当您需要将一组共享表添加到现有$wgSharedTables配置中时，或者一次性定义所有共享表时，array_merge()是一个清晰且健壮的选择。

// 假设 $wgSharedTables 可能已经有其他默认值或配置
$wgSharedTables = array_merge( $wgSharedTables, [ 'user', 'user_groups', 'actor' ] );

这种方法将一个包含所有共享表名的新数组与$wgSharedTables现有内容合并，确保每个表名都成为顶级元素。

方法二：逐个添加表名

如果您希望逐个添加共享表，或者配置较为简单，可以直接使用数组的[]语法逐一添加。

爱图表

AI驱动的智能化图表创作平台

99

查看详情

$wgSharedTables[] = 'user';
$wgSharedTables[] = 'user_groups';
$wgSharedTables[] = 'actor';

这种方式直观明了，同样能确保每个表名作为$wgSharedTables数组的独立元素。

完整配置示例：

// LocalSettings.php
// 启用共享数据库功能
$wgSharedDB = 'wiki_shared'; // 共享数据库的名称
$wgSharedPrefix = '';        // 共享表的前缀，如果与主Wiki表前缀相同则留空

// 正确配置需要共享的表
$wgSharedTables = []; // 先清空，确保从零开始配置
$wgSharedTables[] = 'user';
$wgSharedTables[] = 'user_groups';
$wgSharedTables[] = 'actor';
// 根据需要添加其他共享表，例如：
// $wgSharedTables[] = 'user_newtalk';
// $wgSharedTables[] = 'user_properties';

MediaWiki升级时的特殊处理：清空$wgSharedTables

MediaWiki官方文档指出，从MediaWiki 1.21版本开始，在通过Web安装程序进行升级时，必须临时清空$wgSharedTables变量。这是因为在升级过程中，如果$wgSharedTables被设置，升级程序可能会跳过对共享表和非共享表的更新，导致升级失败或数据库不一致。

何时清空： 在执行MediaWiki升级脚本（例如通过Web升级界面或命令行运行update.php）之前，您需要临时修改LocalSettings.php文件。

如何清空：

将LocalSettings.php中关于$wgSharedTables的配置暂时修改为：

$wgSharedTables = []; // 临时清空共享表配置

这将确保在升级过程中，MediaWiki不会尝试处理任何共享表。

注意事项：

1. 临时操作： 这仅仅是一个临时步骤。在升级完成后，您必须将$wgSharedTables恢复到其正确的配置（如前文所述），以确保共享数据库功能正常工作。
2. 命令行升级： 如果您通过命令行运行php maintenance/update.php进行升级，同样需要遵循此规则。
3. 首次安装： 对于全新的MediaWiki安装，通常不需要进行此清空操作，只需按照正确的方法配置$wgSharedTables即可。

总结

正确配置MediaWiki的共享数据库，特别是$wgSharedTables变量，是确保Wiki家族功能正常运行的关键。务必记住以下几点：

• 正确声明表名： 确保每个共享表名都是$wgSharedTables数组的独立元素，避免将多个表名包装在一个子数组中。
• 升级时清空： 在MediaWiki 1.21及更高版本的升级过程中，临时将$wgSharedTables设置为空数组[]，并在升级完成后恢复。
• 运行update.php： 任何数据库结构或共享配置的更改后，都应运行php maintenance/update.php来应用这些更改。

遵循这些指导原则，您将能够更顺利地管理MediaWiki的共享数据库，并避免常见的配置陷阱。

以上就是MediaWiki共享数据库表初始化与$wgSharedTables配置指南的详细内容，更多请关注php中文网其它相关文章！