Manual $wgUseInstantCommons

Shared uploads: $wgUseInstantCommons
Enable InstantCommons, i.e. the use of Wikimedia Commons as a shared repository
Introduced in version:	1.16.0 (r58652)
Removed in version:	still in use
Allowed values:	(boolean)
Default value:	false
Other settings: Alphabetical | By function

Usage

InstantCommons를 활성화하기 위해 LocalSettings.php에 다음을 추가하십시오:

$wgUseInstantCommons = true;

Details

이 구성 매개변수를 true로 설정하면 InstantCommons가 활성화되어 Wikimedia Commons에서 호스팅되는 로컬 위키 이미지에서 자동으로 사용할 수 있습니다.

이 구성 매개변수의 설정은 $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,
];

Note

이 구성 매개변수를 활성화해도 로컬 위키를 실행하는 서버에서 디스크 공간의 임의의 사용을 피하는 것은 아닙니다. 미디어위키 1.26까지, 이 설정은 실제로 캐싱 목적으로 로컬 디스크에 썸네일을 생성했습니다. 로컬 위키의 페이지에 파일을 삽입할 때 위키미디어 커먼즈에 있는 원본 파일의 크기를 초과하는 경우에서, 파일은 원래 크기로 로컬 디스크에 저장될 것입니다.

미디어위키 1.27 (gerrit:251556)부터, $wgUseInstantCommons는 원본을 다운로드하고 로컬로 썸네일하는 대신 기본적으로 커먼즈에서 이미지를 핫링크합니다.

이것은 위키에게 썸네일 처리기 없이도 페이지에 대해 첫 번째 바이트까지 시간을 줄이면서 CPU와 대역폭을 절약하는 것을 허용합니다. 이것은 여러분 위키를 훨씬 더 빨라게 만들 수 있습니다. 그러나, 지역적 언어로 표시되는 위키는 대부분 같은 지역에서 접근할 것이므로, 상황에 따라, 실제로는 더 느리게 될 수도 있습니다!

예를 들어, 만약 페이지에 100개의 InstantCommons 이미지가 있으면, 위키는 페이지 로드 시간에서 Commons API에 400개의 API 요청을 하고 페이지의 첫 번째 바이트는 약 30초 동안 반환되지 않을 것입니다. 이것은 $wgResponsiveImages를 비활성화함으로써 어느 정도 개선될 수 있습니다. 고유한 $wgForeignFileRepos 항목을 생성함으로써 기본 descriptionCacheExpiry를 덮어쓰거나, 외부 파일 저장소를 전혀 사용하지 않고 대신 importImages.php를 사용하여 커먼즈에서 자신의 위키로 이미지를 복사하는 것을 선호할 수 있습니다. 반직관적으로, apiThumbCacheExpiry는 0으로 설정되면 가장 빠름을 주목하십시오. 성능에 큰 영향을 미치는 또 다른 측면은 메타데이터가 캐시되는 기간입니다. 불행히도, 이것은 현재 구성할 수 없고 다소 짧은 3600초 (1시간)로 하드 코딩되며 다소 짧습니다 [1]

조정에 대해서는 구성 매개변수 $wgForeignFileRepos 문서를 참조하십시오.

See also

• Manual:Configuring file uploads - 주로 로컬 업로드에 대해
• Manual:$wgForeignFileRepos - 다중 파일 저장소를 구성하기 위해