本教程详细阐述了在MediaWiki多站点环境下，如何正确配置共享数据库表（$wgSharedTables），以实现用户、用户组等数据的共享。文章不仅纠正了常见的配置错误，还特别强调了在MediaWiki 1.21及更高版本升级过程中，为确保共享表正确处理，需要临时清空$wgSharedTables配置的必要步骤和方法，确保数据库初始化与升级的顺利进行。
MediaWiki 共享数据库表配置详解
在构建mediawiki家族（即多个wiki站点共享用户账户等数据）时，共享数据库是一个核心概念。它允许不同的wiki实例访问同一个用户表、用户组表等，从而提供统一的用户体验。mediawiki通过几个关键的配置变量来实现这一功能：$wgshareddb、$wgsharedtables 和 $wgsharedprefix。
$wgSharedDB: 指定共享数据库的名称。所有共享的表都将存储在这个数据库中。$wgSharedTables: 一个数组，列出所有需要共享的表名。例如，user、user_groups、actor 等。$wgSharedPrefix: 共享表中使用的前缀。如果共享表没有特定的前缀，则可以将其设置为空字符串。
正确配置 $wgSharedTables
许多用户在配置 $wgSharedTables 时常犯一个错误，即将一个包含多个表名的数组作为单个元素添加到 $wgSharedTables 数组中，导致配置未能正确识别各个共享表。例如，以下配置是不正确的：
// 错误示例：将一个数组作为单个元素添加到 $wgSharedTables 中$wgSharedTables[] = array('user','user_groups','actor');
这种写法会使得 $wgSharedTables 变成一个包含一个子数组的数组，而不是一个包含多个表名字符串的数组。正确的做法是确保 $wgSharedTables 直接包含表名字符串。以下是两种推荐的正确配置方式：
使用 array_merge() 合并表名：这种方法特别适用于在已有 $wgSharedTables 配置的基础上添加新的共享表。
// 正确示例1：使用 array_merge()$wgSharedDB = 'wiki_shared';$wgSharedTables = array_merge( $wgSharedTables, ['user','user_groups','actor'] );$wgSharedPrefix = '';
逐个添加表名：如果 $wgSharedTables 尚未初始化，或者你希望清晰地列出每个共享表，可以逐个添加。
// 正确示例2：逐个添加表名$wgSharedDB = 'wiki_shared';$wgSharedTables[] = 'user';$wgSharedTables[] = 'user_groups';$wgSharedTables[] = 'actor';$wgSharedPrefix = '';
请确保这些配置行放置在 LocalSettings.php 文件中适当的位置。
MediaWiki 升级时的特殊处理：清空 $wgSharedTables
自 MediaWiki 1.21 版本起，在通过 Web 安装器进行升级时，有一个重要的注意事项：必须临时清空 $wgSharedTables 配置。如果不清空，Web 安装器将不会触及任何共享表（无论是带有 $wgSharedPrefix 的表还是带有 $wgDBprefix 的表），这可能导致升级失败或共享表未被正确更新。
为什么需要清空？
Web 安装器在执行升级操作时，需要确保所有相关的数据库表都能够被检查和更新。当 $wgSharedTables 被配置时，安装器会假设这些表已经存在并被正确管理，从而可能跳过对它们的检查和创建/更新操作。临时清空此配置，可以强制安装器将所有表（包括那些最终会共享的表）视为当前Wiki实例的本地表进行处理，确保它们被正确地创建或升级。
如何临时清空 $wgSharedTables？
清空 $wgSharedTables 的方法非常简单，只需将其设置为空数组即可：
// 在升级期间，临时清空 $wgSharedTables$wgSharedTables = [];
操作步骤：
备份： 在进行任何升级操作前，务必完整备份你的MediaWiki文件和数据库。修改 LocalSettings.php： 在运行升级脚本或访问 Web 安装器之前，找到 LocalSettings.php 文件中关于 $wgSharedTables 的配置行，并将其修改为 $wgSharedTables = [];。执行升级： 运行 MediaWiki 的升级脚本 (php maintenance/update.php) 或通过浏览器访问 Web 安装器完成升级过程。恢复配置： 升级完成后，将 LocalSettings.php 中 $wgSharedTables 的配置恢复到其原始的、正确的共享表列表。
重要提示： 这种清空操作是临时性的，仅在升级过程中需要。升级完成后，必须恢复正确的 $wgSharedTables 配置，以确保共享功能正常工作。
总结
正确配置 MediaWiki 共享数据库表是构建高效多站点环境的关键。请务必使用 array_merge() 或逐个添加的方式正确定义 $wgSharedTables。同时，在进行 MediaWiki 1.21 及更高版本的升级时，切记要临时清空 $wgSharedTables 配置，以确保所有数据库表都能被安装器正确处理，避免升级失败。遵循这些步骤将有助于你顺利地管理 MediaWiki 共享数据库环境。
以上就是MediaWiki 共享数据库表配置与升级指南的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1322259.html
微信扫一扫 
支付宝扫一扫 
