【EC-CUBE 4】管理画面のURLを変更する方法

EC-CUBE 4の管理画面URLは、誰でも推測できる文字列のままだと不正アクセスの入口になります。ログインIDとパスワードが必要とはいえ、変えておくに越したことはありません。管理画面から変える方法と、ファイルサーバーから変える方法の2通りを紹介します。

ECCUBE_ADMIN_ROUTE=admin

bin/console cache:clear --no-warmup

管理画面URLはどこで決まっているのか

管理画面URLの実体は、EC-CUBEのルートディレクトリにある .env の ECCUBE_ADMIN_ROUTE という 環境変数 ひとつです。

https://（ドメイン）/（ECCUBE_ADMIN_ROUTEの値）

管理画面から変更する操作も、内部的にはこの値を書き換えているだけです。だからどちらの方法でも結果は同じになります。

方法1：管理画面から変更する

「設定」→「システム設定」→「セキュリティ管理」を開くと、管理画面URLを入力するフォームがあります。ここに新しいURLを入れて登録するだけです。

設定 → システム設定 → セキュリティ管理

もっとも簡単で間違いがない方法です。管理画面に入れる状態なら、こちらを使ってください。

方法2：.env ファイルから変更する

ファイルサーバーから直接変更することもできます。管理画面URLを忘れて入れなくなったときはこちらしかないので、場所だけでも覚えておくと安心です。

1. STEP1
   ルートディレクトリの「.env」ファイルを開く

   Xserverであれば、ファイルマネージャーから対象プロジェクトの public_html にある .env を開きます。

   .env は先頭がドットで始まる隠しファイルです。見当たらない場合は、ファイルマネージャーやFTPソフトの隠しファイル表示を有効にしてください。

2. STEP2
   「ECCUBE_ADMIN_ROUTE」を探す

   ここに設定されている値が、そのまま管理画面のURLになります。

3. STEP3
   値を希望のURLに書き換える

   たとえば admin にしたい場合は次のように書きます。

   ECCUBE_ADMIN_ROUTE=admin

   変更前の値を残しておきたい場合は、行頭に # を付けてコメントアウトできます。

   #ECCUBE_ADMIN_ROUTE=administrator
   ECCUBE_ADMIN_ROUTE=admin

   新しいURLは推測されにくいものにしてください。admin や administrator のような定番の文字列では、変更する意味がほとんどありません。不正アクセスを防ぐのが目的なので、他人が思いつかない文字列にします。

4. STEP4
   保存してキャッシュを削除する

   保存したら、キャッシュ を削除します。ここを飛ばすと設定が反映されず、エラーまたは「ページが見つかりません」になります。

   サーバーに SSH 接続して、次のコマンドを実行します。

   bin/console cache:clear --no-warmup

   SSH接続の方法は以下の記事にまとめています（Xserverの場合）。

うまくいかないときは

「bin/console: 許可がありません」と表示されたら

実行 権限 を付けてから、もう一度キャッシュ削除を実行します。

cd bin
chmod 0704 console
cd ..

PHPのバージョン要件でエラーが出たら

使いたい PHP のバージョンを明示してコマンドを実行します。以下はPHP 8.3を指定する例です。

/usr/bin/php8.3 bin/console cache:clear --no-warmup

まとめ

• 管理画面URLの実体は .env の ECCUBE_ADMIN_ROUTE ひとつ
• 初期値は環境によって違う。いまの値は .env を見れば分かる（URLを忘れたときもここ）
• 管理画面に入れるなら「設定 → システム設定 → セキュリティ管理」が最も簡単
• ファイルから変えた場合はキャッシュの削除が必須
• 新しいURLは推測されにくい文字列にする。変更後はブックマークの更新も忘れずに

EC-CUBEのカスタマイズに関する記事

• カスタマイズのまとめ
• 管理画面のログインIDとパスワードが分からないときの対処法
• PHPのバージョン切り替え方法（コマンドライン）
• 【XServer】Windows PCからSSH接続する方法
• 【XServer】Mac PCからSSH接続する方法

この記事に出てきた用語

• EC-CUBEとは？
• 環境変数とは？
• .envとは？
• キャッシュとは？
• SSHとは？
• パーミッションとは？
• PHPとは？