运行 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() 预览,避免误删生产数据。
为什么 tinker 里查不到刚插入的数据
最常见原因是事务未提交或数据库连接配置不一致。Tinker 使用的是当前环境的数据库连接,但某些情况会复用连接池或受事务隔离级别影响。
排查要点:
- 确认
.env中DB_DATABASE指向的是你预期的库(比如不是testing或sqlite::memory:) - 手动插入后没
DB::commit()?Tinker 不自动 commit,DB::transaction()块外需显式提交 - 用
DB::connection()->getPdo()->inTransaction()检查是否还在事务中 - MySQL 默认
REPEATABLE READ隔离级别下,同一连接中事务开始后看不到其他连接的更改 —— 此时换一个 Tinker 进程重试更直观
如何在 Tinker 中调试复杂逻辑或复用代码
Tinker 支持多行输入(用回车换行,结束用两个空行),也支持从文件加载脚本:
- 写一段逻辑直接粘贴进去,支持
if、foreach、闭包等完整语法 - 保存为
debug.php,然后在 Tinker 中执行require 'debug.php'(路径相对于项目根目录) - 用
Ctrl+R搜索历史命令,Ctrl+A/Ctrl+E移动光标(依赖 PsySH 快捷键) - 想临时禁用日志/事件监听器?可在 Tinker 中执行
Event::fake()或Log::extend('null', function () { return new \Illuminate\Log\NullLogger; })
真正容易被忽略的是:Tinker 的变量作用域是会话级的,关闭窗口后所有变量丢失;而 config 修改(如 Config::set('app.debug', true))只在当前会话生效,不影响后续请求 —— 别指望靠它“永久打开 debug”。










