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