Composer怎么安装Laravel Auditing_Composer如何引入owen-it/laravel-auditing自动记录模型数据变更日志【教程】-composer-PHP中文网

直接用 Composer 安装 owen-it/laravel-auditing：composer require owen-it/laravel-auditing；注意包名拼写准确，安装后自动注册服务提供者，需发布迁移并运行 php artisan migrate 创建 audits 表，模型启用审计需 use Auditable trait 且实现 AuditableContract 接口。

composer怎么安装laravel auditing_composer如何引入owen-it/laravel-auditing自动记录模型数据变更日志【教程】

直接用 Composer 安装 owen-it/laravel-auditing

它不是 Laravel 官方包，但维护活跃、Laravel 9/10 兼容良好，安装就是一条命令：composer require owen-it/laravel-auditing。注意别拼错包名——owen-it/laravel-auditing 中的 owen-it 是作者 GitHub 组织名，不是 owenit 或 owen，拼错会报 Package not found。

安装后自动注册服务提供者（Laravel 5.5+ 支持自动发现），无需手动加到 config/app.php；但如果你用的是 Laravel 5.4 或禁用了自动发现，得手动在 providers 数组里加一行：OwenIt\Auditing\AuditingServiceProvider::class。

发布迁移文件并运行 migrate

审计日志要存进数据库，必须先生成并执行迁移。执行：php artisan vendor:publish --provider="OwenIt\Auditing\AuditingServiceProvider" --tag="migrations"。这会把 create_audits_table.php 迁移文件复制到 database/migrations/ 目录下。

常见错误：没运行这步就直接 php artisan migrate，结果报错 Base table or view not found: 1146 Table 'xxx.audits' doesn't exist。迁移文件生成后，再跑一次 php artisan migrate 就行。

如果项目已上线，别直接删库重迁——audits 表可独立存在，不影响主业务表
默认迁移使用 bigIncrements，适合高并发场景；如确定数据量极小，可手动改成 increments 减少索引体积
表名固定为 audits，不建议改；若真要改，需同时在 config/audit.php 里调整 table 配置项

给模型开启审计功能

不是所有模型都要审计，只在需要记录变更的模型里加 Auditable trait 和接口即可。例如：

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

use OwenIt\Auditing\Contracts\Auditable as AuditableContract;
use OwenIt\Auditing\Auditable;

class User extends Model implements AuditableContract
{
    use Auditable;
}

关键点：

必须实现 AuditableContract 接口，否则运行时会报 Class name must be a valid object or a string 类错误
Auditable trait 默认监听 created、updated、deleted、restored 四个事件；想关掉某个（比如不想记 soft-delete 的 deleted），在模型里设：protected $auditInclude = ['name', 'email']; 或 protected $auditExclude = ['password'];
如果模型用的是自定义主键（非 id），记得设置：protected $auditInclude = ['your_primary_key']; 并确保该字段被包含在审计字段中，否则日志里 auditable_id 可能为空

审计日志查不到？检查配置和软删除行为

最常遇到的情况是：改了数据，但 audits 表里没新记录。优先排查这三处：

模型是否真的用了 Auditable trait 且实现了接口——漏一个就完全不触发
是否启用了软删除（SoftDeletes）但没在模型里加 use SoftDeletes;？此时 delete() 实际是 update 操作，而默认审计不监听 updated 对 soft-deleted 记录的变更，需显式开启：protected $auditInclude = ['deleted_at'];
配置文件 config/audit.php 是否被意外修改？尤其 enabled 设为 false，或 implementation 指向了错误类——首次发布配置后，Laravel 不会自动覆盖已有文件，改配置得手动确认