【Git版（開発版）】baserCMS５のアップデート方法！！

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

baserCMS５には、「パッケージ版（配布版）」と「Git版（開発版）」の違いがあります。
前回記事：開発者に聞く！baserCMS 5系のパッケージ版とGit版の違い

baserCMS５では、構成によってアップデート方法が異なります。

この記事では、Git版（開発版）のアップデート方法をご紹介します。
（5.2.2 → 5.2.4 と 5.2.3 → 5.2.4のバージョンアップ時の内容ベース）

パッケージ版でも管理画面でアップデートできない！という時は、
Git版（開発版）の流れでやる方法もあります。
本記事内で一緒にご紹介していますので、ぜひご覧いただけますと嬉しいです。
※「パッケージ版」と記載が分かれていないところは、Git版と同じ流れになります。

パッケージ版のアップデート方法は下記↓に記事を分割しています。についてご紹介します。

▶ パッケージ版のアップデート方法記事↓
【パッケージ版】baserCMS５のアップデート方法！

また、前回の記事でご紹介した通り、Git版（開発版）には
pluginsフォルダにbaserCMSのコアが入る構造になっているので、今この環境はGit版？パッケージ版？とどっちを使っているのか分からないときにはそちらも参照いただけると嬉しいです。

▶ 前回記事：開発者に聞く！baserCMS 5系のパッケージ版とGit版の違い

記載されていた手動アップデート手順をなぞりますが、ちょっと噛み砕いた下記順番で進めます。

1. アップデートサポータープラグインで問題がないか確認
2. 最新版の composer.json / composer.lock を配置
3. plugins ディレクトリ内の baserCMSコアのプラグイン群を手動で入れ替え
4. vendor ディレクトリを退避
5. composer install 実行でアップデート
6. BcUpdateSupporterプラグインで、アップデートスクリプトを実行
7. BcUpdateSupporterプラグインで、データベースのバージョンを更新

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

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

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

Git版（開発版）

パッケージ版

パッケージ版で構築されたbaserCMS（「手動アップデート」の方法が表示されない）であれば、
公式サイトから最新版をダウンロードしてくださいね。

▶ 公式サイト：最新バージョンダウンロードページ
https://basercms.net/packages/download/basercms/latest_version

Git版（開発版）では、baserCMS本体や関連プラグインが plugins 配下に含まれています。

そのため、Composerを実行するだけでは plugins/baser-core などのコアファイルは更新されません。

plugins 配下のbaserCMSコア関連プラグイン群を入れ替えます。
※パッケージ版はこの手順はスキップしてもOKです。

// plugins_bakというフォルダ名に変更
$mv plugins plugins_bak
//pluginsフォルダ（空）作成
$mkdir plugins

最新版のGit版（開発版）からplugins配下のbaserCMSコア関連のプラグイン郡を配置します。

plugins/baser-core
plugins/bc-admin-third
plugins/bc-blog
plugins/bc-content-link
plugins/bc-custom-content
plugins/bc-editor-template
plugins/bc-favorite
plugins/bc-front
plugins/bc-installer
plugins/bc-mail
plugins/bc-search-index
plugins/bc-seo
plugins/bc-theme-config
plugins/bc-theme-file
plugins/bc-uploader
plugins/bc-widget-area

※ 独自プラグイン（コア関連に関係なく入れていたプラグイン）は退避したplugins配下から戻しておくことをお忘れなく！
※ アップデートサポータープラグインも戻しておきましょうね

「手動アップデート手順」には一旦削除とありますが、万が一を考えて、バックアップ（退避）しておいた方が心臓には優しいです。

既存の vendor を退避します。

// vendor_bakというフォルダ名に変更
$mv vendor vendor_bak
// vendorフォルダ（空）作成
$mkdir vendor

$composer install

通常はこちらで問題ありません。
※ Docker環境を利用している場合は、ComposerコマンドはホストOSではなくコンテナ内で実行します。

サーバー環境によっては、開発用パッケージ（require-dev）のインストール時にエラーとなる場合があります。  
その場合は、開発用パッケージを除外して実行します。

$composer install --no-dev

今回の環境では composer install のみでアップデートできましたが、  
以前対応した環境では xdebug などの開発用拡張がインストールされておらず、エラーとなってアップデートできなかったので、composer install --no-dev を利用してアップデートを行った経緯があります。

アップデート方法の違いをまとめると、以下のようになります。

baserCMS５には、

• 管理画面アップデート
• Composerアップデート

という2つのアップデート方法がありました。

パッケージ版では管理画面からアップデートできるため、比較的手軽に更新できます。
一方で、Git版（開発版）では最新版ファイルの配置とComposerによる更新が基本となります。

今回のアップデート方法をまとめた本記事では、パッケージ版とGit版（開発版）の両環境で、
5.2.2 → 5.2.4 と 5.2.3 → 5.2.4 で実際に検証した内容をもとに紹介しました。

DBやプログラムのバックアップは忘れずに！安心安全なベーサーライフを♪