본문 바로가기
미디어위키

Manual $wgVirtualRestConfig

by 다움위키 2024. 1. 2.
Miscellaneous settings: $wgVirtualRestConfig
REST services configuration
Introduced in version:1.25.0 (Gerrit change 193826; git #13bd0996)
Removed in version:still in use
Allowed values:(array)
Default value:See below
Other settings: Alphabetical | By function

Details

하위-배열 modules에 REST 서비스를 등록하고, 하위-배열 global에서 기본값을 변경합니다.
주요 예제는 Parsoid이며, 미디어위키 1.25 이후로 이 매개변수를 사용하여 구성되어야 합니다 (역시 Extension:VisualEditor도 참조하십시오). 미디어위키 1.25에서 1.26으로 업그레이드할 때, 'prefix' 값은 'domain'으로 변경되어야 합니다 (후자는 원활한 전환을 위해 전자와 같은 값으로 더해질 수 있습니다).
RESTBase는 역시 이 매개변수에 등록될 수 있습니다.
 

Default value

MediaWiki version:
≥ 1.28
$wgVirtualRestConfig = [
	'paths' => [],
	'modules' => [],
	'global' => [
		# Timeout in seconds
		'timeout' => 360,
		# 'domain' is set to $wgCanonicalServer in Setup.php
		'forwardCookies' => false,
		'HTTPProxy' => null
	]
];
MediaWiki versions:
1.26 – 1.27
$wgVirtualRestConfig = [
	'modules' => [],
	'global' => [
		# Timeout in seconds
		'timeout' => 360,
		# 'domain' is set to $wgCanonicalServer in Setup.php
		'forwardCookies' => false,
		'HTTPProxy' => null
	]
];
MediaWiki version:
1.25
$wgVirtualRestConfig = array(
	'modules' => array(),
	'global' => array(
		# Timeout in seconds
		'timeout' => 360,
		'forwardCookies' => false,
		'HTTPProxy' => null
	)
);

Parsoid

이것들이 Parsoid가 REST 서비스로 등록될 때 기본값이며, 일부 키가 정의되지 않을 때 사용됩니다.

$wgVirtualRestConfig['modules']['parsoid'] = [
	// Parsoid 인스턴스에 대한 URL – 데비안 패키지를 사용하면 포트 8142 사용 – 매개변수 'URL'이 처음 사용되었지만 이제 더 이상 사용되지 않습니다 (문자열).
	'url' => 'http://localhost:8000/',
	// Parsoid "domain" (문자열, 옵션) - 미디어위키 >= 1.26
	'domain' => 'localhost',
	// Parsoid "prefix" (문자열, 옵션) - 미디어위키 1.26부터 사용하지 않음, 'domain'을 사용
	'prefix' => 'localhost',
	// 개인 위키의 경우에서 쿠키 전달 (문자열 또는 false, 옵션)
	'forwardCookies' => false,
	// 요청 시간 초과 (정수 또는 null, 옵션)
	'timeout' => null,
	// Parsoid HTTP proxy (문자열 또는 null, 옵션)
	'HTTPProxy' => null,
	// RESTBase에서 의미된 것처럼 URL을 구문 분석할지 여부 (부울 또는 null, 옵션)
	'restbaseCompat' => null,
];

RESTBase

이것들이 RESTBase 서비스가 등록될 때 기본값이며, 일부 키가 정의되어 있지 않을 때 사용됩니다.

$wgVirtualRestConfig['modules']['restbase'] = [
	// RESTBase 서버 URL (문자열)
	'url' => 'http://localhost:7231/',
	// 사용할 위키 도메인 (문자열)
	'domain' => 'localhost',
	// 요청 시간 초과 (정수 또는 null, 옵션)
	'timeout' => 100,
	// RESTBase/Parsoid로 전달할 쿠키 (문자열 또는 false, 옵션)
	'forwardCookies' => false,
	// 사용할 HTTP proxy (문자열 또는 null, 옵션)
	'HTTPProxy' => null,
	// Parsoid에 대해 의미된 것처럼 URL을 구문 분석할지 여부 (부울, 옵션)
	'parsoidCompat' => false,
	// URL에 도메인을 덧붙일지 여부
	'fixedUrl' => false,
];

Proxying

원격 RESTBase 설치를 사용하기 위해 (예를 들어, 서비스를 설치하지 않고 확장을 테스트하기 위해), 다음과 같은 설정을 사용할 수 있습니다:

foreach ( $wgVirtualRestConfig['modules'] as &$module ) {
        $module['url'] = 'https://en.wikipedia.org/api/rest_v1/';
        $module['forwardCookies'] = false;
}
$wgVirtualRestConfig['modules']['restbase']['fixedUrl'] = true;

See also