【パッケージ版】baserCMS5のアップデート方法!

はじめに

こんにちは!エンジニアのはまちです!

前回の記事では、baserCMS5の「パッケージ版(配布版)」と「Git版(開発版)」の違いについて整理しました。
前回記事:開発者に聞く!baserCMS 5系のパッケージ版とGit版の違い

今回は、それぞれのアップデート方法についてです!
baserCMS5では、構成によってアップデート方法が異なります。

パッケージ版とGit版(開発版)の両環境でそれぞれ
5.2.2 → 5.2.4 と 5.2.3 → 5.2.4のバージョンアップした時の内容をベースにアップデート方法をご紹介します。


この記事では、パッケージ版(配布版)のアップデート方法をご紹介します。
Git版(開発版)のアップデート方法は下記↓に記事を分割しています。

▶ Git版(開発版)のアップデート方法記事↓
【Git版(開発版)】baserCMS5のアップデート方法!!

パッケージ版だけど管理画面からアップデートできない!場合は、こちらの記事で一緒に記載していますので、Git版(開発版)のアップデート方法をご参照ください。
特に「パッケージ版」と記載が分かれていないところは、Git版と同じ流れになります。

まず結論

構成 アップデート方法
パッケージ版 管理画面から実行
Git版(開発版) 手動更新(Composer利用)

 

 

パッケージ版のアップデート

アップデートの流れ

アップデート前には必ず、データベースやファイルなどのバックアップはとっておきましょう!

1.アップデートサポータープラグインで問題がないか確認
【URL】/baser/admin/bc-update-supporter/support/index

2.アップデート画面を開く
【URL】/baser/admin/baser-core/plugins/update

3.最新版をダウンロード
4.アップデート実行
5.完了確認

という流れになります。

1.アップデートサポータープラグインで問題がないか確認

アップデートサポータープラグインをインストール、有効化して、
必要な改善がないかを確認(解消)してからアップデートしましょう

【URL】/baser/admin/bc-update-supporter/support/index

下記は改善が必要な時のキャプチャです。
ボタンポチで「改善実行」して、適用させてからアップデートへ進みましょう

▶ githubからダウンロード
https://github.com/baserproject/BcUpdateSupporter

▶ baserCMSマーケットからダウンロード
https://market.basercms.net/products/detail.php?product_id=164

▶ 参考:baserCMS5系公式ガイド「BcUpdateSupporter をインストールする」
https://baserproject.github.io/5/migration/ver523_migration

2.アップデート画面を開く

パッケージ版は、管理画面からアップデートを実行できます。

今使っているバージョンから新しいバージョンのbaserCMSがリリースされると、サイドナビに「更新」タブが表示されます

新しいバージョンが出ているのに、表示されない場合は
システム基本設定>管理画面設定>アップデート通知のチェックがついているかご確認ください。

アップデート画面

baserCMSコア|アップデート画面」からアップデートができます。
アップデート通知を無効にしていても、URLを直接アクセスしたらアップデート画面は表示できます。

【URL】/baser/admin/baser-core/plugins/update

3.最新版をダウンロード

アップデート画面から最新版をダウンロードします。
PHP CLI の実行パスの箇所は、自動取得できる時は既に入力されていますが、入力されていないときは環境に合わせて入力します。

ロリポップなどのレンタルサーバーのパスや、環境のパスの調べ方などは公式ガイドに記載してあったりします。

▶ baserCMS5系公式ガイド:PHP CLI のパス
https://baserproject.github.io/5/introduce/php_path

ダウンロードが完了すると、「最新版のダウンロードが完了しました。アップデートを実行してください。」とでるので、アップデート実行に移りましょう!

⚠️ダウンロード失敗例

管理画面アップデート時に Composer のセキュリティチェックで停止する場合があります。

この記事を書いている時(2026年6月時点)で 5.2.2(この記事用に環境構築)→ 5.2.4へのアップデートでダウンロードに失敗しました。

現在のComposerのセキュリティチェックが以前より厳しくなっているらしく、タイミングによってはダウンロードやアップデート時に追加対応が必要な場合があります。

今回の原因としては、composer.jsonが、"cakephp/authentication": "3.0.*"で固定されていたため、脆弱性警告のある 3.0.x しか候補にできず、Composer に止められている状態でした。

composer.json の依存指定を確認し、"cakephp/authentication": "^3.0",へ変更してから再度ダウンロードを実行した所、無事にダウンロード完了することができました。

※公式の手順ではありませんので、あくまでも自己責任でお願いしますm(_ _)m

あれ?うまくいかないなぁ・・・って時や、アップデートできない?という時は、ベーサーフォーラムに同じ内容でスレッドがたっていたりするかもしれませんので、覗いてみることをオススメします!

▶ ベーサーフォーラム
https://forum.basercms.net/

4.アップデート実行

ダウンロード完了後、アップデートを実行します。

5.完了確認

プログラムバージョンデータベースバージョンが一致していることを確認します。


プログラム:5.2.4
データベース:5.2.4

無事にバージョンが揃っていたら完了!お疲れ様でした。
バージョン番号が合っていない場合やアップデートができない場合は後述をご覧ください。

Tips:データベースアップデート

アップデート後、プログラムバージョンとデータベースバージョンに差異が発生する場合があります。

例えば、

プログラムのバージョン:5.2.4
データベースのバージョン:5.2.3

のような状態です。

その場合は、「アップデートサポータープラグイン>スクリプト実行画面」の「DBのバージョン番号更新」からデータベースのバージョンもアップデートをすることができます。

【URL】/baser/admin/bc-update-supporter/support/script

Tips:シンボリックリンク

表示が崩れたりした場合は、シンボリックリンクを貼り直したりするのも良いかもしれません。
ユーティリティ画面からサーバーキャッシュを削除し、「シンボリックリンクを再作成」してみたら解決するかも・・・?
 

管理画面からアップデートできない場合

環境によっては、管理画面からのアップデートが実行できない場合があります。
その場合は、Git版(開発版)のアップデート方法でアップデートする方法もあります。
分割した次の記事をぜひご覧いただけると嬉しいです。

▶ 【Git版(開発版)】baserCMS5のアップデート方法!!
「パッケージ版」と記載が分かれていないところは、Git版と同じ流れになります。

 

関連記事

▶ baserCMS5系公式ガイド:オートアップデート
https://baserproject.github.io/5/functions/baser-core/auto_update

baserCMSやWebサイト構築のご相談など
お気軽にお問い合わせください

お問い合わせ
  • このエントリーをはてなブックマークに追加

AUTHOR

濱地 麻実

濱地 麻実 エンジニア

福岡県生まれ、福岡育ち、冬時期はもっぱら水炊きばかり作っています。
WEBの世界を知ってから、物事の見方がぐっと面白く広がり、それからずっとWEB制作の何かしらをしてきました。

「ああ、やっときゃよかったってことが絶対ないように。やったけどダメだったねってほうがマシ」
という宮崎駿さんの言葉を胸に、とりあえずチャンスがあったらやってみるスタイルで今に至ります。
時間も体力も環境も限りはありますが、今出来ることに尽力します。

お客様が、チームが、自分が安心できるお仕事を心がけて
日々頑張っていきたいと思っていますので、
どうぞ(引き続き)よろしくお願いいたします!

こんな記事も書いています