PHP环境搭建后持续报错，需依次验证：一、PHP命令行是否可用及PATH配置；二、Web服务器是否加载PHP模块；三、php.ini是否加载且关键参数合理；四、常用扩展是否启用及依赖库完整；五、文件权限、路径拼写与语法是否正确。
如果您已完成PHP环境搭建，但运行脚本时持续报错，则问题可能源于安装路径未纳入系统识别、Web服务器未正确加载PHP模块、关键扩展缺失或配置文件未生效。以下是解决此问题的步骤：
一、验证PHP命令行是否可用并确认安装路径
该步骤用于确认PHP二进制文件是否被操作系统识别，排除因环境变量未配置导致的“php不是内部或外部命令”类错误。
1、打开命令提示符（Windows）或终端（macOS/Linux），输入 php -v 并回车。
2、若提示“命令未找到”或“不是内部或外部命令”，执行 where php（Windows）或 which php（macOS/Linux）检查PHP可执行文件是否存在。
立即学习“PHP免费学习笔记（深入）”；
3、若无输出，说明PHP未安装或未添加至PATH；前往PHP官网下载对应平台的线程安全（TS）版本，解压至固定路径（如 C:\php 或 /usr/local/php）。
4、将PHP主目录路径添加至系统环境变量PATH：Windows在“系统属性→高级→环境变量”中编辑Path；macOS/Linux在 ~/.zshrc 中追加 export PATH="/path/to/php:$PATH" 并执行 source ~/.zshrc。
5、重新打开终端，再次运行 php -v，确认输出版本号且无报错。
二、检查Web服务器是否成功集成PHP模块
该步骤用于排除PHP脚本被当作纯文本返回、浏览器显示源码而非执行结果的问题，核心是确认Apache或Nginx已正确加载并调用PHP解析器。
1、创建一个 info.php 文件，内容为 <?php phpinfo(); ?>，放入Web根目录（如 htdocs 或 /var/www/html）。
2、通过浏览器访问 http://localhost/info.php；若显示源码而非信息页，说明PHP未被Web服务器加载。
3、对于Apache：打开 httpd.conf，确认以下三行未被注释且路径正确：LoadModule php_module "C:/php/php8apache2_4.dll"、AddHandler application/x-httpd-php .php、PHPIniDir "C:/php"。
4、对于Nginx：检查 server 块内 location ~ \.php$ 区段是否包含 fastcgi_pass 127.0.0.1:9000 和 fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name。
5、保存配置后，重启服务：Windows下执行 httpd -k restart 或 nginx -s reload；Linux/macOS下执行 sudo systemctl restart apache2 或 sudo nginx -s reload。
三、确认php.ini配置文件已加载且关键参数合理
该步骤用于定位因配置项缺失或值异常引发的上传失败、内存溢出、时区错误等典型问题，需明确当前生效的php.ini路径及内容状态。
1、在浏览器中打开上一步创建的 info.php 页面，查找 Loaded Configuration File 行，记录其显示的实际路径。
2、若该行显示 None，说明php.ini未被加载；进入PHP安装目录，将 php.ini-development 或 php.ini-production 复制并重命名为 php.ini。
3、用文本编辑器打开该php.ini文件，搜索并修改以下关键项：display_errors = On、error_reporting = E_ALL、date.timezone = "Asia/Shanghai"、upload_max_filesize = 64M、post_max_size = 64M。
4、检查 extension_dir 路径是否指向真实存在的 ext 子目录（如 extension_dir = "C:/php/ext"），并确认该目录下存在 php_mysqli.dll 等必需文件。
5、保存php.ini后，重启Web服务器与PHP-FPM（如启用），再次访问 info.php，核对 Loaded Configuration File 是否显示有效路径，且各项修改已出现在对应配置节中。
四、排查常用扩展是否启用及依赖库完整性
该步骤用于解决“Class not found”、“Undefined function”等致命错误，这些错误多由扩展未启用、DLL/SO文件缺失或系统级运行库未安装所致。
1、在命令行执行 php -m，列出所有已启用的扩展；对比项目需求（如Laravel需 openssl、pdo_mysql、mbstring），确认其是否在列表中。
2、若缺失，打开php.ini，取消对应扩展前的分号注释：Windows下写 extension=openssl、extension=php_mysqli.dll；Linux/macOS下写 extension=mysqli、extension=mbstring。
3、Windows用户需特别注意：若启动时报 Unable to load dynamic library，则极可能缺少Visual C++运行库；前往微软官网下载并安装 Visual C++ 2019 Redistributable (x64)。
4、Linux用户若启用GD、cURL等扩展失败，需先安装系统依赖：Ubuntu/Debian执行 sudo apt install libpng-dev libjpeg-dev libfreetype6-dev，再重新编译或启用扩展。
5、修改php.ini后，务必重启Web服务器与PHP进程，然后再次运行 php -m 验证扩展是否出现在输出列表中。
五、检查文件权限、路径拼写及语法错误
该步骤用于捕获因目录不可写、相对路径解析失败或代码本身存在语法缺陷所引发的Warning、Fatal Error或500错误。
1、查看报错信息中提及的具体文件路径，确认该文件真实存在，且路径拼写完全一致（Linux下严格区分大小写）。
2、检查目标目录权限：Linux/macOS下执行 ls -ld /var/www/html，确认Web服务器用户（如 www-data 或 nginx）对该目录具有读取与执行权限；必要时运行 sudo chown -R www-data:www-data /var/www/html 与 sudo chmod -R 755 /var/www/html。
3、避免在代码中硬编码绝对路径；改用 __DIR__ 或 dirname(__FILE__) 动态获取当前目录，例如 require __DIR__ . '/config.php';。
4、对疑似出错的PHP文件，在命令行执行 php -l filename.php 进行语法扫描；若提示 No syntax errors detected，则排除语法问题。
5、若仍出现500错误，立即查阅Web服务器错误日志：XAMPP查看 apache/logs/error.log，LNMP查看 /usr/local/nginx/logs/error.log，宝塔面板在网站设置中直接打开“错误日志”，依据日志中精确的文件名与行号定位修复点。
