PHP无原生ActiveRecord，需依赖第三方库或自行封装；Laravel的Eloquent是最成熟实现，亦可单独引入illuminate/database在非Laravel项目中使用。
PHP里没有原生ActiveRecord，得靠第三方库或自己封装
PHP标准库不提供 ActiveRecord 模式实现，不像Ruby on Rails或Laravel的Eloquent那样开箱即用。你看到的“PHP ActiveRecord”基本是独立项目（如 php-activerecord）或框架内置ORM的简化称呼。直接写 new User()->save() 而不引入任何库，会报 Class 'User' not found 或 Call to undefined method。
常见误操作是照搬其他语言写法，却没加载自动加载器、没配置数据库连接、也没声明模型继承关系。
-
php-activerecord需要手动注册自动加载（Autoloader::register()），且只支持 PHP 5.3–7.2，PHP 8+ 已不可用 - Laravel 的
Eloquent是最接近 ActiveRecord 的实现，但必须运行在 Laravel 或单独引入illuminate/database包 - 自己手写轻量版需至少实现：静态
find()、实例save()、delete()，以及通过类名推导表名的逻辑
用 illuminate/database 实现近似 ActiveRecord 的最小可行方案
如果你只需要核心行为（如 User::find(1)、$user->name = 'xxx'; $user->save();），又不想上全栈框架，illuminate/database 是目前最稳妥的选择——它把 Eloquent 抽离成独立组件，兼容 PHP 7.4–8.3。
关键步骤不是“写模型”，而是“搭好底层连接和容器”：
- 用 Composer 安装：
composer require illuminate/database - 初始化
Connection和DatabaseManager，再传给Model的setConnectionResolver() - 模型类必须
extends Illuminate\Database\Eloquent\Model，且默认按类名复数加小写映射表名（User→users） - 主键默认是
id，类型默认是int；若用uuid或复合主键，必须显式设置$primaryKey和$keyType
示例初始化代码片段：
use Illuminate\Database\Capsule\Manager as Capsule;
$capsule = new Capsule;
$capsule->addConnection([
'driver' => 'mysql',
'host' => 'localhost',
'database' => 'testdb',
'username' => 'root',
'password' => '',
]);
$capsule->setAsGlobal();
$capsule->bootEloquent();
// 此后 User::find(1) 才真正可用
自己写一个极简 ActiveRecord 基类要注意什么
真要从零封装，重点不在 CURD 方法本身，而在“如何让静态调用和实例操作共享同一套数据库逻辑”。很多手写版本卡在 self::table() 返回空、或 $this->attributes 没初始化就直接赋值。
- 必须用
static::class获取实际调用的子类名，再通过约定生成表名（比如去掉命名空间后首字母小写 + 加s） - 所有属性应存于
$this->attributes = []数组中，读写都走__get()/__set()，否则无法拦截变更、也无法批量填充 -
save()方法得先判断是 insert 还是 update —— 看$this->exists是否为 true，而这个值不能靠猜，得在find()或构造时明确设为true - 不处理事务、不预编译语句、不支持关联查询的话，这种基类只适合单表简单场景；一旦要
with('posts')或whereHas()，立刻得转向成熟 ORM
PHP 8+ 下 php-activerecord 报错 Class "ActiveRecord\ConnectionManager" not found 怎么办
这是典型兼容性断裂：原项目已停止维护，其命名空间和自动加载规则与 PSR-4 冲突，Composer 2.x 默认不再支持旧式 classmap 自动加载。
硬要继续用，只有两个现实选项：
- 降级到 Composer 1.x 并在
composer.json中显式启用 classmap："autoload": {"classmap": ["vendor/roxsoft/php-activerecord/lib"]}，再跑composer dump-autoload - 改用
illuminate/database并重写模型——虽然要改几行代码，但后续升级、调试、查文档都省心得多
更隐蔽的问题是：即使加载成功，php-activerecord 的 find_by_* 动态方法（如 User::find_by_email('a@b.c')）在 PHP 8.0+ 会触发 Deprecated: Required parameter $args follows optional parameter $method，因为其 __call() 签名没适配新语法。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
