MediaWiki master
WebStart.php
Go to the documentation of this file.
1<?php
14use MediaWiki\Context\RequestContext;
15use MediaWiki\Output\OutputHandler;
16use MediaWiki\Settings\SettingsBuilder;
17use Wikimedia\Http\HttpStatus;
18
19# T17461: Make IE8 turn off content sniffing. Everybody else should ignore this
20# We're adding it here so that it's *always* set, even for alternate entry
21# points and when $wgOut gets disabled or overridden.
22header( 'X-Content-Type-Options: nosniff' );
23
24# Valid web server entry point, enable includes.
25# Please don't move this line to includes/Defines.php. This line essentially
26# defines a valid entry point. If you put it in includes/Defines.php, then
27# any script that includes it becomes an entry point, thereby defeating
28# its purpose.
29define( 'MEDIAWIKI', true );
30
35function wfWebStartNoLocalSettings( SettingsBuilder $settings ): never {
36 # LocalSettings.php is the per-site customization file. If it does not exist
37 # the wiki installer needs to be launched or the generated file uploaded to
38 # the root wiki directory. Give a hint, if it is not readable by the server.
39 require_once __DIR__ . '/Output/NoLocalSettings.php';
40 die();
41}
42
43require_once __DIR__ . '/BootstrapHelperFunctions.php';
44
45// If no LocalSettings file exists, try to display an error page
46// (use a callback because it depends on TemplateParser)
47if ( !defined( 'MW_CONFIG_CALLBACK' ) ) {
48 wfDetectLocalSettingsFile();
49 if ( !is_readable( MW_CONFIG_FILE ) ) {
50 define( 'MW_CONFIG_CALLBACK', 'wfWebStartNoLocalSettings' );
51 }
52}
53
54function wfWebStartSetup( SettingsBuilder $settings ) {
55 // Initialize the default MediaWiki output buffering if no buffer is already active.
56 // This avoids clashes with existing buffers in order to avoid problems,
57 // like mixing gzip and non-gzip output.
58 if ( ob_get_level() == 0 ) {
59 // During HTTP requests, MediaWiki normally buffers the response body in a string
60 // within OutputPage and prints it when ready. PHP buffers provide protection against
61 // premature sending of HTTP headers due to output from PHP warnings and notices.
62 // They also can be used to implement gzip support in PHP without the webserver knowing
63 // which requests yield HTML and which yield large files that can be streamed.
64 ob_start( OutputHandler::handle( ... ) );
65 }
66}
67
68// Custom setup for WebStart entry point
69if ( !defined( 'MW_SETUP_CALLBACK' ) ) {
70 define( 'MW_SETUP_CALLBACK', 'wfWebStartSetup' );
71}
72
73require_once __DIR__ . '/Setup.php';
74
75# Multiple DBs or commits might be used; keep the request as transactional as possible
76if ( isset( $_SERVER['REQUEST_METHOD'] ) && $_SERVER['REQUEST_METHOD'] === 'POST' ) {
77 ignore_user_abort( true );
78}
79
80if ( !defined( 'MW_API' ) && !defined( 'MW_REST_API' ) &&
81 RequestContext::getMain()->getRequest()->getHeader( 'Promise-Non-Write-API-Action' )
82) {
83 header( 'Cache-Control: no-cache' );
84 header( 'Content-Type: text/html; charset=utf-8' );
85 HttpStatus::header( 400 );
86 $errorHtml = wfMessage( 'nonwrite-api-promise-error' )
87 ->useDatabase( false )
88 ->inContentLanguage()
89 ->escaped();
90 $content = <<<HTML
91<!DOCTYPE html>
92<html>
93<head><meta charset="UTF-8" /><meta name="color-scheme" content="light dark" /></head>
94<body>
95$errorHtml
96</body>
97</html>
98
99HTML;
100 header( 'Content-Length: ' . strlen( $content ) );
101 echo $content;
102 die();
103}
wfDetectLocalSettingsFile
wfDetectLocalSettingsFile(?string $installationPath=null)
Decide and remember where to load LocalSettings from.
Definition BootstrapHelperFunctions.php:30
wfMessage
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
Definition GlobalFunctions.php:602
wfWebStartSetup
if(!defined('MW_CONFIG_CALLBACK')) wfWebStartSetup(SettingsBuilder $settings)
Definition WebStart.php:54
if
if(!defined('MW_SETUP_CALLBACK'))
Definition WebStart.php:69
wfWebStartNoLocalSettings
wfWebStartNoLocalSettings(SettingsBuilder $settings)
Definition WebStart.php:35
MediaWiki\Context\RequestContext
Group all the pieces relevant to the context of a request into one instance.
Definition RequestContext.php:51
MediaWiki\Settings\SettingsBuilder
Builder class for constructing a Config object from a set of sources during bootstrap.
Definition SettingsBuilder.php:55