-
先用PHPCompatibility工具扫描ERROR级问题，再重点处理mysql_*函数删除、类型提示引发的TypeError、opcache注解失效及第三方包兼容性。
-
Symfony安全组件需显式配置防火墙、用户提供者、用户类契约和授权检查四要素：防火墙须匹配请求路径并启用form_login；用户提供者需正确配置实体及唯一字段；User类必须实现UserInterface等接口；权限判断须用AuthorizationCheckerInterface而非直接读取roles。
-
Windows下DockerDesktop挂载PHP源码性能差，根本原因是NTFS与Linux文件系统间两层转换导致小文件读写延迟；:cached在Windows无效，必须将代码移至WSL2ext4分区（如/home/user/app）并用其绝对路径挂载，才能降至微秒级延迟。
-
PHP中动态生成PDF常用四种方法：一、TCPDF支持UTF-8和HTML解析；二、Dompdf将HTML/CSS渲染为PDF；三、MPDF专优多语言排版；四、FPDF轻量级手动绘制，需额外配置中文字体。
-
执行LOADDATAINFILE时若报“Permissiondenied”或“open_basedirrestriction”，主因是PHP层open_basedir限制了文件路径；需确保目标路径（如/tmp/）明确列入open_basedir白名单，且配置后重载PHP-FPM/Apache/Nginx。
-
GD扩展未启用、中文显示异常、图片缓存、session未启动是验证码失败四大主因。需检查gd扩展、用imagettftext配UTF-8字体、禁用缓存头、首行调用session_start()并前置存储验证码。
-
宝塔面板安装PHP7.4卡在“等待安装”状态的常见原因是后台任务队列未触发、安装包下载失败或本地缓存污染；需清理缓存、更换国内镜像源（如ghproxy或南大镜像）、手动执行安装脚本并实时监控日志。
-
PHPSession丢失主因是会话ID未正确传递、存储异常或配置不一致；需检查session_start()调用时机、Cookie发送与回传、save_path可写性、配置一致性及跨域/子域Cookie作用域。
-
PHP应用迁移中require_once错误的根源是Linux文件系统大小写敏感，如uploadhandler.php与UploadHandler.php被视为不同文件；需修正代码中引用名与实际文件名大小写完全一致。
-
宝塔定时任务不执行的主因是脚本环境问题而非周期设置错误；需加#!/bin/bash、用绝对路径调用解释器、显式导出环境变量、启用日志并用timeout控制超时。
-
宝塔安装会因8888端口被占用而直接失败，需用sudoss-tulp|grep':8888'查占用进程；若不终止该进程，可前置设置BT_PORT=8889环境变量再执行安装命令，并同步放行新端口的防火墙与安全组规则。
-
宝塔面板邮件提醒必须配置正确SMTP，否则所有告警（安全扫描、磁盘超限等）均失效；需按邮箱服务商要求填对服务器、端口及加密方式，并使用授权码而非登录密码。
-
XAMPP官方不支持直接替换PHP文件夹升级，必须下载集成PHP8.2的新版安装包（如xampp-windows-x64-8.2.12-0-VC16），停用旧服务后全新安装并迁移htdocs和mysql/data目录，同时严格校验httpd.conf中LoadModule路径、php.ini中extension_dir及扩展启用状态，否则Apache将因模块不兼容而启动失败。
-
Webman的reload仅支持config/autoload.php中files列表声明的辅助文件（如functions.php）、纯函数式route.php路由，不支持配置文件、控制器类、vendor依赖及闭包路由，修改后需restart。
-
PHP数组合并后去空需先用array_merge合并再用array_filter过滤，因array_merge不处理空值；默认array_filter剔除所有falsy值，若需保留0或false等合法值，须自定义回调函数精准判断。
