一、PHP 版本不兼容（如语法错误Parse error: syntax error, unexpected ‘fn’ (T_FN)）
- 解决办法：
- 查看项目文档确认要求的 PHP 版本（如>=7.4），通过php -v检查当前版本。
- 在服务器 / 集成环境（如 PHPStudy、XAMPP）中切换至匹配版本（PHPStudy 中可直接在 “版本切换” 中选择）。
- 若无法升级 PHP，修改项目中高版本语法（如将箭头函数fn() => …改为普通匿名函数function() { … }）。
二、缺少必要 PHP 扩展（如Call to undefined function mysqli_connect()）
- 解决办法：
- 打开php.ini配置文件（PHPStudy 中可通过 “配置”→“php.ini” 快速访问），移除扩展前的注释符;（如;extension=mysqli改为extension=mysqli）。
- 重启 Web 服务器（Apache/Nginx）使扩展生效。
- 若扩展文件缺失，重新安装对应 PHP 版本的完整包（确保包含ext目录下的扩展文件）。
三、PHP 配置参数限制（如上传文件提示 “超出最大尺寸”）
- 解决办法：
- 在php.ini中调整参数：upload_max_filesize = 20M（文件上传最大尺寸）、post_max_size = 20M（POST 数据最大尺寸）、max_execution_time = 300（脚本最大执行时间）。
- 若使用 Nginx，还需修改nginx.conf中的client_max_body_size 20M;，避免服务器层面限制。
- 重启 Web 服务器和 PHP 服务使配置生效。
四、服务器软件冲突（如 Apache 与 Nginx 端口 80 冲突）
- 解决办法：
- 在集成环境中关闭其中一个服务器（如 PHPStudy 中停止 Apache，仅启动 Nginx）。
- 修改冲突服务器的端口（Apache 修改httpsd.conf中的Listen 8080；Nginx 修改nginx.conf中的listen 8080）。
- 通过netstat -ano | findstr “80”（Windows）或lsof -i:80（Linux）查看占用进程并关闭。
五、环境变量未配置（命令行执行php提示 “不是内部或外部命令”）
- 解决办法：
- 将 PHP 安装目录（如D:\phpstudy_pro\Extensions\php\php7.4.3nts）添加到系统环境变量Path中。
- Windows：右键 “此电脑”→“属性”→“高级系统设置”→“环境变量”→编辑Path添加路径；Linux/macOS：export PATH=$PATH:/usr/local/php/bin（写入~/.bashrc永久生效）。
- 重启命令行工具后验证：php -v是否正常输出版本。