PHP本地环境是否正常运行,最直接的判断方式是:能成功解析并执行php -v和php --ini,且Web服务能正确响应phpinfo()页面;需分别验证CLI与Web环境的PHP配置、模块加载及MySQL连通性。

PHP本地环境是否正常运行,最直接的判断方式是:能成功解析并执行 php -v 和 php --ini,且 Web 服务(如 Apache/Nginx)能正确响应 phpinfo() 页面。
检查 PHP 命令行是否可用
这是最基础的一环。很多问题其实卡在 PATH 没配对,或安装不完整。
-
php -v应输出版本号(如PHP 8.2.12),若报command not found或不是内部或外部命令,说明系统找不到 PHP 可执行文件 -
php --ini能确认配置文件位置,若提示Configuration File (php.ini) Path为空或指向不存在路径,php.ini可能未生成或被忽略 - Windows 用户常见问题是双版本冲突(如 XAMPP 自带 PHP 和独立安装的 PHP 同时存在),用
where php(Windows)或which php(macOS/Linux)看实际调用的是哪个
验证 Web 服务器能否解析 PHP
CLI 正常 ≠ Web 环境正常。Apache/Nginx 必须加载 PHP 模块,并配置好处理器映射。
- 在 Web 根目录(如
C:\xampp\htdocs\或/var/www/html/)新建test.php,内容为: - 通过浏览器访问
http://localhost/test.php,应完整显示 PHP 配置页;若看到源码、404、500 错误或空白页,说明 Web 服务未正确关联 PHP - Apache 常见缺失项:
LoadModule php_module和AddHandler application/x-httpd-php .php是否写入httpd.conf;Nginx 则需确认fastcgi_pass是否指向正确的php-fpmsocket 或端口
测试常见扩展是否启用
即使 phpinfo() 能打开,关键扩展(如 mysqli、pdo_mysql、curl)若被注释或编译缺失,后续项目会直接报错。
立即学习“PHP免费学习笔记(深入)”;
- 在
phpinfo()页面搜索关键词,确认mysqli、pdo、openssl等状态为enabled - 命令行中运行
php -m | grep -i "mysql\|pdo\|curl"(Linux/macOS)或php -m后人工查找(Windows) - 注意
php.ini有两个常见位置:Loaded Configuration File(运行时生效)和Scan for additional .ini files(额外加载目录),扩展启用指令(如extension=mysqli)必须写在前者或其包含的 ini 文件里
快速验证 MySQL 连接是否就绪
多数 PHP 项目依赖数据库,光有 PHP 不够,还得确认 MySQL/MariaDB 实例可连通。
- 命令行执行
mysql -u root -p,输入密码后能进入交互式终端,说明服务已启动且凭据有效 - 若提示
Can't connect to local MySQL server,先检查服务是否运行:sudo systemctl status mysql(Linux)、brew services list | grep mysql(macOS Homebrew)、或 Windows 服务管理器中MySQL80是否“正在运行” - PHP 中连接测试可简化为:
try {注意主机地址别写
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test', 'root', '');
echo "MySQL 连接成功";
} catch (Exception $e) {
echo "连接失败:" . $e->getMessage();
}
?>localhost(可能触发 socket 连接,而 socket 路径不对时会静默失败)
最容易被忽略的是:CLI 和 Web 使用的不是同一份 php.ini,导致一个环境扩展开着,另一个却报 Class not found;务必分别用 php --ini 和 phpinfo() 对照确认配置路径。











