しんそつエンジニア日記
Tech
baserCMS5 管理画面URLを「動的に」変更する方法
2025.09.05

管理画面URLを変更する方法

baserCMS5の管理画面URLはデフォルトでは以下になっている
example.com/baser/admin/
好きなURLに変更するためには/config/.envの以下の記述を変更する
export ADMIN_PREFIX="admin"
export BASER_CORE_PREFIX="baser"

動的に変更する方法

管理画面URLを管理画面から変更する方法は、デフォルトの機能では存在しないが、
.envの値を書き換えるためのメソッドは存在する
\BaserCore\Service\SiteConfigsService::putEnv()
例)管理画面URLを変更するプラグインがあった場合
$newPrefix = $this->getParams('prefix');
// サービスをインスタンス化
$service = new \BaserCore\Service\SiteConfigsService();
// .envへの書き込み権限があるかどうか
$isWritableEnv = $siteConfigsService->isWritableEnv();

if ($isWritableEnv) {
// 書き換え処理
$service->putEnv('ADMIN_PREFIX', $newPrefix);
}

注意点

管理画面の書き換え処理が完了した時点で、今アクセスしているページ(旧管理画面URL)は404になる
適切なリダイレクト処理などを記述しておく必要あるので、忘れずに

putEnv()は管理画面以外の.envの情報も書き換えられる

more

この記事を書いた人

プロフィール画像

2002年生まれ、福岡県在住。
webデザインの専門学校を卒業後、webエンジニアとして働いています。
業務ではPHP、CMS開発を中心としていますが、ジャンルに関わらず、様々な技術に触ってみたいです。
日々の学びや、ゆるい日常を綴っていきます!