Mediawikiがデプロイ先で500エラーを起こす時に真っ先に確認すること

開発中のMediawikiをWebStormの「Deployment」機能やFTPクライアントなどを使用してデプロイすると「500 Internet Server Error」が生ずる場合があります。

これは、リモートにアップロードされたLocalsettings.phpの設定の内容がローカルのままで、かつphp maintainance/update.phpの実行によるがLocalsettings.phpの設定が未反映であることによって引き起こされます。

具体的には、

# $wgScriptPath = "http://my.domain.com";
$wgScriptPath  = "http://localhost/mwiki";

# $wgServer = "http://my.domain.com";
$wgServer  = "http://localhost/mwiki";

といったパスがリモート／ローカル間で切り替わっていないですとか、

## Database settings
$wgDBtype     = "mysql";
$wgDBserver   = "localhost";
$wgDBname     = "mediawiki";
$wgDBuser     = "root";
$wgDBpassword = "passForLocal";

といったDBの設定がリモート／ローカルで異なることによって引き起こされます。

具体的な解決手順としては次の通りです。

1. リモート上のLocalSettings.phpをリモート向けに再設定する
2. php maintainance/update.phpを実行する
   これでも同じエラーが残る場合、再設定した内容に問題があるか、別の原因が考えられます。

また、同じトラブルの再発防止策として、例えばWebStormならLocalSettings.phpのような特定のファイルを指定してアップロード対象外にする設定を使用するですとか、手動でアップロードする際はアップロードするファイルに注意を払うといったヒューマンエラーの防止といった方法が考えられるでしょう。