Laravel 10 是带强制门槛的演进版本，PHP 8.1 为硬性依赖，enum 等新语法使低版本无法启动；Feature::define 必须在服务提供者中用闭包定义以支持动态灰度；Process::run() 返回 ProcessResult 对象，需显式调用 output()；路由缓存不支持闭包路由，须改用控制器或 to(fn()) 语法；make:model 默认不生成 $fillable，需手动声明以防 MassAssignmentException。
直接说结论：Laravel 10 不是“怎么用”的问题，而是“哪些地方必须改、哪些可以立刻用、哪些容易掉坑里”的问题。它不是平滑升级，而是带强制门槛的演进版本。
PHP 8.1 是硬门槛，不是可选项
所有 composer create-project laravel/laravel 或升级到 Laravel 10 的项目，必须运行在 PHP 8.1+ 环境下。低于该版本会直接报错，连 artisan 都无法启动。
- 常见错误现象：
ParseError: syntax error, unexpected token "enum"—— 这是因为框架源码已大量使用 PHP 8.1 的enum语法 - 影响范围：不只是你写的代码，
vendor/下的 Laravel 核心、依赖包（如symfony/console）都依赖 PHP 8.1 特性 - 迁移建议：
– 先确认服务器或 Docker 环境的 PHP 版本
– 若用 Homestead/Valet，需更新至支持 PHP 8.1 的版本
– 本地开发推荐使用phpbrew或asdf切换版本，避免全局污染
Feature Flags 用 Feature::define() 而不是配置文件
Laravel Pennant 不是“开关配置”，而是一个运行时可变的状态管理器。它不读 .env 或 config 文件，定义逻辑写在服务提供者里，执行时机在请求生命周期中。
- 典型误用：
Feature::define('new-ui', env('NEW_UI_ENABLED', false))—— 这会让标志变成静态值，失去 A/B 测试意义 - 正确姿势：
– 在AppServiceProvider::boot()中定义闭包逻辑
– 闭包可接收User、Request等上下文参数，实现用户级灰度
– 示例：Feature::define('new-ui', fn (User $user) => $user->isBetaTester()) - 注意点：
– 默认不持久化，需配合数据库驱动（composer require laravel/pennant后运行php artisan pennant:install）
– 未安装驱动时，所有Feature::active()调用都走内存，重启即失效
Process::run() 替代 shell_exec() 但不能直接 echo
新 Process 门面返回的是 Illuminate\Process\ProcessResult 实例，不是字符串。直接 echo Process::run('ls') 会触发对象转字符串的默认行为（输出空），不是你想要的结果。
- 常见错误现象：
echo Process::run('pwd')->output();输出为空 —— 实际是没调用output()前就隐式转换了 - 正确写法：
–$result = Process::run('ls -la');
–if ($result->successful()) { echo $result->output(); }
– 或链式：Process::run('ls')->throw()->output()（失败时抛异常） - 关键差异：
–Process::timeout(5)->run()会真正中断进程，而exec()超时后子进程可能还在后台跑
–Process::forever()适合长任务（如日志监听），但需手动处理信号和资源释放
路由缓存 route:cache 对闭包路由无效
如果你的 routes/web.php 或 routes/api.php 里还混着闭包定义，比如 Route::get('/health', function () { return 'ok'; });，那么 php artisan route:cache 会静默失败或生成不完整缓存。
- 验证方式：
php artisan route:list显示正常，但缓存后访问 404 —— 说明部分路由没被加载进缓存 - 根本原因：Laravel 10 的路由缓存只序列化控制器方法和类名，不支持闭包（PHP 无法序列化匿名函数）
- 解决路径：
– 把所有闭包路由移到控制器中（哪怕只是单行返回）
– 或改用Route::get('/health')->to(fn () => 'ok');（Laravel 10 支持此语法，且可缓存）
– 检查第三方包注册的路由，有些包仍用闭包注册，需升级或 patch
最常被忽略的一点：Laravel 10 的 make:model 默认不再生成 $fillable，而是靠类型声明 + 构造函数注入来约束属性。如果你还依赖 create($data) 批量赋值，记得手动加 protected $fillable = [...];，否则会抛 MassAssignmentException。
