运行 php artisan tinker 即可启动 Laravel Tinker,它基于 PsySH 提供友好交互环境;Laravel 8+ 默认内置,旧版需手动安装 psy/psysh,常见问题包括路径错误、依赖缺失、中文乱码等。
怎么启动 Laravel Tinker
运行 php artisan tinker 即可进入交互式 PHP 环境,它默认使用 PsySH,比原生 PHP CLI 更友好。注意:Laravel 8+ 默认已内置,旧版本需确认是否安装了 psy/psysh(通过 composer require --dev psy/psysh 补上)。
常见卡住或报错场景:
- 终端无响应 → 检查是否在项目根目录下执行,且
.env配置正确(尤其数据库连接,Tinker 启动时会加载服务提供者) -
Class 'Psy\Shell' not found→ 缺少psy/psysh,运行composer require --dev psy/psysh - Windows 下中文乱码 → 在 CMD 中先执行
chcp 65001,或改用 Git Bash / Windows Terminal
Tinker 中如何加载模型和执行查询
Tinker 不是普通 PHP CLI,它自动引入了 Laravel 的应用上下文,所以可以直接用 Eloquent 模型、Facade 和依赖注入功能。
典型操作示例:
-
User::first()→ 查第一条用户记录(会触发实际数据库查询) -
app('cache')->get('key')→ 调用缓存门面 -
resolve(\App\Services\UserService::class)->syncAll()→ 解析并调用自定义服务 -
DB::table('users')->where('id', 1)->first()→ 使用 Query Builder
⚠️ 注意:Tinker 默认开启「实时执行」,每行代码都会立即运行。写循环或修改数据前务必加 dd() 或 dump() 预览,避免误删生产数据。