本教程详细阐述了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中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1322255.html
微信扫一扫 
支付宝扫一扫 
