本教程详细阐述了MediaWiki共享数据库表的正确初始化与配置方法，重点解决$wgSharedTables变量的常见配置误区及其在升级过程中的特殊处理要求。我们将介绍如何正确声明共享表，以及在MediaWiki升级时如何临时“清空”该变量，确保共享数据库功能正常运行。
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现有内容合并，确保每个表名都成为顶级元素。
方法二：逐个添加表名
如果您希望逐个添加共享表，或者配置较为简单，可以直接使用数组的[]语法逐一添加。
$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不会尝试处理任何共享表。
注意事项：
- 临时操作： 这仅仅是一个临时步骤。在升级完成后，您必须将$wgSharedTables恢复到其正确的配置（如前文所述），以确保共享数据库功能正常工作。
- 命令行升级： 如果您通过命令行运行php maintenance/update.php进行升级，同样需要遵循此规则。
- 首次安装： 对于全新的MediaWiki安装，通常不需要进行此清空操作，只需按照正确的方法配置$wgSharedTables即可。
总结
正确配置MediaWiki的共享数据库，特别是$wgSharedTables变量，是确保Wiki家族功能正常运行的关键。务必记住以下几点：
- 正确声明表名： 确保每个共享表名都是$wgSharedTables数组的独立元素，避免将多个表名包装在一个子数组中。
- 升级时清空： 在MediaWiki 1.21及更高版本的升级过程中，临时将$wgSharedTables设置为空数组[]，并在升级完成后恢复。
- 运行update.php： 任何数据库结构或共享配置的更改后，都应运行php maintenance/update.php来应用这些更改。
遵循这些指导原则，您将能够更顺利地管理MediaWiki的共享数据库，并避免常见的配置陷阱。
以上就是MediaWiki共享数据库表初始化与$wgSharedTables配置指南的详细内容，更多请关注php中文网其它相关文章！