php 8.6项目使用doctrine migrations时,应把连接配置、迁移路径和版本表一起纳入版本管理,先对测试数据库执行状态检查和sql预览,再运行迁移。下面采用3.9系列命令行配置;事务是否能回滚ddl取决于数据库,不能仅凭transactional配置保证所有改表都可撤销。

PHP手册中的Configuration
准备迁移目录和测试连接
composer require doctrine/migrations:^3.9
mkdir -p migrations
<?php // migrations-db.php,仅由命令行读取
return ['driver'=>'pdo_pgsql','host'=>'127.0.0.1','port'=>5432,
'dbname'=>'app_test','user'=>getenv('DB_USER'),'password'=>getenv('DB_PASSWORD')];
<?php // migrations.php
return [
'migrations_paths'=>['App\Migrations'=>__DIR__.'/migrations'],
'table_storage'=>['table_name'=>'doctrine_migration_versions'],
'all_or_nothing'=>true,'transactional'=>true,
];
vendor/bin/doctrine-migrations generate
vendor/bin/doctrine-migrations status
vendor/bin/doctrine-migrations migrate --dry-run
vendor/bin/doctrine-migrations migrate

PHP手册中的Managing Migrations
迁移文件要描述可审查的数据库变化
generate生成带版本号的类文件,不会自动推导全部业务变更。继承AbstractMigration,在up方法中通过addSql加入目标数据库适用的语句;例如PostgreSQL测试库的CREATE TABLE app_note (id BIGINT PRIMARY KEY, body TEXT NOT NULL)。down应按实际恢复能力编写,不能为了“有回滚”而无条件删除生产数据。
预览不代替备份和回滚演练
核对status中的数据库名称、已执行版本和待执行版本,确认连接的是隔离测试库。dry-run用于检查待执行SQL,不应把它当成任何环境都完全不会初始化元数据的沙箱。MySQL部分DDL会隐式提交;大表加索引还要评估锁、空间与在线变更方式。正式变更前保留恢复点、演练兼容发布顺序,并记录实际执行版本,失败后先确认数据库与版本表状态再决定续办。
Drizzle ORM 是一个轻量级的 TypeScript ORM,提供类型安全的 SQL 模式声明、关系型和类 SQL 查询构建器,以及自动生成迁移。其压缩后仅 7.4kb,且无依赖项,支持 PostgreSQL、MySQL 和 SQLite,包括 Neon、Turso 和 Cloudflare D1 等无服务器数据库。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










