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;