Merge "Localisation updates from https://translatewiki.net."
[mediawiki.git] / includes / installer / WebInstallerPage.php
blob3b3473b06dc79af439482315da67c1c7a213944f
1 <?php
2 /**
3 * Base code for web installer pages.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
20 * @file
21 * @ingroup Deployment
24 /**
25 * Abstract class to define pages for the web installer.
27 * @ingroup Deployment
28 * @since 1.17
30 abstract class WebInstallerPage {
32 /**
33 * The WebInstaller object this WebInstallerPage belongs to.
35 * @var WebInstaller
37 public $parent;
39 /**
40 * @return string
42 abstract public function execute();
44 /**
45 * @param WebInstaller $parent
47 public function __construct( WebInstaller $parent ) {
48 $this->parent = $parent;
51 /**
52 * Is this a slow-running page in the installer? If so, WebInstaller will
53 * set_time_limit(0) before calling execute(). Right now this only applies
54 * to Install and Upgrade pages
56 * @return bool Always false in this default implementation.
58 public function isSlow() {
59 return false;
62 /**
63 * @param string $html
65 public function addHTML( $html ) {
66 $this->parent->output->addHTML( $html );
69 public function startForm() {
70 $this->addHTML(
71 "<div class=\"config-section\">\n" .
72 Html::openElement(
73 'form',
74 array(
75 'method' => 'post',
76 'action' => $this->parent->getUrl( array( 'page' => $this->getName() ) )
78 ) . "\n"
82 /**
83 * @param string|bool $continue
84 * @param string|bool $back
86 public function endForm( $continue = 'continue', $back = 'back' ) {
87 $s = "<div class=\"config-submit\">\n";
88 $id = $this->getId();
90 if ( $id === false ) {
91 $s .= Html::hidden( 'lastPage', $this->parent->request->getVal( 'lastPage' ) );
94 if ( $continue ) {
95 // Fake submit button for enter keypress (bug 26267)
96 // Messages: config-continue, config-restart, config-regenerate
97 $s .= Xml::submitButton(
98 wfMessage( "config-$continue" )->text(),
99 array(
100 'name' => "enter-$continue",
101 'style' => 'visibility:hidden;overflow:hidden;width:1px;margin:0'
103 ) . "\n";
106 if ( $back ) {
107 // Message: config-back
108 $s .= Xml::submitButton(
109 wfMessage( "config-$back" )->text(),
110 array(
111 'name' => "submit-$back",
112 'tabindex' => $this->parent->nextTabIndex()
114 ) . "\n";
117 if ( $continue ) {
118 // Messages: config-continue, config-restart, config-regenerate
119 $s .= Xml::submitButton(
120 wfMessage( "config-$continue" )->text(),
121 array(
122 'name' => "submit-$continue",
123 'tabindex' => $this->parent->nextTabIndex(),
125 ) . "\n";
128 $s .= "</div></form></div>\n";
129 $this->addHTML( $s );
133 * @return string
135 public function getName() {
136 return str_replace( 'WebInstaller_', '', get_class( $this ) );
140 * @return string
142 protected function getId() {
143 return array_search( $this->getName(), $this->parent->pageSequence );
147 * @param string $var
149 * @return mixed
151 public function getVar( $var ) {
152 return $this->parent->getVar( $var );
156 * @param string $name
157 * @param mixed $value
159 public function setVar( $name, $value ) {
160 $this->parent->setVar( $name, $value );
164 * Get the starting tags of a fieldset.
166 * @param string $legend message name
168 * @return string
170 protected function getFieldsetStart( $legend ) {
171 return "\n<fieldset><legend>" . wfMessage( $legend )->escaped() . "</legend>\n";
175 * Get the end tag of a fieldset.
177 * @return string
179 protected function getFieldsetEnd() {
180 return "</fieldset>\n";
184 * Opens a textarea used to display the progress of a long operation
186 protected function startLiveBox() {
187 $this->addHTML(
188 '<div id="config-spinner" style="display:none;">' .
189 '<img src="../skins/common/images/ajax-loader.gif" /></div>' .
190 '<script>jQuery( "#config-spinner" ).show();</script>' .
191 '<div id="config-live-log">' .
192 '<textarea name="LiveLog" rows="10" cols="30" readonly="readonly">'
194 $this->parent->output->flush();
198 * Opposite to WebInstallerPage::startLiveBox
200 protected function endLiveBox() {
201 $this->addHTML( '</textarea></div>
202 <script>jQuery( "#config-spinner" ).hide()</script>' );
203 $this->parent->output->flush();
208 class WebInstaller_Language extends WebInstallerPage {
211 * @return string|null
213 public function execute() {
214 global $wgLang;
215 $r = $this->parent->request;
216 $userLang = $r->getVal( 'uselang' );
217 $contLang = $r->getVal( 'ContLang' );
219 $languages = Language::fetchLanguageNames();
220 $lifetime = intval( ini_get( 'session.gc_maxlifetime' ) );
221 if ( !$lifetime ) {
222 $lifetime = 1440; // PHP default
225 if ( $r->wasPosted() ) {
226 # Do session test
227 if ( $this->parent->getSession( 'test' ) === null ) {
228 $requestTime = $r->getVal( 'LanguageRequestTime' );
229 if ( !$requestTime ) {
230 // The most likely explanation is that the user was knocked back
231 // from another page on POST due to session expiry
232 $msg = 'config-session-expired';
233 } elseif ( time() - $requestTime > $lifetime ) {
234 $msg = 'config-session-expired';
235 } else {
236 $msg = 'config-no-session';
238 $this->parent->showError( $msg, $wgLang->formatTimePeriod( $lifetime ) );
239 } else {
240 if ( isset( $languages[$userLang] ) ) {
241 $this->setVar( '_UserLang', $userLang );
243 if ( isset( $languages[$contLang] ) ) {
244 $this->setVar( 'wgLanguageCode', $contLang );
247 return 'continue';
249 } elseif ( $this->parent->showSessionWarning ) {
250 # The user was knocked back from another page to the start
251 # This probably indicates a session expiry
252 $this->parent->showError( 'config-session-expired',
253 $wgLang->formatTimePeriod( $lifetime ) );
256 $this->parent->setSession( 'test', true );
258 if ( !isset( $languages[$userLang] ) ) {
259 $userLang = $this->getVar( '_UserLang', 'en' );
261 if ( !isset( $languages[$contLang] ) ) {
262 $contLang = $this->getVar( 'wgLanguageCode', 'en' );
264 $this->startForm();
265 $s = Html::hidden( 'LanguageRequestTime', time() ) .
266 $this->getLanguageSelector( 'uselang', 'config-your-language', $userLang,
267 $this->parent->getHelpBox( 'config-your-language-help' ) ) .
268 $this->getLanguageSelector( 'ContLang', 'config-wiki-language', $contLang,
269 $this->parent->getHelpBox( 'config-wiki-language-help' ) );
270 $this->addHTML( $s );
271 $this->endForm( 'continue', false );
273 return null;
277 * Get a "<select>" for selecting languages.
279 * @param string $name
280 * @param string $label
281 * @param string $selectedCode
282 * @param string $helpHtml
284 * @return string
286 public function getLanguageSelector( $name, $label, $selectedCode, $helpHtml = '' ) {
287 global $wgDummyLanguageCodes;
289 $s = $helpHtml;
291 $s .= Html::openElement( 'select', array( 'id' => $name, 'name' => $name,
292 'tabindex' => $this->parent->nextTabIndex() ) ) . "\n";
294 $languages = Language::fetchLanguageNames();
295 ksort( $languages );
296 foreach ( $languages as $code => $lang ) {
297 if ( isset( $wgDummyLanguageCodes[$code] ) ) {
298 continue;
300 $s .= "\n" . Xml::option( "$code - $lang", $code, $code == $selectedCode );
302 $s .= "\n</select>\n";
304 return $this->parent->label( $label, $name, $s );
309 class WebInstaller_ExistingWiki extends WebInstallerPage {
312 * @return string
314 public function execute() {
315 // If there is no LocalSettings.php, continue to the installer welcome page
316 $vars = Installer::getExistingLocalSettings();
317 if ( !$vars ) {
318 return 'skip';
321 // Check if the upgrade key supplied to the user has appeared in LocalSettings.php
322 if ( $vars['wgUpgradeKey'] !== false
323 && $this->getVar( '_UpgradeKeySupplied' )
324 && $this->getVar( 'wgUpgradeKey' ) === $vars['wgUpgradeKey']
326 // It's there, so the user is authorized
327 $status = $this->handleExistingUpgrade( $vars );
328 if ( $status->isOK() ) {
329 return 'skip';
330 } else {
331 $this->startForm();
332 $this->parent->showStatusBox( $status );
333 $this->endForm( 'continue' );
335 return 'output';
339 // If there is no $wgUpgradeKey, tell the user to add one to LocalSettings.php
340 if ( $vars['wgUpgradeKey'] === false ) {
341 if ( $this->getVar( 'wgUpgradeKey', false ) === false ) {
342 $secretKey = $this->getVar( 'wgSecretKey' ); // preserve $wgSecretKey
343 $this->parent->generateKeys();
344 $this->setVar( 'wgSecretKey', $secretKey );
345 $this->setVar( '_UpgradeKeySupplied', true );
347 $this->startForm();
348 $this->addHTML( $this->parent->getInfoBox(
349 wfMessage( 'config-upgrade-key-missing', "<pre dir=\"ltr\">\$wgUpgradeKey = '" .
350 $this->getVar( 'wgUpgradeKey' ) . "';</pre>" )->plain()
351 ) );
352 $this->endForm( 'continue' );
354 return 'output';
357 // If there is an upgrade key, but it wasn't supplied, prompt the user to enter it
359 $r = $this->parent->request;
360 if ( $r->wasPosted() ) {
361 $key = $r->getText( 'config_wgUpgradeKey' );
362 if ( !$key || $key !== $vars['wgUpgradeKey'] ) {
363 $this->parent->showError( 'config-localsettings-badkey' );
364 $this->showKeyForm();
366 return 'output';
368 // Key was OK
369 $status = $this->handleExistingUpgrade( $vars );
370 if ( $status->isOK() ) {
371 return 'continue';
372 } else {
373 $this->parent->showStatusBox( $status );
374 $this->showKeyForm();
376 return 'output';
378 } else {
379 $this->showKeyForm();
381 return 'output';
386 * Show the "enter key" form
388 protected function showKeyForm() {
389 $this->startForm();
390 $this->addHTML(
391 $this->parent->getInfoBox( wfMessage( 'config-localsettings-upgrade' )->plain() ) .
392 '<br />' .
393 $this->parent->getTextBox( array(
394 'var' => 'wgUpgradeKey',
395 'label' => 'config-localsettings-key',
396 'attribs' => array( 'autocomplete' => 'off' ),
399 $this->endForm( 'continue' );
403 * @param string[] $names
404 * @param mixed[] $vars
406 * @return Status
408 protected function importVariables( $names, $vars ) {
409 $status = Status::newGood();
410 foreach ( $names as $name ) {
411 if ( !isset( $vars[$name] ) ) {
412 $status->fatal( 'config-localsettings-incomplete', $name );
414 $this->setVar( $name, $vars[$name] );
417 return $status;
421 * Initiate an upgrade of the existing database
423 * @param mixed[] $vars Variables from LocalSettings.php
425 * @return Status
427 protected function handleExistingUpgrade( $vars ) {
428 // Check $wgDBtype
429 if ( !isset( $vars['wgDBtype'] ) ||
430 !in_array( $vars['wgDBtype'], Installer::getDBTypes() )
432 return Status::newFatal( 'config-localsettings-connection-error', '' );
435 // Set the relevant variables from LocalSettings.php
436 $requiredVars = array( 'wgDBtype' );
437 $status = $this->importVariables( $requiredVars, $vars );
438 $installer = $this->parent->getDBInstaller();
439 $status->merge( $this->importVariables( $installer->getGlobalNames(), $vars ) );
440 if ( !$status->isOK() ) {
441 return $status;
444 if ( isset( $vars['wgDBadminuser'] ) ) {
445 $this->setVar( '_InstallUser', $vars['wgDBadminuser'] );
446 } else {
447 $this->setVar( '_InstallUser', $vars['wgDBuser'] );
449 if ( isset( $vars['wgDBadminpassword'] ) ) {
450 $this->setVar( '_InstallPassword', $vars['wgDBadminpassword'] );
451 } else {
452 $this->setVar( '_InstallPassword', $vars['wgDBpassword'] );
455 // Test the database connection
456 $status = $installer->getConnection();
457 if ( !$status->isOK() ) {
458 // Adjust the error message to explain things correctly
459 $status->replaceMessage( 'config-connection-error',
460 'config-localsettings-connection-error' );
462 return $status;
465 // All good
466 $this->setVar( '_ExistingDBSettings', true );
468 return $status;
473 class WebInstaller_Welcome extends WebInstallerPage {
476 * @return string
478 public function execute() {
479 if ( $this->parent->request->wasPosted() ) {
480 if ( $this->getVar( '_Environment' ) ) {
481 return 'continue';
484 $this->parent->output->addWikiText( wfMessage( 'config-welcome' )->plain() );
485 $status = $this->parent->doEnvironmentChecks();
486 if ( $status->isGood() ) {
487 $this->parent->output->addHTML( '<span class="success-message">' .
488 wfMessage( 'config-env-good' )->escaped() . '</span>' );
489 $this->parent->output->addWikiText( wfMessage( 'config-copyright',
490 SpecialVersion::getCopyrightAndAuthorList() )->plain() );
491 $this->startForm();
492 $this->endForm();
493 } else {
494 $this->parent->showStatusMessage( $status );
497 return '';
502 class WebInstaller_DBConnect extends WebInstallerPage {
505 * @return string|null When string, "skip" or "continue"
507 public function execute() {
508 if ( $this->getVar( '_ExistingDBSettings' ) ) {
509 return 'skip';
512 $r = $this->parent->request;
513 if ( $r->wasPosted() ) {
514 $status = $this->submit();
516 if ( $status->isGood() ) {
517 $this->setVar( '_UpgradeDone', false );
519 return 'continue';
520 } else {
521 $this->parent->showStatusBox( $status );
525 $this->startForm();
527 $types = "<ul class=\"config-settings-block\">\n";
528 $settings = '';
529 $defaultType = $this->getVar( 'wgDBtype' );
531 // Messages: config-dbsupport-mysql, config-dbsupport-postgres, config-dbsupport-oracle,
532 // config-dbsupport-sqlite, config-dbsupport-mssql
533 $dbSupport = '';
534 foreach ( Installer::getDBTypes() as $type ) {
535 $dbSupport .= wfMessage( "config-dbsupport-$type" )->plain() . "\n";
537 $this->addHTML( $this->parent->getInfoBox(
538 wfMessage( 'config-support-info', trim( $dbSupport ) )->text() ) );
540 // It's possible that the library for the default DB type is not compiled in.
541 // In that case, instead select the first supported DB type in the list.
542 $compiledDBs = $this->parent->getCompiledDBs();
543 if ( !in_array( $defaultType, $compiledDBs ) ) {
544 $defaultType = $compiledDBs[0];
547 foreach ( $compiledDBs as $type ) {
548 $installer = $this->parent->getDBInstaller( $type );
549 $types .=
550 '<li>' .
551 Xml::radioLabel(
552 $installer->getReadableName(),
553 'DBType',
554 $type,
555 "DBType_$type",
556 $type == $defaultType,
557 array( 'class' => 'dbRadio', 'rel' => "DB_wrapper_$type" )
559 "</li>\n";
561 // Messages: config-header-mysql, config-header-postgres, config-header-oracle,
562 // config-header-sqlite
563 $settings .= Html::openElement(
564 'div',
565 array(
566 'id' => 'DB_wrapper_' . $type,
567 'class' => 'dbWrapper'
570 Html::element( 'h3', array(), wfMessage( 'config-header-' . $type )->text() ) .
571 $installer->getConnectForm() .
572 "</div>\n";
575 $types .= "</ul><br style=\"clear: left\"/>\n";
577 $this->addHTML( $this->parent->label( 'config-db-type', false, $types ) . $settings );
578 $this->endForm();
580 return null;
584 * @return Status
586 public function submit() {
587 $r = $this->parent->request;
588 $type = $r->getVal( 'DBType' );
589 if ( !$type ) {
590 return Status::newFatal( 'config-invalid-db-type' );
592 $this->setVar( 'wgDBtype', $type );
593 $installer = $this->parent->getDBInstaller( $type );
594 if ( !$installer ) {
595 return Status::newFatal( 'config-invalid-db-type' );
598 return $installer->submitConnectForm();
603 class WebInstaller_Upgrade extends WebInstallerPage {
606 * @return bool Always true.
608 public function isSlow() {
609 return true;
613 * @return string|null
615 public function execute() {
616 if ( $this->getVar( '_UpgradeDone' ) ) {
617 // Allow regeneration of LocalSettings.php, unless we are working
618 // from a pre-existing LocalSettings.php file and we want to avoid
619 // leaking its contents
620 if ( $this->parent->request->wasPosted() && !$this->getVar( '_ExistingDBSettings' ) ) {
621 // Done message acknowledged
622 return 'continue';
623 } else {
624 // Back button click
625 // Show the done message again
626 // Make them click back again if they want to do the upgrade again
627 $this->showDoneMessage();
629 return 'output';
633 // wgDBtype is generally valid here because otherwise the previous page
634 // (connect) wouldn't have declared its happiness
635 $type = $this->getVar( 'wgDBtype' );
636 $installer = $this->parent->getDBInstaller( $type );
638 if ( !$installer->needsUpgrade() ) {
639 return 'skip';
642 if ( $this->parent->request->wasPosted() ) {
643 $installer->preUpgrade();
645 $this->startLiveBox();
646 $result = $installer->doUpgrade();
647 $this->endLiveBox();
649 if ( $result ) {
650 // If they're going to possibly regenerate LocalSettings, we
651 // need to create the upgrade/secret keys. Bug 26481
652 if ( !$this->getVar( '_ExistingDBSettings' ) ) {
653 $this->parent->generateKeys();
655 $this->setVar( '_UpgradeDone', true );
656 $this->showDoneMessage();
658 return 'output';
662 $this->startForm();
663 $this->addHTML( $this->parent->getInfoBox(
664 wfMessage( 'config-can-upgrade', $GLOBALS['wgVersion'] )->plain() ) );
665 $this->endForm();
667 return null;
670 public function showDoneMessage() {
671 $this->startForm();
672 $regenerate = !$this->getVar( '_ExistingDBSettings' );
673 if ( $regenerate ) {
674 $msg = 'config-upgrade-done';
675 } else {
676 $msg = 'config-upgrade-done-no-regenerate';
678 $this->parent->disableLinkPopups();
679 $this->addHTML(
680 $this->parent->getInfoBox(
681 wfMessage( $msg,
682 $this->getVar( 'wgServer' ) .
683 $this->getVar( 'wgScriptPath' ) . '/index' .
684 $this->getVar( 'wgScriptExtension' )
685 )->plain(), 'tick-32.png'
688 $this->parent->restoreLinkPopups();
689 $this->endForm( $regenerate ? 'regenerate' : false, false );
694 class WebInstaller_DBSettings extends WebInstallerPage {
697 * @return string|null
699 public function execute() {
700 $installer = $this->parent->getDBInstaller( $this->getVar( 'wgDBtype' ) );
702 $r = $this->parent->request;
703 if ( $r->wasPosted() ) {
704 $status = $installer->submitSettingsForm();
705 if ( $status === false ) {
706 return 'skip';
707 } elseif ( $status->isGood() ) {
708 return 'continue';
709 } else {
710 $this->parent->showStatusBox( $status );
714 $form = $installer->getSettingsForm();
715 if ( $form === false ) {
716 return 'skip';
719 $this->startForm();
720 $this->addHTML( $form );
721 $this->endForm();
723 return null;
728 class WebInstaller_Name extends WebInstallerPage {
731 * @return string
733 public function execute() {
734 $r = $this->parent->request;
735 if ( $r->wasPosted() ) {
736 if ( $this->submit() ) {
737 return 'continue';
741 $this->startForm();
743 // Encourage people to not name their site 'MediaWiki' by blanking the
744 // field. I think that was the intent with the original $GLOBALS['wgSitename']
745 // but these two always were the same so had the effect of making the
746 // installer forget $wgSitename when navigating back to this page.
747 if ( $this->getVar( 'wgSitename' ) == 'MediaWiki' ) {
748 $this->setVar( 'wgSitename', '' );
751 // Set wgMetaNamespace to something valid before we show the form.
752 // $wgMetaNamespace defaults to $wgSiteName which is 'MediaWiki'
753 $metaNS = $this->getVar( 'wgMetaNamespace' );
754 $this->setVar(
755 'wgMetaNamespace',
756 wfMessage( 'config-ns-other-default' )->inContentLanguage()->text()
759 $this->addHTML(
760 $this->parent->getTextBox( array(
761 'var' => 'wgSitename',
762 'label' => 'config-site-name',
763 'help' => $this->parent->getHelpBox( 'config-site-name-help' )
764 ) ) .
765 // getRadioSet() builds a set of labeled radio buttons.
766 // For grep: The following messages are used as the item labels:
767 // config-ns-site-name, config-ns-generic, config-ns-other
768 $this->parent->getRadioSet( array(
769 'var' => '_NamespaceType',
770 'label' => 'config-project-namespace',
771 'itemLabelPrefix' => 'config-ns-',
772 'values' => array( 'site-name', 'generic', 'other' ),
773 'commonAttribs' => array( 'class' => 'enableForOther',
774 'rel' => 'config_wgMetaNamespace' ),
775 'help' => $this->parent->getHelpBox( 'config-project-namespace-help' )
776 ) ) .
777 $this->parent->getTextBox( array(
778 'var' => 'wgMetaNamespace',
779 'label' => '', // @todo Needs a label?
780 'attribs' => array( 'readonly' => 'readonly', 'class' => 'enabledByOther' )
781 ) ) .
782 $this->getFieldSetStart( 'config-admin-box' ) .
783 $this->parent->getTextBox( array(
784 'var' => '_AdminName',
785 'label' => 'config-admin-name',
786 'help' => $this->parent->getHelpBox( 'config-admin-help' )
787 ) ) .
788 $this->parent->getPasswordBox( array(
789 'var' => '_AdminPassword',
790 'label' => 'config-admin-password',
791 ) ) .
792 $this->parent->getPasswordBox( array(
793 'var' => '_AdminPassword2',
794 'label' => 'config-admin-password-confirm'
795 ) ) .
796 $this->parent->getTextBox( array(
797 'var' => '_AdminEmail',
798 'label' => 'config-admin-email',
799 'help' => $this->parent->getHelpBox( 'config-admin-email-help' )
800 ) ) .
801 $this->parent->getCheckBox( array(
802 'var' => '_Subscribe',
803 'label' => 'config-subscribe',
804 'help' => $this->parent->getHelpBox( 'config-subscribe-help' )
805 ) ) .
806 $this->getFieldSetEnd() .
807 $this->parent->getInfoBox( wfMessage( 'config-almost-done' )->text() ) .
808 // getRadioSet() builds a set of labeled radio buttons.
809 // For grep: The following messages are used as the item labels:
810 // config-optional-continue, config-optional-skip
811 $this->parent->getRadioSet( array(
812 'var' => '_SkipOptional',
813 'itemLabelPrefix' => 'config-optional-',
814 'values' => array( 'continue', 'skip' )
818 // Restore the default value
819 $this->setVar( 'wgMetaNamespace', $metaNS );
821 $this->endForm();
823 return 'output';
827 * @return bool
829 public function submit() {
830 $retVal = true;
831 $this->parent->setVarsFromRequest( array( 'wgSitename', '_NamespaceType',
832 '_AdminName', '_AdminPassword', '_AdminPassword2', '_AdminEmail',
833 '_Subscribe', '_SkipOptional', 'wgMetaNamespace' ) );
835 // Validate site name
836 if ( strval( $this->getVar( 'wgSitename' ) ) === '' ) {
837 $this->parent->showError( 'config-site-name-blank' );
838 $retVal = false;
841 // Fetch namespace
842 $nsType = $this->getVar( '_NamespaceType' );
843 if ( $nsType == 'site-name' ) {
844 $name = $this->getVar( 'wgSitename' );
845 // Sanitize for namespace
846 // This algorithm should match the JS one in WebInstallerOutput.php
847 $name = preg_replace( '/[\[\]\{\}|#<>%+? ]/', '_', $name );
848 $name = str_replace( '&', '&amp;', $name );
849 $name = preg_replace( '/__+/', '_', $name );
850 $name = ucfirst( trim( $name, '_' ) );
851 } elseif ( $nsType == 'generic' ) {
852 $name = wfMessage( 'config-ns-generic' )->text();
853 } else { // other
854 $name = $this->getVar( 'wgMetaNamespace' );
857 // Validate namespace
858 if ( strpos( $name, ':' ) !== false ) {
859 $good = false;
860 } else {
861 // Title-style validation
862 $title = Title::newFromText( $name );
863 if ( !$title ) {
864 $good = $nsType == 'site-name';
865 } else {
866 $name = $title->getDBkey();
867 $good = true;
870 if ( !$good ) {
871 $this->parent->showError( 'config-ns-invalid', $name );
872 $retVal = false;
875 // Make sure it won't conflict with any existing namespaces
876 global $wgContLang;
877 $nsIndex = $wgContLang->getNsIndex( $name );
878 if ( $nsIndex !== false && $nsIndex !== NS_PROJECT ) {
879 $this->parent->showError( 'config-ns-conflict', $name );
880 $retVal = false;
883 $this->setVar( 'wgMetaNamespace', $name );
885 // Validate username for creation
886 $name = $this->getVar( '_AdminName' );
887 if ( strval( $name ) === '' ) {
888 $this->parent->showError( 'config-admin-name-blank' );
889 $cname = $name;
890 $retVal = false;
891 } else {
892 $cname = User::getCanonicalName( $name, 'creatable' );
893 if ( $cname === false ) {
894 $this->parent->showError( 'config-admin-name-invalid', $name );
895 $retVal = false;
896 } else {
897 $this->setVar( '_AdminName', $cname );
901 // Validate password
902 $msg = false;
903 $pwd = $this->getVar( '_AdminPassword' );
904 $user = User::newFromName( $cname );
905 if ( $user ) {
906 $valid = $user->getPasswordValidity( $pwd );
907 } else {
908 $valid = 'config-admin-name-invalid';
910 if ( strval( $pwd ) === '' ) {
911 # $user->getPasswordValidity just checks for $wgMinimalPasswordLength.
912 # This message is more specific and helpful.
913 $msg = 'config-admin-password-blank';
914 } elseif ( $pwd !== $this->getVar( '_AdminPassword2' ) ) {
915 $msg = 'config-admin-password-mismatch';
916 } elseif ( $valid !== true ) {
917 $msg = $valid;
919 if ( $msg !== false ) {
920 call_user_func_array( array( $this->parent, 'showError' ), (array)$msg );
921 $this->setVar( '_AdminPassword', '' );
922 $this->setVar( '_AdminPassword2', '' );
923 $retVal = false;
926 // Validate e-mail if provided
927 $email = $this->getVar( '_AdminEmail' );
928 if ( $email && !Sanitizer::validateEmail( $email ) ) {
929 $this->parent->showError( 'config-admin-error-bademail' );
930 $retVal = false;
932 // If they asked to subscribe to mediawiki-announce but didn't give
933 // an e-mail, show an error. Bug 29332
934 if ( !$email && $this->getVar( '_Subscribe' ) ) {
935 $this->parent->showError( 'config-subscribe-noemail' );
936 $retVal = false;
939 return $retVal;
944 class WebInstaller_Options extends WebInstallerPage {
947 * @return string|null
949 public function execute() {
950 if ( $this->getVar( '_SkipOptional' ) == 'skip' ) {
951 return 'skip';
953 if ( $this->parent->request->wasPosted() ) {
954 if ( $this->submit() ) {
955 return 'continue';
959 $emailwrapperStyle = $this->getVar( 'wgEnableEmail' ) ? '' : 'display: none';
960 $this->startForm();
961 $this->addHTML(
962 # User Rights
963 // getRadioSet() builds a set of labeled radio buttons.
964 // For grep: The following messages are used as the item labels:
965 // config-profile-wiki, config-profile-no-anon, config-profile-fishbowl, config-profile-private
966 $this->parent->getRadioSet( array(
967 'var' => '_RightsProfile',
968 'label' => 'config-profile',
969 'itemLabelPrefix' => 'config-profile-',
970 'values' => array_keys( $this->parent->rightsProfiles ),
971 ) ) .
972 $this->parent->getInfoBox( wfMessage( 'config-profile-help' )->plain() ) .
974 # Licensing
975 // getRadioSet() builds a set of labeled radio buttons.
976 // For grep: The following messages are used as the item labels:
977 // config-license-cc-by, config-license-cc-by-sa, config-license-cc-by-nc-sa,
978 // config-license-cc-0, config-license-pd, config-license-gfdl,
979 // config-license-none, config-license-cc-choose
980 $this->parent->getRadioSet( array(
981 'var' => '_LicenseCode',
982 'label' => 'config-license',
983 'itemLabelPrefix' => 'config-license-',
984 'values' => array_keys( $this->parent->licenses ),
985 'commonAttribs' => array( 'class' => 'licenseRadio' ),
986 ) ) .
987 $this->getCCChooser() .
988 $this->parent->getHelpBox( 'config-license-help' ) .
990 # E-mail
991 $this->getFieldSetStart( 'config-email-settings' ) .
992 $this->parent->getCheckBox( array(
993 'var' => 'wgEnableEmail',
994 'label' => 'config-enable-email',
995 'attribs' => array( 'class' => 'showHideRadio', 'rel' => 'emailwrapper' ),
996 ) ) .
997 $this->parent->getHelpBox( 'config-enable-email-help' ) .
998 "<div id=\"emailwrapper\" style=\"$emailwrapperStyle\">" .
999 $this->parent->getTextBox( array(
1000 'var' => 'wgPasswordSender',
1001 'label' => 'config-email-sender'
1002 ) ) .
1003 $this->parent->getHelpBox( 'config-email-sender-help' ) .
1004 $this->parent->getCheckBox( array(
1005 'var' => 'wgEnableUserEmail',
1006 'label' => 'config-email-user',
1007 ) ) .
1008 $this->parent->getHelpBox( 'config-email-user-help' ) .
1009 $this->parent->getCheckBox( array(
1010 'var' => 'wgEnotifUserTalk',
1011 'label' => 'config-email-usertalk',
1012 ) ) .
1013 $this->parent->getHelpBox( 'config-email-usertalk-help' ) .
1014 $this->parent->getCheckBox( array(
1015 'var' => 'wgEnotifWatchlist',
1016 'label' => 'config-email-watchlist',
1017 ) ) .
1018 $this->parent->getHelpBox( 'config-email-watchlist-help' ) .
1019 $this->parent->getCheckBox( array(
1020 'var' => 'wgEmailAuthentication',
1021 'label' => 'config-email-auth',
1022 ) ) .
1023 $this->parent->getHelpBox( 'config-email-auth-help' ) .
1024 "</div>" .
1025 $this->getFieldSetEnd()
1028 $extensions = $this->parent->findExtensions();
1030 if ( $extensions ) {
1031 $extHtml = $this->getFieldSetStart( 'config-extensions' );
1033 foreach ( $extensions as $ext ) {
1034 $extHtml .= $this->parent->getCheckBox( array(
1035 'var' => "ext-$ext",
1036 'rawtext' => $ext,
1037 ) );
1040 $extHtml .= $this->parent->getHelpBox( 'config-extensions-help' ) .
1041 $this->getFieldSetEnd();
1042 $this->addHTML( $extHtml );
1045 // Having / in paths in Windows looks funny :)
1046 $this->setVar( 'wgDeletedDirectory',
1047 str_replace(
1048 '/', DIRECTORY_SEPARATOR,
1049 $this->getVar( 'wgDeletedDirectory' )
1052 // If we're using the default, let the user set it relative to $wgScriptPath
1053 $curLogo = $this->getVar( 'wgLogo' );
1054 $logoString = ( $curLogo == "/wiki/skins/common/images/wiki.png" ) ?
1055 '$wgStylePath/common/images/wiki.png' : $curLogo;
1057 $uploadwrapperStyle = $this->getVar( 'wgEnableUploads' ) ? '' : 'display: none';
1058 $this->addHTML(
1059 # Uploading
1060 $this->getFieldSetStart( 'config-upload-settings' ) .
1061 $this->parent->getCheckBox( array(
1062 'var' => 'wgEnableUploads',
1063 'label' => 'config-upload-enable',
1064 'attribs' => array( 'class' => 'showHideRadio', 'rel' => 'uploadwrapper' ),
1065 'help' => $this->parent->getHelpBox( 'config-upload-help' )
1066 ) ) .
1067 '<div id="uploadwrapper" style="' . $uploadwrapperStyle . '">' .
1068 $this->parent->getTextBox( array(
1069 'var' => 'wgDeletedDirectory',
1070 'label' => 'config-upload-deleted',
1071 'attribs' => array( 'dir' => 'ltr' ),
1072 'help' => $this->parent->getHelpBox( 'config-upload-deleted-help' )
1073 ) ) .
1074 '</div>' .
1075 $this->parent->getTextBox( array(
1076 'var' => 'wgLogo',
1077 'value' => $logoString,
1078 'label' => 'config-logo',
1079 'attribs' => array( 'dir' => 'ltr' ),
1080 'help' => $this->parent->getHelpBox( 'config-logo-help' )
1083 $this->addHTML(
1084 $this->parent->getCheckBox( array(
1085 'var' => 'wgUseInstantCommons',
1086 'label' => 'config-instantcommons',
1087 'help' => $this->parent->getHelpBox( 'config-instantcommons-help' )
1088 ) ) .
1089 $this->getFieldSetEnd()
1092 $caches = array( 'none' );
1093 if ( count( $this->getVar( '_Caches' ) ) ) {
1094 $caches[] = 'accel';
1096 $caches[] = 'memcached';
1098 // We'll hide/show this on demand when the value changes, see config.js.
1099 $cacheval = $this->getVar( 'wgMainCacheType' );
1100 if ( !$cacheval ) {
1101 // We need to set a default here; but don't hardcode it
1102 // or we lose it every time we reload the page for validation
1103 // or going back!
1104 $cacheval = 'none';
1106 $hidden = ( $cacheval == 'memcached' ) ? '' : 'display: none';
1107 $this->addHTML(
1108 # Advanced settings
1109 $this->getFieldSetStart( 'config-advanced-settings' ) .
1110 # Object cache settings
1111 // getRadioSet() builds a set of labeled radio buttons.
1112 // For grep: The following messages are used as the item labels:
1113 // config-cache-none, config-cache-accel, config-cache-memcached
1114 $this->parent->getRadioSet( array(
1115 'var' => 'wgMainCacheType',
1116 'label' => 'config-cache-options',
1117 'itemLabelPrefix' => 'config-cache-',
1118 'values' => $caches,
1119 'value' => $cacheval,
1120 ) ) .
1121 $this->parent->getHelpBox( 'config-cache-help' ) .
1122 "<div id=\"config-memcachewrapper\" style=\"$hidden\">" .
1123 $this->parent->getTextArea( array(
1124 'var' => '_MemCachedServers',
1125 'label' => 'config-memcached-servers',
1126 'help' => $this->parent->getHelpBox( 'config-memcached-help' )
1127 ) ) .
1128 '</div>' .
1129 $this->getFieldSetEnd()
1131 $this->endForm();
1133 return null;
1137 * @return string
1139 public function getCCPartnerUrl() {
1140 $server = $this->getVar( 'wgServer' );
1141 $exitUrl = $server . $this->parent->getUrl( array(
1142 'page' => 'Options',
1143 'SubmitCC' => 'indeed',
1144 'config__LicenseCode' => 'cc',
1145 'config_wgRightsUrl' => '[license_url]',
1146 'config_wgRightsText' => '[license_name]',
1147 'config_wgRightsIcon' => '[license_button]',
1148 ) );
1149 $styleUrl = $server . dirname( dirname( $this->parent->getUrl() ) ) .
1150 '/skins/common/config-cc.css';
1151 $iframeUrl = 'http://creativecommons.org/license/?' .
1152 wfArrayToCgi( array(
1153 'partner' => 'MediaWiki',
1154 'exit_url' => $exitUrl,
1155 'lang' => $this->getVar( '_UserLang' ),
1156 'stylesheet' => $styleUrl,
1157 ) );
1159 return $iframeUrl;
1163 * @return string
1165 public function getCCChooser() {
1166 $iframeAttribs = array(
1167 'class' => 'config-cc-iframe',
1168 'name' => 'config-cc-iframe',
1169 'id' => 'config-cc-iframe',
1170 'frameborder' => 0,
1171 'width' => '100%',
1172 'height' => '100%',
1174 if ( $this->getVar( '_CCDone' ) ) {
1175 $iframeAttribs['src'] = $this->parent->getUrl( array( 'ShowCC' => 'yes' ) );
1176 } else {
1177 $iframeAttribs['src'] = $this->getCCPartnerUrl();
1179 $wrapperStyle = ( $this->getVar( '_LicenseCode' ) == 'cc-choose' ) ? '' : 'display: none';
1181 return "<div class=\"config-cc-wrapper\" id=\"config-cc-wrapper\" style=\"$wrapperStyle\">\n" .
1182 Html::element( 'iframe', $iframeAttribs, '', false /* not short */ ) .
1183 "</div>\n";
1187 * @return string
1189 public function getCCDoneBox() {
1190 $js = "parent.document.getElementById('config-cc-wrapper').style.height = '$1';";
1191 // If you change this height, also change it in config.css
1192 $expandJs = str_replace( '$1', '54em', $js );
1193 $reduceJs = str_replace( '$1', '70px', $js );
1195 return '<p>' .
1196 Html::element( 'img', array( 'src' => $this->getVar( 'wgRightsIcon' ) ) ) .
1197 '&#160;&#160;' .
1198 htmlspecialchars( $this->getVar( 'wgRightsText' ) ) .
1199 "</p>\n" .
1200 "<p style=\"text-align: center;\">" .
1201 Html::element( 'a',
1202 array(
1203 'href' => $this->getCCPartnerUrl(),
1204 'onclick' => $expandJs,
1206 wfMessage( 'config-cc-again' )->text()
1208 "</p>\n" .
1209 "<script>\n" .
1210 # Reduce the wrapper div height
1211 htmlspecialchars( $reduceJs ) .
1212 "\n" .
1213 "</script>\n";
1216 public function submitCC() {
1217 $newValues = $this->parent->setVarsFromRequest(
1218 array( 'wgRightsUrl', 'wgRightsText', 'wgRightsIcon' ) );
1219 if ( count( $newValues ) != 3 ) {
1220 $this->parent->showError( 'config-cc-error' );
1222 return;
1224 $this->setVar( '_CCDone', true );
1225 $this->addHTML( $this->getCCDoneBox() );
1229 * @return bool
1231 public function submit() {
1232 $this->parent->setVarsFromRequest( array( '_RightsProfile', '_LicenseCode',
1233 'wgEnableEmail', 'wgPasswordSender', 'wgEnableUploads', 'wgLogo',
1234 'wgEnableUserEmail', 'wgEnotifUserTalk', 'wgEnotifWatchlist',
1235 'wgEmailAuthentication', 'wgMainCacheType', '_MemCachedServers',
1236 'wgUseInstantCommons' ) );
1238 if ( !array_key_exists( $this->getVar( '_RightsProfile' ), $this->parent->rightsProfiles )
1240 reset( $this->parent->rightsProfiles );
1241 $this->setVar( '_RightsProfile', key( $this->parent->rightsProfiles ) );
1244 $code = $this->getVar( '_LicenseCode' );
1245 if ( $code == 'cc-choose' ) {
1246 if ( !$this->getVar( '_CCDone' ) ) {
1247 $this->parent->showError( 'config-cc-not-chosen' );
1249 return false;
1251 } elseif ( array_key_exists( $code, $this->parent->licenses ) ) {
1252 // Messages:
1253 // config-license-cc-by, config-license-cc-by-sa, config-license-cc-by-nc-sa,
1254 // config-license-cc-0, config-license-pd, config-license-gfdl, config-license-none,
1255 // config-license-cc-choose
1256 $entry = $this->parent->licenses[$code];
1257 if ( isset( $entry['text'] ) ) {
1258 $this->setVar( 'wgRightsText', $entry['text'] );
1259 } else {
1260 $this->setVar( 'wgRightsText', wfMessage( 'config-license-' . $code )->text() );
1262 $this->setVar( 'wgRightsUrl', $entry['url'] );
1263 $this->setVar( 'wgRightsIcon', $entry['icon'] );
1264 } else {
1265 $this->setVar( 'wgRightsText', '' );
1266 $this->setVar( 'wgRightsUrl', '' );
1267 $this->setVar( 'wgRightsIcon', '' );
1270 $extsAvailable = $this->parent->findExtensions();
1271 $extsToInstall = array();
1272 foreach ( $extsAvailable as $ext ) {
1273 if ( $this->parent->request->getCheck( 'config_ext-' . $ext ) ) {
1274 $extsToInstall[] = $ext;
1277 $this->parent->setVar( '_Extensions', $extsToInstall );
1279 if ( $this->getVar( 'wgMainCacheType' ) == 'memcached' ) {
1280 $memcServers = explode( "\n", $this->getVar( '_MemCachedServers' ) );
1281 if ( !$memcServers ) {
1282 $this->parent->showError( 'config-memcache-needservers' );
1284 return false;
1287 foreach ( $memcServers as $server ) {
1288 $memcParts = explode( ":", $server, 2 );
1289 if ( !isset( $memcParts[0] )
1290 || ( !IP::isValid( $memcParts[0] )
1291 && ( gethostbyname( $memcParts[0] ) == $memcParts[0] ) )
1293 $this->parent->showError( 'config-memcache-badip', $memcParts[0] );
1295 return false;
1296 } elseif ( !isset( $memcParts[1] ) ) {
1297 $this->parent->showError( 'config-memcache-noport', $memcParts[0] );
1299 return false;
1300 } elseif ( $memcParts[1] < 1 || $memcParts[1] > 65535 ) {
1301 $this->parent->showError( 'config-memcache-badport', 1, 65535 );
1303 return false;
1308 return true;
1313 class WebInstaller_Install extends WebInstallerPage {
1316 * @return bool Always true.
1318 public function isSlow() {
1319 return true;
1323 * @return string|bool
1325 public function execute() {
1326 if ( $this->getVar( '_UpgradeDone' ) ) {
1327 return 'skip';
1328 } elseif ( $this->getVar( '_InstallDone' ) ) {
1329 return 'continue';
1330 } elseif ( $this->parent->request->wasPosted() ) {
1331 $this->startForm();
1332 $this->addHTML( "<ul>" );
1333 $results = $this->parent->performInstallation(
1334 array( $this, 'startStage' ),
1335 array( $this, 'endStage' )
1337 $this->addHTML( "</ul>" );
1338 // PerformInstallation bails on a fatal, so make sure the last item
1339 // completed before giving 'next.' Likewise, only provide back on failure
1340 $lastStep = end( $results );
1341 $continue = $lastStep->isOK() ? 'continue' : false;
1342 $back = $lastStep->isOK() ? false : 'back';
1343 $this->endForm( $continue, $back );
1344 } else {
1345 $this->startForm();
1346 $this->addHTML( $this->parent->getInfoBox( wfMessage( 'config-install-begin' )->plain() ) );
1347 $this->endForm();
1350 return true;
1354 * @param string $step
1356 public function startStage( $step ) {
1357 // Messages: config-install-database, config-install-tables, config-install-interwiki,
1358 // config-install-stats, config-install-keys, config-install-sysop, config-install-mainpage
1359 $this->addHTML( "<li>" . wfMessage( "config-install-$step" )->escaped() .
1360 wfMessage( 'ellipsis' )->escaped() );
1362 if ( $step == 'extension-tables' ) {
1363 $this->startLiveBox();
1368 * @param string $step
1369 * @param Status $status
1371 public function endStage( $step, $status ) {
1372 if ( $step == 'extension-tables' ) {
1373 $this->endLiveBox();
1375 $msg = $status->isOk() ? 'config-install-step-done' : 'config-install-step-failed';
1376 $html = wfMessage( 'word-separator' )->escaped() . wfMessage( $msg )->escaped();
1377 if ( !$status->isOk() ) {
1378 $html = "<span class=\"error\">$html</span>";
1380 $this->addHTML( $html . "</li>\n" );
1381 if ( !$status->isGood() ) {
1382 $this->parent->showStatusBox( $status );
1388 class WebInstaller_Complete extends WebInstallerPage {
1390 public function execute() {
1391 // Pop up a dialog box, to make it difficult for the user to forget
1392 // to download the file
1393 $lsUrl = $this->getVar( 'wgServer' ) . $this->parent->getURL( array( 'localsettings' => 1 ) );
1394 if ( isset( $_SERVER['HTTP_USER_AGENT'] ) &&
1395 strpos( $_SERVER['HTTP_USER_AGENT'], 'MSIE' ) !== false
1397 // JS appears to be the only method that works consistently with IE7+
1398 $this->addHtml( "\n<script>jQuery( function () { document.location = " .
1399 Xml::encodeJsVar( $lsUrl ) . "; } );</script>\n" );
1400 } else {
1401 $this->parent->request->response()->header( "Refresh: 0;url=$lsUrl" );
1404 $this->startForm();
1405 $this->parent->disableLinkPopups();
1406 $this->addHTML(
1407 $this->parent->getInfoBox(
1408 wfMessage( 'config-install-done',
1409 $lsUrl,
1410 $this->getVar( 'wgServer' ) .
1411 $this->getVar( 'wgScriptPath' ) . '/index' .
1412 $this->getVar( 'wgScriptExtension' ),
1413 '<downloadlink/>'
1414 )->plain(), 'tick-32.png'
1417 $this->addHTML( $this->parent->getInfoBox(
1418 wfMessage( 'config-extension-link' )->text() ) );
1420 $this->parent->restoreLinkPopups();
1421 $this->endForm( false, false );
1426 class WebInstaller_Restart extends WebInstallerPage {
1429 * @return string|null
1431 public function execute() {
1432 $r = $this->parent->request;
1433 if ( $r->wasPosted() ) {
1434 $really = $r->getVal( 'submit-restart' );
1435 if ( $really ) {
1436 $this->parent->reset();
1439 return 'continue';
1442 $this->startForm();
1443 $s = $this->parent->getWarningBox( wfMessage( 'config-help-restart' )->plain() );
1444 $this->addHTML( $s );
1445 $this->endForm( 'restart' );
1447 return null;
1452 abstract class WebInstaller_Document extends WebInstallerPage {
1455 * @return string
1457 abstract protected function getFileName();
1459 public function execute() {
1460 $text = $this->getFileContents();
1461 $text = InstallDocFormatter::format( $text );
1462 $this->parent->output->addWikiText( $text );
1463 $this->startForm();
1464 $this->endForm( false );
1468 * @return string
1470 public function getFileContents() {
1471 $file = __DIR__ . '/../../' . $this->getFileName();
1472 if ( !file_exists( $file ) ) {
1473 return wfMessage( 'config-nofile', $file )->plain();
1476 return file_get_contents( $file );
1481 class WebInstaller_Readme extends WebInstaller_Document {
1484 * @return string
1486 protected function getFileName() {
1487 return 'README';
1492 class WebInstaller_ReleaseNotes extends WebInstaller_Document {
1495 * @throws MWException
1496 * @return string
1498 protected function getFileName() {
1499 global $wgVersion;
1501 if ( !preg_match( '/^(\d+)\.(\d+).*/i', $wgVersion, $result ) ) {
1502 throw new MWException( 'Variable $wgVersion has an invalid value.' );
1505 return 'RELEASE-NOTES-' . $result[1] . '.' . $result[2];
1510 class WebInstaller_UpgradeDoc extends WebInstaller_Document {
1513 * @return string
1515 protected function getFileName() {
1516 return 'UPGRADE';
1521 class WebInstaller_Copying extends WebInstaller_Document {
1524 * @return string
1526 protected function getFileName() {
1527 return 'COPYING';