thinkphp 5.1 老项目在 php 8.2 上需紧急适配三类核心问题：一是控制器参数类型提示（如 string $id）必须移除，否则触发 typeerror；二是动态属性赋值（如 $this->param = []）需升级至 v5.1.42+ 或显式声明属性，否则日志刷屏 deprecated；三是彻底清除已移除的 mysql_* 函数及扩展，改用 pdo/mysqli 并更新数据库配置。
ThinkPHP 5.1 老项目跑在 PHP 8.2 上，不是“能启动就行”，而是处处埋雷：刚打开首页就报 Fatal error: Uncaught TypeError，日志里刷屏 Deprecated: Creation of dynamic property，表单提交直接 500——这些都不是偶然，是 PHP 8.2 的语义收紧和 TP 5.1 的历史包袱撞在一起的结果。核心问题就三个：类型校验变严、动态属性被禁、底层函数被删。改代码前先看清哪几处不改就根本跑不起来。
控制器方法参数类型提示必须去掉
TP 5.1 控制器里常见 public function detail(string $id) 这种写法。PHP 8.2 下，如果 URL 没传 id，系统不会自动塞 null，而是直接抛 TypeError 中断请求。这不是 Bug，是 PHP 8 的强制行为。
- 逐个打开
app/controller/下所有 PHP 文件，把所有参数前的类型声明（string、int、array等）全部删掉，只留变量名，例如public function detail($id) - 业务层校验改用
$this->request->param('id', '', 'htmlspecialchars')或input('id/s')，保证数据安全不靠类型提示 - 别碰
declare(strict_types=1)—— TP 5.1 全局没开这个，强行加反而引发更多反射失败
动态属性警告要修复或屏蔽
PHP 8.2 禁止运行时给未声明的属性赋值。TP 5.1 的 Request、Model 类里有类似 $this->param = [] 的写法，会触发 Deprecated: Creation of dynamic property。虽然不中断执行，但日志爆炸、监控告警、上线被拒。
- 最稳妥：升级到
topthink/framework: ^5.1.42（官方已修复大部分动态属性问题），执行composer update topthink/framework - 若不能升级框架，在
public/index.php第一行加error_reporting(E_ALL ^ E_DEPRECATED);——仅限调试阶段，上线前必须改代码 - 检查自己写的模型或基类，把
$this->data = []、$this->filter = []这类写法，提前声明为protected $data = [];
mysql_* 函数和扩展必须清零
PHP 8.2 已彻底删除 mysql_connect()、mysql_query() 等全部 MySQL 扩展函数。只要代码里还残留一个，启动即 Fatal error: Call to undefined function mysql_connect()。
- 全局搜索：
grep -r "mysql_\|create_function\|each(" app/ extend/ config/，把所有匹配行全删或重写 - 检查
config/database.php，确认'type' => 'mysql'已改为'type' => 'pdo'或'type' => 'mysqli'；同时确保'pdo' => true开启 - 删掉 php.ini 中的
extension=php_mysql.dll（Windows）或extension=mysql.so（Linux），并确认pdo_mysql已启用：php -m | grep pdo
Facade 静态调用需补返回类型或换写法
像 Cache::get('key')、Log::info('msg') 这类门面调用，在 PHP 8.1+ 会报 Deprecated: Return type，因为 __callStatic 方法没声明返回类型。
- 临时方案：在对应 Facade 类（如
thinkphp/library/think/facade/Cache.php）中，给__callStatic方法加上: mixed返回声明 - 推荐方案：改用依赖注入，把
Cache::get('key')换成app('cache')->get('key')，既避开警告，也更利于测试和解耦 - 检查
composer.json中 PHP 版本约束是否更新为"php": "^7.2 || ^8.0"，否则composer update可能跳过兼容包
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
