wp-config.phpは、WordPressの基本設定を保存する重要な設定ファイルです。 データベースへの接続情報、認証用の秘密鍵、デバッグ設定、WordPress独自の定数などが記録され、WordPressが起動するときに読み込まれます。
初心者が日常的に編集するファイルではありません。 ただし、サーバー移転、データベース接続エラー、デバッグ、メモリ設定などで確認する場面があるため、「何が書かれていて、どこまで触ってよいか」を理解しておくとトラブル時に役立ちます。
30秒でわかる結論
30秒でわかる結論
- wp-config.phpはWordPressの基本設定を保存する重要ファイル
- 主にデータベース名・ユーザー名・パスワード・ホスト名などを持つ
- 認証用の秘密鍵・ソルト、テーブル接頭辞、デバッグ設定なども記述できる
- 通常はWordPressインストール時に自動作成され、初心者が頻繁に編集する必要はない
- 編集前は必ずバックアップを取り、文字コードや記号を壊さない
- データベース接続情報や認証キーを第三者へ公開しない
- 本番サイトでWP_DEBUGを有効にしたままにしない
wp-config.phpとは？
wp-config.phpは、WordPressを動かすための基本設定をまとめたPHPファイルです。 WordPress公式では、データベース接続情報などサイトの基本構成を保存する重要なファイルとして説明されています。
通常はWordPressをインストールするときに、入力したデータベース情報をもとに作成されます。 手動インストールでは、wp-config-sample.phpを元に作成する場合もあります。
初心者向けに言い換えると
wp-config.phpは、WordPressが「どのデータベースを使うか」「どの設定で起動するか」を確認するための設定表です。 記事本文や画像そのものを保存するファイルではありません。
wp-config.phpはどこにある？
一般的なWordPressでは、wp-config.phpはWordPressをインストールしたディレクトリの直下にあります。
代表的な構成
- wp-admin
- wp-content
- wp-includes
- wp-config.php
- wp-login.php
レンタルサーバーでは、ファイルマネージャーやFTP/SFTPでWordPressの設置先を開くと確認できます。
WordPress公式では、wp-config.phpをWordPressディレクトリの1階層上へ置く構成にも対応しています。 そのため、ルートに見当たらない場合でも「存在しない」と決めつけず、1階層上も確認します。
wp-config.phpに書かれている主な設定
| 項目 | 主な役割 |
|---|---|
| DB_NAME | 使用するデータベース名 |
| DB_USER | データベースユーザー名 |
| DB_PASSWORD | データベースパスワード |
| DB_HOST | データベースサーバーの接続先 |
| 認証キー・ソルト | ログインCookieなどの安全性を高める |
| $table_prefix | WordPressテーブル名の接頭辞 |
| WP_DEBUG | デバッグモードの有効・無効 |
| 追加定数 | メモリ・キャッシュなどの設定 |
データベース接続情報の役割
WordPressの記事、固定ページ、設定、ユーザー情報などは、MySQLやMariaDBなどのデータベースに保存されています。 wp-config.phpには、そのデータベースへ接続するための情報が記録されています。
代表的な設定名
DB_NAME
DB_USER
DB_PASSWORD
DB_HOST
これらの値が間違っていると、WordPressはデータベースへ接続できません。 その結果、「データベース接続確立エラー」などが表示されることがあります。
パスワードを記事やサポート掲示板へ貼らない
wp-config.phpにはデータベースパスワードなどの機密情報が含まれます。 ファイル全体を第三者へ送る場合は、必ず機密情報を削除・伏字にしてください。
認証キー・ソルトとは？
wp-config.phpには、AUTH_KEY、SECURE_AUTH_KEY、LOGGED_IN_KEY、NONCE_KEYなどの認証キーと、それぞれのSALTを設定できます。
これらはログインCookieや認証処理に使われる値で、推測しにくいランダムな文字列を設定します。 WordPress公式でも、強力なランダム値を使うことが推奨されています。
初心者が知っておくべき点
- 自分で意味のある文章を作らない
- 他サイトと同じ値を使い回さない
- 公開しない
- 変更すると既存ログインが無効になることがある
認証キーを更新すると、現在ログイン中のユーザーが再ログインを求められる場合があります。 不正ログインが疑われるときなどに、セッションを無効化する目的で使われることもあります。
テーブル接頭辞$table_prefixとは？
$table_prefixは、WordPressがデータベース内で使用するテーブル名の先頭部分を指定します。
例
$table_prefix = ‘wp_’;
この場合、テーブル名はwp_posts、wp_options、wp_usersなどになります。
1つのデータベース内に複数のWordPressを設置する場合など、接頭辞を分けて使うことがあります。
運用中サイトで安易に変更しない
wp-config.php側の接頭辞だけを変更すると、WordPressが既存テーブルを見つけられなくなります。 既存サイトで変更する場合はデータベース側のテーブル名なども含めた移行作業が必要です。
WP_DEBUGとは？
WP_DEBUGは、WordPressのデバッグモードを有効・無効にする定数です。 テーマやプラグインの不具合を調査するときに、PHPの警告やWordPressのデバッグ情報を確認する目的で使います。
考え方
開発・検証環境：必要に応じて有効化
本番公開サイト：通常は無効
WordPress公式では、WP_DEBUGや関連デバッグ機能は本番サイトでは常時有効にしないことが推奨されています。 エラー内容によっては、ファイルパスなど内部情報が画面へ表示される可能性があるためです。
trueと’false’を混同しない
PHPではfalseと'false'は意味が違います。
クォート付きの’false’は文字列として扱われるため、デバッグ設定では意図しない動作になる可能性があります。
WP_DEBUG_LOG・WP_DEBUG_DISPLAYとは？
WP_DEBUGと組み合わせて使う代表的な設定です。
| 定数 | 役割 |
|---|---|
| WP_DEBUG | デバッグモードを有効化 |
| WP_DEBUG_LOG | エラーをログへ記録 |
| WP_DEBUG_DISPLAY | エラーを画面に表示するか制御 |
WordPress公式では、調査時にWP_DEBUG_LOGを有効にし、WP_DEBUG_DISPLAYを無効にして画面へエラーを出さず、wp-content/debug.logへ記録する構成が案内されています。
デバッグモードの詳しい使い方は、別記事「WordPressのデバッグモードとは？有効化方法と注意点」で扱うのが適切です。
WP_MEMORY_LIMITとは？
wp-config.phpには、WordPressがPHPへ要求するメモリ上限を指定するWP_MEMORY_LIMITを設定できます。
ただし、wp-config.phpへ大きな値を書けば必ずその値まで使えるわけではありません。 レンタルサーバー側のPHP設定で上限変更が禁止されていれば、WordPressから増やせない場合があります。
メモリ不足の根本原因を隠さない
メモリ上限だけを増やすと、一時的にエラーが消えても、重いプラグインや処理が原因として残ることがあります。 上限変更だけでなく、エラーログやプラグイン構成も確認してください。
WP_CACHEとは？
WP_CACHEは、WordPressが起動するときにキャッシュ用のdrop-inを読み込むために使われる定数です。
WordPress公式では、define( 'WP_CACHE', true );を書くだけで自動的にページキャッシュが有効になるわけではないと説明されています。
通常はキャッシュプラグインやレンタルサーバー側の仕組みが管理します。
初心者は手動追加しない
キャッシュプラグインが自動で設定している場合があります。 意味を理解せず削除・追加すると、キャッシュ機能が動かなくなることがあります。
wp-config.phpを確認する場面
通常のブログ運営
確認頻度：低
問題なく運営できているなら、日常的に開く必要はありません。
サーバー移転
確認頻度：高
新しいデータベース名、ユーザー名、パスワード、DB_HOSTなどを確認・変更する場合があります。
データベース接続エラー
確認頻度：高
DB_NAME、DB_USER、DB_PASSWORD、DB_HOSTが現在のサーバー情報と一致するか確認します。
テーマ・プラグイン調査
確認頻度：必要時
WP_DEBUGやログ設定を一時的に使って原因を切り分ける場合があります。
wp-config.phpを編集する前に確認すること
編集前チェック
- wp-config.phpのバックアップを取ったか
- 可能ならサイト全体のバックアップもあるか
- 変更する設定の意味を理解しているか
- レンタルサーバー公式マニュアルを確認したか
- 現在の値を別ファイルへ控えたか
- 本番サイトなら作業時間を確保したか
WordPress公式でも、wp-config.phpを変更する前にバックアップを取り、復元方法を理解しておくことが推奨されています。
編集にはテキストエディタを使う
wp-config.phpはPHPコードを含むテキストファイルです。 Microsoft Wordなどのワープロソフトで編集すると、引用符や文字コードが変わり、PHPとして正しく動かなくなる可能性があります。
使うもの
レンタルサーバーのファイルマネージャーにあるテキスト編集機能、またはコード編集に対応したテキストエディタを使います。
どこに設定を追加する？
WordPress公式のデバッグ設定では、追加する定数は「That’s all, stop editing! Happy publishing.」に相当する終了コメントより前へ記述するよう案内されています。
設定をファイル末尾へ無条件に追記するのではなく、対象の定数がすでに定義されていないか確認してから追加します。
同じ定数を二重に定義しない
WP_DEBUGやWP_MEMORY_LIMITなどがすでに書かれている場合、別の場所へ同じ定数を追加せず、既存設定を確認してください。
編集ミスで起きるトラブル
| ミス | 起こりうること |
|---|---|
| 引用符を削除 | PHP構文エラー |
| セミコロンを削除 | 500エラー・画面停止 |
| DB情報を変更 | データベース接続エラー |
| 接頭辞を変更 | 既存テーブルを読めない |
| デバッグを公開 | 内部情報が表示される場合がある |
wp-config.phpはWordPress起動時の早い段階で読み込まれるため、PHP構文を壊すとサイト全体が表示できなくなることがあります。
「データベース接続確立エラー」で確認するポイント
データベース接続確立エラーが出た場合は、まずwp-config.phpの次の値を確認します。
確認項目
- DB_NAME
- DB_USER
- DB_PASSWORD
- DB_HOST
ただし、このエラーはwp-config.phpの入力ミスだけで起きるとは限りません。 データベースサーバー停止、容量制限、権限変更などサーバー側が原因の場合もあります。
原因と対処の詳しい流れは、別記事「『データベース接続確立エラー』の原因と対処法」で扱います。
wp-config.phpのパーミッションはどうする？
wp-config.phpには機密情報があるため、必要以上に広い読み書き権限を与えないことが重要です。
WordPress公式のセキュリティガイドでは、環境によって400や440のような厳しい権限を例として挙げています。 ただし、適切なパーミッションはサーバー構成によって異なります。
数値だけ真似しない
レンタルサーバーによってPHP実行方式や所有者設定が違うため、他サイトで見たパーミッション値をそのまま設定するとWordPressが読めなくなる場合があります。 利用中サーバーの公式推奨値を優先してください。
wp-config.phpをWeb公開しない
通常のPHP設定が正しく動いていれば、wp-config.phpへブラウザからアクセスしてもPHPコードそのものが表示されることはありません。
ただし、バックアップファイルを「wp-config.php.bak」「wp-config.txt」のような名前でWeb公開領域へ残すと、サーバー設定によっては内容がそのまま取得される危険があります。
避けたい状態
- wp-config.phpのコピーを公開ディレクトリへ放置
- 拡張子を.txtへ変更して保存
- 誰でも読める共有ストレージへアップロード
- サポート掲示板へ内容をそのまま貼る
wp-config.phpと.htaccessの違い
| ファイル | 主な役割 |
|---|---|
| wp-config.php | WordPress本体の基本設定 |
| .htaccess | Apache系Webサーバーのアクセス・リダイレクト等の設定 |
どちらもWordPress運営で見ることがありますが、役割は別です。 パーマリンクやリダイレクトの問題だからといって、wp-config.phpを編集するとは限りません。
初心者が触らなくてよい設定
wp-config.phpには非常に多くの高度な設定を追加できます。 しかし、利用目的が分からない定数を検索結果からコピーして追加するのはおすすめしません。
初心者の基本方針
- 通常運営では変更しない
- トラブル時も公式手順に必要な箇所だけ変更する
- サーバー会社の指示がある場合はその値を優先する
- 変更前のファイルを必ず残す
- 問題解消後に一時設定を戻す
教科書判定
初心者は「重要設定ファイルなので、必要なときだけ触る」で十分
wp-config.phpはWordPressのデータベース接続や認証、デバッグなどに関わる重要ファイルです。 通常のブログ更新や記事投稿で編集する必要はありません。
サーバー移転やトラブル対応で編集する場合は、バックアップ → 変更箇所を確認 → 必要な部分だけ編集 → 表示確認の順番を守ってください。
特にDB_PASSWORDや認証キーは外部へ公開せず、WP_DEBUGも本番環境で常時有効にしないことが重要です。
FAQ
Q．wp-config.phpは削除してもよいですか？
削除しないでください。WordPressがデータベースへ接続するための設定などが入っているため、通常はサイトが正常に動かなくなります。
Q．wp-config.phpが見つかりません
WordPressの設置ディレクトリ直下を確認し、見つからなければ1階層上も確認してください。レンタルサーバーのファイルマネージャーで隠れている場合や、管理権限によって表示できない場合もあります。
Q．wp-config.phpを編集するとWordPressが速くなりますか？
設定によってキャッシュやメモリに関係する項目はありますが、wp-config.phpを編集すれば自動的に高速化するわけではありません。原因を確認せず高速化用の定数を追加するのは避けてください。
Q．wp-config.phpのDB_PASSWORDを変更するとデータベースのパスワードも変わりますか？
いいえ。wp-config.phpはWordPressが接続に使うパスワードを指定しているだけです。データベース側のパスワードを変更した場合に、wp-config.phpも同じ値へ更新する必要があります。
Q．wp-config.phpのバックアップはどこへ保存すればよいですか？
Webから直接アクセスできない安全な場所へ保存してください。公開ディレクトリへ拡張子だけ変えたコピーを置くのは避けます。
まとめ
この記事の結論
- wp-config.phpはWordPressの基本設定を持つ重要ファイル
- データベース接続情報、認証キー、テーブル接頭辞などを保存する
- デバッグやメモリなど追加設定にも利用できる
- 通常のWordPress運営では頻繁に編集する必要はない
- 編集前には必ずバックアップを取る
- データベースパスワードや認証キーを外部へ公開しない
- 本番サイトでデバッグ情報を常時表示しない
- サーバー移転やエラー時は必要な項目だけ確認する
wp-config.phpは便利な設定ファイルですが、初心者が高速化やセキュリティ目的でむやみに編集するものではありません。 「何の設定を変えるのか」を明確にし、必要なときだけ慎重に扱ってください。
「WordPressのデータベースとは？MySQL・MariaDBを初心者向けに解説」「WordPressのデバッグモードとは？有効化方法と注意点」「.htaccessとは？WordPressでの役割を初心者向けに解説」もあわせて確認してください。