bolt/yaml-migrations

A library to facilitate migrations for YAML configuration files

2.1.0 2025-10-07 13:39 UTC

Requires

• php: >=8.1
• composer/semver: ^3.2
• symfony/console: ^5.1 || ^6.0 || ^7.0
• symfony/filesystem: ^5.1 || ^6.0 || ^7.0
• symfony/finder: ^5.1 || ^6.0 || ^7.0
• symfony/var-dumper: ^5.1 || ^6.0 || ^7.0
• symfony/yaml: ^5.1 || ^6.0 || ^7.0
• webimpress/safe-writer: ^2.1

Requires (Dev)

• phpstan/phpstan: 2.1.28
• phpunit/phpunit: ~10
• rector/rector: 2.1.7
• symplify/easy-coding-standard: ^12.5

MIT

• Bolt developers
• Bob den Otter

README

A library to facilitate migrations for YAML configuration files

This repository was forked from bobdenotter/yaml-migrations and updated to be used with newer versions of bolt/core.

List available migrations

bin/yaml-migrate available

Run migrations

Standalone:

bin/yaml-migrate process -c config.yaml -v

The configuration file can be configured:

bin/yaml-migrate process -c config.yaml

Run a single file forcibly, convenient for testing:

bin/yaml-migrate process -v -f m_replace.yaml

Run it in the context of a Bolt installation:

vendor/bolt/yaml-migrations/bin/yaml-migrate process -c vendor/bolt/core/yaml-migrations/config.yaml -v

Tip: Reset the checkpoint and output:

echo '1.0.0' > sample/migrations/checkpoint.txt && rm -rf sample/target/*