サブフォルダーの WordPress で SITECOOKIEPATH を変えたらログインできなくなった:変えるのは COOKIEPATH だけ

管理画面
広告WordPress・PHP を学べる本

Amazonのアソシエイトとして、WordPress functions.phpは適格販売により収入を得ています。

サブフォルダーに置いた WordPress(例:example.com/blog)で、サイトのトップ(example.com/)にも WordPress のページを出す作りにしたときのことです。トップのページで管理バーが出ないので、ログインの Cookie(ログインしていることを覚えておく小さなデータ)の置き場所を変えようとしたところ、管理画面にログインできなくなりました。

やったこと:SITECOOKIEPATH まで変えてしまった

WordPress は、ログインの Cookie を「どのパスの下で送るか」を決めて保存します。サブフォルダーに置いた WordPress では、その範囲は /blog/ の下だけです。そのため、/blog の外にあるトップのページでは、ログインしていないものとして扱われ、管理バーが出ませんでした。

そこで wp-config.php に、Cookie のパスを「/」にする設定を 2 つ足しました。ところが、保存してログインし直そうとすると、ログインの画面から先へ進めなくなりました。

// ログインできなくなった設定(使わない)
define( 'COOKIEPATH', '/' );
define( 'SITECOOKIEPATH', '/' );

原因:管理画面の Cookie のパスは SITECOOKIEPATH から作られる

WordPress は、管理画面用の Cookie のパス(ADMIN_COOKIE_PATH)を「SITECOOKIEPATH + wp-admin」で作ります。SITECOOKIEPATH を「/」にすると、管理画面の Cookie は /wp-admin の下で送るものになります。実際の管理画面は /blog/wp-admin なので、ブラウザーはその Cookie を送らず、WordPress はログインしていないと判断してログインの画面に戻していました。

定数 決めていること
COOKIEPATH 公開側のページで使うログインの Cookie のパス
SITECOOKIEPATH WordPress を置いたフォルダーのパス。管理画面とプラグインの Cookie のパスのもとになる
ADMIN_COOKIE_PATH 管理画面の Cookie のパス(SITECOOKIEPATH + wp-admin)
PLUGINS_COOKIE_PATH プラグインのフォルダーの Cookie のパス

直し方:変えるのは COOKIEPATH だけ

SITECOOKIEPATH の行を消し、COOKIEPATH だけを「/」にしました。これで、管理画面の Cookie はこれまでどおり /blog/wp-admin の下で送られ、公開側のページの Cookie だけがサイト全体で送られるようになります。トップのページでも管理バーが出て、ログインも元どおりできました。

// wp-config.php(「編集が必要なのはここまでです」の行より上に書く)
// 公開側のページのログインの Cookie を、サイト全体(/ の下)で送る
// SITECOOKIEPATH・ADMIN_COOKIE_PATH・PLUGINS_COOKIE_PATH は変えない
define( 'COOKIEPATH', '/' );

設定を変えたあとは、一度ログアウトしてからログインし直します。前の Cookie が残っていると、うまくいっているように見えてしまうことがあるためです。

ログインできなくなったときの戻し方

管理画面に入れなくても、FTP やサーバーのファイルマネージャーで wp-config.php を開ければ戻せます。足した行を消して保存し、ブラウザーのそのサイトの Cookie を消してからログインし直してください。wp-config.php を直す前には、必ずバックアップを取っておきます。

気をつけること

  • Cookie のパスの定数は、名前が似ていても役目が違う。サブフォルダーの WordPress で変えるのは COOKIEPATH だけにする
  • wp-config.php のログインに関わる設定は、足したらすぐ「ログアウト → ログイン」まで確認してから次の作業へ進む
  • 確認は、ふだん使っているブラウザーとは別のブラウザーかシークレットウィンドウでもしておくと、古い Cookie にだまされない

SiteBeacon(サイトビーコン)

サイトが止まったら、すぐに気づける。

ホームページを 5 分ごとにチェックして、止まったとき・エラーが出たとき・SSL やドメインの期限が近いときに、メールでお知らせします。2 サイトまでは、ずっと無料で使えます。

SiteBeacon を見る サイトを直す相談をする

監視で気づいたあとの直す作業も、同じ担当がお受けします。