PHP 8.5 尚未发布，不存在原生 ORM；所有 ORM 均为第三方库，Doctrine 和 Eloquent 在 PHP 8.3+ 下需注意属性导入、只读类限制、连接配置、时间戳依赖及类型声明等兼容性要点。
PHP 8.5 根本没有原生 ORM，别被版本号带偏
PHP 8.5 尚未发布（截至 2024 年中，最新稳定版是 PHP 8.3），更不存在“PHP 8.5 内置 ORM”这回事。所有 ORM 都是第三方库，和 PHP 版本是松耦合关系——只要兼容 PHP 8.1+，就能在 8.3 或未来 8.5 上跑。关键不是“PHP 8.5 用什么 ORM”，而是“你项目需要什么能力，选哪个 ORM 能稳跑在现代 PHP 上”。
Doctrine ORM 在 PHP 8.3+ 下的实操要点
Doctrine 是最成熟的全功能 ORM，对 PHP 8.3+ 支持良好，但升级后有几个硬坑要手动处理：
-
#[Id]、#[Column]这类属性（Attribute）必须显式导入，比如use Doctrine\ORM\Mapping\Id;，否则会报Attribute "Id" does not exist - PHP 8.3 的只读类（
readonly class）不能直接用作实体，因为 Doctrine 需要动态代理和属性写入；得用final class+ 手动控制 setter -
EntityManager::flush()在严格模式下可能触发TypeError：如果关联实体没设好级联（cascade={"persist"}），错误信息是Expected argument of type "App\Entity\X", "null" given - 性能上，Doctrine 默认开启二级缓存时，PHP 8.3 的 OPCache JIT 可能和某些代理类生成逻辑冲突，建议关掉 JIT 测试：
opcache.jit=0
Eloquent 在非 Laravel 项目里怎么用（PHP 8.3+）
Eloquent 本质是可独立使用的组件，但脱离 Laravel 后，很多“理所当然”的东西得自己搭：
- 数据库连接不能只靠
new Connection(...)，必须用ConnectionResolver注册为默认连接，否则Model::find()会抛RuntimeException: No database connection configured - 自动时间戳（
$timestamps = true）依赖Carbon，PHP 8.3+ 需确保carbonphp/carbon-doctrine-types版本 ≥ 3.0，否则created_at字段入库变0000-00-00 00:00:00 - 批量插入（
Model::upsert()）在 MySQL 8.0.19+ 才真正支持ON DUPLICATE KEY UPDATE，低版本会退化成多条INSERT ... SELECT，容易锁表 - 模型监听器（
static::creating()）在 PHP 8.3 的严格类型下，闭包参数必须声明类型，比如static::creating(fn (User $user) => ...)，漏写User会报Fatal error: Uncaught TypeError
选 Doctrine 还是 Eloquent？看这三点
别纠结“谁更新”，看实际卡点：
立即学习“PHP免费学习笔记（深入）”；
- 团队熟悉度：Eloquent 上手快，但复杂查询（如多对多中间表条件聚合）写起来反直觉；Doctrine 写 DQL 更贴近 SQL 逻辑，但学习曲线陡
- 数据库迁移：Doctrine Migrations 有完整版本管理和回滚，Eloquent 的
php artisan migrate离开 Laravel 就得自己包装命令行入口，维护成本高 - 类型安全：Doctrine 原生支持 PHP 8.1+
enum映射（@Enum(UserStatus::class)），Eloquent 目前仍需靠访问器/修改器模拟，容易漏校验
真正在意类型推导和 IDE 支持的项目，Doctrine 的实体注解 + PHPStan 扩展配合更稳；要是小项目快速出活、团队全是 Laravel 背景，Eloquent 搭个 capsule 也够用——但得提前踩过连接和时间戳那几个坑。
