wp-config.phpの編集方法 | よく使う設定の意味と注意点

設定は define() の1行で書けるものがほとんどよ。足す時は1行ずつにして、そのたびにサイトの表示を確認しなさい。

wp-config.phpとは、編集前の注意

wp-config.phpは、WordPressの設定を書いておくファイルなの。サイトを入れたフォルダ（ルートフォルダ）にあるわ。

必要がなければ、触らないこと。変更で予期しない問題が起きることがあるからよ。触る時は、次の手順で、少しずつ進めなさい。

編集前に、次の2つを済ませるの。

1. ファイルとデータベースのバックアップを取りなさい。手順はWordPressのバックアップを手動で取る方法にあるわ。
2. 復元の方法を知っておくの。壊れた時に、戻せる状態にしておくためよ。

控えのない書き換えは、保険なしで夜道を歩くようなものよ。公式も、設定を変える前に定期的なバックアップと復元方法の確認を求めているわ。

このファイルには、データベースのパスワードなど、外に出せない情報が入っているの。画面のスクリーンショットやファイルの中身を、ブログやSNS、相談の投稿に貼らないでちょうだい。見せる場合は、該当の行を伏せなさい。

DB接続の項目（DB_NAMEなど）でエラーが出ている場合は、「データベース接続確立エラー」の直し方を見てね。

wp-config.phpの編集手順

1. FTPソフトか契約先のファイルマネージャーで、サーバーに接続するの。
2. WordPressを入れたフォルダを開いて、wp-config.phpを見つけなさい。
3. wp-config.phpをPCにコピーして、保存するのよ。
4. wp-config.phpを開くわ。
5. 足したい設定の define() を1行だけ書き足しなさい。
6. 保存して、サイトと管理画面を開き、表示を確認するの。
7. 問題がなければ、次の設定に進むのよ。

書く位置にも決まりがあるわ。公式の例では、ログの設定コードは、require_once や include の命令より上に置かれているの。WP_MAX_MEMORY_LIMIT については、公式が「wp-settings.php の読み込みより前に書く」と注記しているわ。

既存の行は、不要に消したり書き換えたりしないの。書き足す1行だけを変えなさい。

サイトが真っ白になったり、エラーが出たりした時は、手順3のコピーに戻すのよ。切り分けはWordPressが真っ白になった時の直し方にあるわ。

よく使う設定の早見表

公式のページに載っている設定のうち、よく使うものを表にしておいたわ。値は公式の例よ。サイトに合わせた数値を、公式は示していないの。

定数	役割	書き方の例
WP_DEBUG	エラーと警告の報告を制御するの。既定はfalseよ	define( 'WP_DEBUG', true );
WP_DEBUG_LOG	エラー・通知・警告を、既定で /wp-content/debug.log に記録するの	define( 'WP_DEBUG_LOG', true );
WP_DEBUG_DISPLAY	画面にエラーを表示しないわ（WP_DEBUG_LOGと組み合わせるの）	define( 'WP_DEBUG_DISPLAY', false );
SCRIPT_DEBUG	「dev」版のスクリプトを使わせるのよ	define( 'SCRIPT_DEBUG', true );
WP_MEMORY_LIMIT	PHPが使える最大メモリを指定するの	define( 'WP_MEMORY_LIMIT', '64M' );
WP_MAX_MEMORY_LIMIT	管理画面の作業用に、メモリの上限を指定するの	define( 'WP_MAX_MEMORY_LIMIT', '128M' );
WP_POST_REVISIONS	投稿のリビジョンの扱いよ。既定はtrueなの	define( 'WP_POST_REVISIONS', 3 );
EMPTY_TRASH_DAYS	ごみ箱を空にするまでの日数よ。既定は30日	define( 'EMPTY_TRASH_DAYS', 30 );
FORCE_SSL_ADMIN	ログインと管理画面を保護するための設定なの	define( 'FORCE_SSL_ADMIN', true );
WP_AUTO_UPDATE_CORE	コアの自動更新の範囲よ。既定はマイナーリリースのみ	define( 'WP_AUTO_UPDATE_CORE', 'minor' );
WP_ENVIRONMENT_TYPE	サイトの環境の種類よ	define( 'WP_ENVIRONMENT_TYPE', 'staging' );

WP_DEBUG、WP_DEBUG_LOG、WP_DEBUG_DISPLAY

3つは組み合わせて使うのよ。WP_DEBUGをtrueにすると、WP_DEBUG_DISPLAYとWP_DEBUG_LOGの設定が使えるようになるの。

WP_DEBUG_LOGをtrueにすると、記録が /wp-content/debug.log に残るわ。WP_DEBUG_DISPLAYをfalseにすると、画面にはエラーを出さず、ログだけに残せるの。ログの読み方と、原因の探し方は「重大なエラー」の直し方と復旧モードのメールの使い方にまとめてあるわ。

デバッグ設定は、原因を調べ終わったら元に戻しなさい。

WP_MEMORY_LIMIT

WordPressは、PHPに割り当てるメモリを、既定で40MBまで増やそうとするの。それ以上が必要な時に、WP_MEMORY_LIMITで指定するのよ。公式の例は '64M' ね。

管理画面の作業は、通常より多くのメモリを必要とすることがあるわ。その場合は、WP_MAX_MEMORY_LIMITを使いなさい。公式の例は '128M' よ。

WP_POST_REVISIONS

リビジョンは、投稿の保存履歴のこと。既定は、すべてのリビジョンを残す設定（true）なの。

• 無効にする：define( 'WP_POST_REVISIONS', false );
• 保存数に上限をつける：define( 'WP_POST_REVISIONS', 3 );

EMPTY_TRASH_DAYS

ごみ箱に入れた投稿を、何日後に完全に削除するかを決める設定よ。既定は30日。

0にすると、ごみ箱が無効になるの。この場合、「完全に削除」を押しても確認が出ないわ。誤って押すと、そのまま消えるから気をつけなさい。

FORCE_SSL_ADMIN

ログインと管理画面を保護するための設定よ。以前の FORCE_SSL_LOGIN は、WordPress 4.0で非推奨になったの。今は FORCE_SSL_ADMIN を使いなさい。

WP_AUTO_UPDATE_CORE

コアの自動更新の範囲を決める設定ね。書き方は3通りよ。

値	動き
'minor'	マイナーリリースの更新だけ有効よ（既定）
false	コアの更新をすべて無効にするわ
true	メジャー・マイナーとも有効になるの

WP_ENVIRONMENT_TYPE

使える値は、local、development、staging、production の4つ。これ以外の値を渡すと、既定の production になるわ。

注意点が1つあるの。環境が development と判定されて、wp-config.phpにWP_DEBUGの定義がない場合、WP_DEBUGは true になるのよ。

WP_MEMORY_LIMITを上げる前に

WP_MEMORY_LIMITを上げると、問題の根本の原因を隠してしまうことがあるの。プラグインや機能を足した時に、同じ問題が後で再発する可能性があるわ。

上げる場合は、バックアップを取って、1行だけ足して、結果を確認なさい。サイトの警告の見方はサイトヘルスの見方にあるわ。

よくある質問

EMPTY_TRASH_DAYSを0にしても大丈夫ですか。

おすすめしないわ。0にするとごみ箱が無効になって、「完全に削除」を押しても確認が出ないの。誤って押すと、そのまま消えるわよ。

wp-config.phpの中身を、SNSや相談の投稿に貼ってもいいですか。

貼ってはだめよ。このファイルには、データベースのパスワードなど外に出せない情報が入っているの。見せる場合は、該当の行を伏せなさい。

WP_DEBUG_DISPLAYをfalseにすると、何が変わりますか。

画面にはエラーを出さず、ログだけに残せるようになるのよ。WP_DEBUG_LOG をtrueにしておけば、記録は /wp-content/debug.log に残るわ。

ほかの記事

• WordPressのバックアップを手動で取る方法
• 「重大なエラー」の直し方と復旧モードのメールの使い方
• サイトヘルスの見方
• WordPressが真っ白になった時の直し方
• 「データベース接続確立エラー」の直し方

出典

• Editing wp-config.php（WordPress公式 開発者向けドキュメント）