php 8.1+ 下 mysql_connect 等函数因扩展移除而报错，tp 5.0 需替换为 pdo 或 db 类；tp 5.1 在 8.2+ 因动态属性触发 deprecated，建议升级至 5.1.42+ 或 6.x；mbstring.func_overload 开启会导致字符串函数异常，应设为 0；tp 6.0.10 前 __invoke 方法签名不兼容 php 8.1+，需升至 6.0.13+。
PHP 8.1+ 下 mysql_connect 类函数直接报错：已移除扩展
ThinkPHP 5.0 及更早版本若手动调用过时的 MySQL 扩展函数（如 mysql_connect、mysql_query），在 PHP 8.1+ 中会触发 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。该扩展自 PHP 7.0 起已被废弃，8.0 正式移除。
实操建议：
- 全局搜索项目中所有
mysql_开头的函数调用（注意大小写），包括第三方插件或遗留模块 - 确认是否真在用原生 MySQL 扩展——绝大多数 TP 项目实际走的是 PDO 或 ThinkPHP 自封装的 Db 类，这类调用只是历史残留
- 若确有依赖，必须重写为 PDO 或
think\Db接口；例如把mysql_query("SELECT * FROM user")改为\think\Db::query("SELECT * FROM user") - 检查
php.ini是否误启用了extension=php_mysql.dll（Windows）或extension=mysql.so（Linux），删掉或注释掉该行
TP 5.1 在 PHP 8.2+ 报 Deprecated: Creation of dynamic property
PHP 8.2 引入严格属性声明机制，对未显式定义的动态属性赋值会触发弃用警告（Deprecated），而 ThinkPHP 5.1 的部分核心类（如 Request、Model）存在运行时动态添加属性的行为，例如 $this->param = []。
实操建议：
- 升级到 ThinkPHP 5.1.42+（官方已修复多数动态属性问题），或直接切到 6.x 版本（原生支持 PHP 8.2+）
- 若暂不能升级框架，可在
public/index.php顶部临时加error_reporting(E_ALL ^ E_DEPRECATED)屏蔽警告（仅限调试阶段，不可上线） - 检查自定义类中是否有类似
$this->data = []的写法，改为提前声明：protected $data = []; - 留意 IDE 提示或静态分析工具（如 PHPStan）报告的 “Dynamic property” 问题，它们往往指向真实兼容性风险点
mbstring.func_overload 开启导致字符串函数行为异常
PHP 7.2+ 已废弃 mbstring.func_overload 配置项，但某些旧服务器仍保留该设置（值为 1–7）。开启后，strlen、strpos 等函数会被 mbstring 版本覆盖，而 ThinkPHP 内部逻辑（尤其是路由解析、URL 解码）依赖原始字节语义，容易出现乱码、匹配失败或无限重定向。
实操建议：
- 执行
php -i | grep mbstring.func_overload查看当前值，确认是否为Off或未定义 - 在
php.ini中显式设为mbstring.func_overload = 0（不推荐设为 Off，部分 PHP 版本不识别） - 若无法改全局配置，可在入口文件开头加
ini_set('mbstring.func_overload', 0); - 特别注意 Nginx + PHP-FPM 场景下，
php.ini和www.conf中的php_admin_value可能覆盖设置，需一并检查
TP 6.0+ 的 __invoke 方法签名与 PHP 8.1+ 严格性冲突
PHP 8.1 要求魔术方法（如 __invoke）的参数类型声明必须与父类/接口完全一致。ThinkPHP 6.0.10 之前版本中，think\middleware\CheckRequestCache 等中间件的 __invoke 方法缺少返回类型声明（: Response），会导致 Declaration of ... must be compatible with ... 错误。
实操建议：
- 强制升级至 ThinkPHP 6.0.13+ 或 6.1.x 最新版，该问题已在 6.0.13 中修复
- 若使用自定义中间件，检查其
__invoke方法签名是否含完整类型提示，例如：public function __invoke(Request $request, \Closure $next): Response - 不要试图手动补全类型声明却忽略父类——TP 6 的中间件接口定义在
think\contract\MiddlewareInterface，必须严格遵循 - 该错误通常只在启用 OPcache 且代码变更后未清理缓存时复现，遇到时先执行
php artisan opcache:clear或重启 PHP-FPM
真正卡住升级的往往不是大功能缺失，而是某处 ini_set 调用、某个被遗忘的 create_function 字符串回调，或者 Composer autoload 里一个没更新的 psr-4 映射。逐个验证比通读升级文档更有效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
