直接运行 composer require doctrine/orm 即可，composer 会自动安装全部依赖；若仅需查配置、写日志等简单操作，应选 medoo 或纯 pdo，避免 orm 启动开销。
直接运行 composer require doctrine/orm 就够了
这是当前（2026年）唯一推荐的安装方式，不需要手动补装 doctrine/dbal 或 doctrine/persistence——Composer 会自动解析并拉取全部必需依赖。你也不需要提前写 composer.json、指定版本号，除非有明确的兼容性要求（比如 PHP doctrine/orm:^2.13）。
常见错误：Class 'DoctrineORMEntityManager' not found，90% 不是 autoload 没加载，而是包根本没装成功：
- 包名拼错：比如
doctrine/ORM（大小写敏感）、doctrine/orms（多字母）、doctrine/orm-dev（不存在） - 没从 packagist.org/packages/doctrine/orm 复制包名，靠记忆手打
- 检查
vendor/composer/autoload_psr4.php是否真有"Doctrine\ORM\" => [...]映射；没有 = 安装失败，不是 require 路径问题
$isDevMode 不只是开发/生产开关，它决定底层行为
这个布尔参数直接影响元数据扫描、代理类生成和缓存策略，不能简单理解为“开发设 true，上线改 false”就完事。
-
$isDevMode = true：每次请求都重新解析注解/Attributes、不生成代理类、用临时文件数组缓存——适合调试，但响应慢、不适合压测 -
$isDevMode = false：强制要求提前生成代理类（否则启动报错），并按 APC → Xcache → Memcached → Redis 顺序查找可用缓存驱动 - 生产环境必须设为
false，且需配合vendor/bin/doctrine orm:generate-proxies预生成代理类
MySQL 连接配置里 driver 必须写 pdo_mysql
写成 mysql、mysqli 或漏掉 pdo_ 前缀，都会导致 EntityManager::create() 初始化失败，报错类似 Driver "mysql" not supported。
其他常见驱动值：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- SQLite：必须用
pdo_sqlite，不是sqlite - PostgreSQL：用
pdo_pgsql - SQL Server：用
pdo_sqlsrv或pdo_odbc（取决于扩展）
完整连接数组示例：
$conn = [
'driver' => 'pdo_mysql',
'host' => '127.0.0.1',
'user' => 'root',
'password' => 'pass',
'dbname' => 'myapp',
];
只读几条数据？别硬上 doctrine/orm
如果你的场景只是查配置表、写一条日志、验证 token，doctrine/orm 的启动开销（元数据扫描、代理类加载、UnitOfWork 初始化）反而拖慢首字节响应时间。
更轻量的替代方案：
-
composer require medoo/medoo：零配置、单文件、无 autoload 延迟，$db->select('users', '*')一行搞定 - 纯 PDO + 自己封装：适合对性能极度敏感或结构极简的脚本
- 如果已在用 Symfony/Slim，且已有 Doctrine Bundle 或 DBAL 基础，再考虑 ORM 层
Doctrine ORM 真正适合的场景是：实体关系复杂、需要生命周期事件（如 prePersist）、要写 DQL 查询、或已有成熟框架生态支撑——不是所有数据库操作都该走 ORM。
