はじめに
こんにちは!エンジニアのはまちです!
前回の記事では、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コア|アップデート画面」からアップデートができます。
アップデート通知を無効にしていても、URLを直接アクセスしたらアップデート画面は表示できます。
【URL】/baser/admin/baser-core/plugins/update
3.最新版をダウンロード
アップデート画面から最新版をダウンロードします。
PHP CLI の実行パスの箇所は、自動取得できる時は既に入力されていますが、入力されていないときは環境に合わせて入力します。
ロリポップなどのレンタルサーバーのパスや、環境のパスの調べ方などは公式ガイドに記載してあったりします。
▶ baserCMS5系公式ガイド:PHP CLI のパス
https://baserproject.github.io/5/introduce/php_path
⚠️ダウンロード失敗例
この記事を書いている時(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.完了確認
バージョン番号が合っていない場合やアップデートができない場合は後述をご覧ください。
Tips:データベースアップデート
その場合は、「アップデートサポータープラグイン>スクリプト実行画面」の「DBのバージョン番号更新」からデータベースのバージョンもアップデートをすることができます。
【URL】/baser/admin/bc-update-supporter/support/script
Tips:シンボリックリンク
管理画面からアップデートできない場合
環境によっては、管理画面からのアップデートが実行できない場合があります。
その場合は、Git版(開発版)のアップデート方法でアップデートする方法もあります。
分割した次の記事をぜひご覧いただけると嬉しいです。
▶ 「【Git版(開発版)】baserCMS5のアップデート方法!!」
※「パッケージ版」と記載が分かれていないところは、Git版と同じ流れになります。
関連記事
https://baserproject.github.io/5/functions/baser-core/auto_update
baserCMSやWebサイト構築のご相談など
お気軽にお問い合わせください