baserproject/bc-db-migrator

BcDbMigrator plugin for baserCMS

5.2.0 2026-01-05 07:12 UTC

MIT

README

Database Migrator for baserCMS

Installation

You can install this plugin into your baserCMS application using composer.

The recommended way to install composer packages is:

composer require baserproject/bc-db-migrator

Documentation

See baserCMS４のデータベースを変換

コマンドライン実行

コマンドラインからマイグレーションを実行できます。

bin/cake bc_db_migrator <zipファイルパス>

引数

• path（必須）: baserCMS 4 のバックアップZipファイルのパス。絶対パス・相対パスどちらでも指定可能です。

実行例

bin/cake bc_db_migrator basercms4_backup.zip

出力

• データベース: データは現在のbaserCMSデータベースに直接インポートされます。
• ファイル: 変換されたCSVファイルとスキーマファイルは、tmp/baserbackup_<バージョン>_<日時>.zip に圧縮されて保存されます（例: /var/www/html/tmp/baserbackup_5.1.0_20230101_120000.zip）。保存先パスはコンソールに出力されます。
• 一時ディレクトリ: マイグレーション完了後、作業用一時ディレクトリ（tmp/dbmigrator/）は自動的に削除されます。

パスワードの取り扱い

ユーザーパスワードの移行方法は、環境変数 HASH_TYPE の設定により異なります。

• HASH_TYPE が sha1 の場合:
  バックアップデータのパスワードがそのまま保持されます。マイグレーション後も従来のパスワードでログイン可能です。

• 上記以外の場合:
  セキュリティ上の理由から、すべてのユーザーのパスワードが新しいランダムな文字列に変更されます。新しいパスワードはマイグレーション完了時にコンソールに表示されますので、ログイン後に必ず変更してください。

License

Lincensed under the MIT lincense since version 2.0