手册:$wgUseInstantCommons

This page is a translated version of the page Manual:$wgUseInstantCommons and the translation is 100% complete.

共享上传: $wgUseInstantCommons
启用即时共享资源，即使用维基共享资源作为共享存储库。
引进版本：	1.16.0（r58652）
移除版本：	仍在使用
允许的值：	(布尔值)
默认值：	`false`
其他设置：按首字母排序 \| 按功能排序

用法

将以下内容添加到LocalSettings.php 以启用InstantCommons：

$wgUseInstantCommons = true;

详情

将此配置参数设置为true可启用即时共享资源，该功能允许本地维基自动使用维基共享资源上托管的图像。

此配置参数的设置是以下对 $wgForeignFileRepos 的设置的简写：

$wgForeignFileRepos[] = [
	'class' => ForeignAPIRepo::class,
	'name' => 'wikimediacommons',
	'apibase' => 'https://commons.wikimedia.org/w/api.php',
	'url' => 'https://upload.wikimedia.org/wikipedia/commons',
	'thumbUrl' => 'https://upload.wikimedia.org/wikipedia/commons/thumb',
	'hashLevels' => 2,
	'transformVia404' => true,
	'fetchDescription' => true,
	'descriptionCacheExpiry' => 43200,
	'apiThumbCacheExpiry' => 0,
];

注释

启用此配置参数并不会避免本地维基所在服务器的磁盘空间被占用。在MediaWiki 1.26之前，此设置确实会在本地磁盘上生成缩略图，用于缓存。如果嵌入本地维基页面上的文件尺寸超过了维基共享资源上原始文件的尺寸，那么该文件将以其原始大小被放置在本地磁盘上。

自 MediaWiki 1.27 (gerrit:251556) 版本起，$wgUseInstantCommons 默认情况下会直接链接维基共享资源上的图像，而不是下载原始文件并在本地生成缩略图。

这使得维基在节省中央处理器和带宽的同时，也减少了页面的首字节时间，即使没有缩略图处理程序也同样有效。这能让你的维基看起来快得多。

例如，如果一个页面上有100张即时共享（InstantCommons）图片，你的维基将在页面加载时向共享资源（Commons）API发出400个API请求，而页面的首字节返回将需要大约30秒。可以通过禁用$wgResponsiveImages 来对此进行一些改进。你可能更倾向于通过创建自己的$wgForeignFileRepos 条目来覆盖默认的descriptionCacheExpiry设置，或者根本不使用外部文件存储库，而是使用importImages.php 从共享资源（Commons）复制图片到你自己的维基。值得注意的是，这与直觉相反，apiThumbCacheExpiry 设置为0时速度最快。另一个对性能有重大影响的方面是元数据缓存的时长。很遗憾，这目前无法配置，并且被硬编码为 3600 秒（1小时），这个时间相当短 [1]

有关调整的配置参数$wgForeignFileRepos，请参见文档。

参见

手册:配置文件上传 - 主要用于本地上传
Manual:$wgForeignFileRepos - 配置多个文件存储库
Extension:QuickInstantCommons