解决PHP命令行连接MySQL失败：php.ini路径不一致问题

问题现象与环境背景

在使用PHP进行数据库操作时，开发者可能会观察到一种矛盾现象：通过浏览器访问Web服务器（如Apache）管理的PHP脚本时，能够成功连接MySQL数据库；然而，直接在DOS/Windows命令提示符下运行相同的PHP脚本时，却会抛出致命错误：

该问题的典型复现环境如下：

• 操作系统：Windows Server 2003 / Windows XP/Vista/7/10 等Windows系列
• PHP版本：5.2.x 系列（注：PHP 7+已移除原生mysql扩展，改用mysqli或PDO，但原理相通）
• 数据库：MySQL 5.0 及以上
• Web服务器：Apache 2.0 或 IIS

用户通常在本地测试脚本时，仅包含一个简单的连接判断逻辑：

<?php
if ( !mysql_connect('localhost', 'username', 'password') ) {
    echo "连接失败!";
    exit;
}
echo "连接成功!";
?>

原因分析：双份php.ini的干扰

出现此类“功能丢失”的核心原因，往往不在于代码错误，而在于PHP在不同执行模式（SAPI）下寻找配置文件的行为差异。PHP存在两种主要的运行模式：

1. CGI/FastCGI模式（命令行CLI）：由 php.exe 启动，常见于DOS命令行、定时任务、自动化脚本。
2. Module模式（Web服务）：作为Apache/Nginx/IIS的模块加载，处理HTTP请求。

在许多Windows安装教程中，为了便于管理，用户会将PHP安装目录下的 php.ini 复制到系统的根目录（如 C:\Windows\ 或 C:\WINNT\），同时原始安装目录（如 D:\php\ 或 E:\wamp\bin\php\php5.2.0\）也保留了一份。这就导致了两个独立的环境变量路径：

• Web方式：Apache通常配置为读取系统级 C:\Windows\php.ini。如果该文件已开启 extension=php_mysql.dll，则Web页面正常。
• 命令行方式：CLI模式可能优先读取安装目录下的 D:\php\php.ini（如果该目录下有.ini文件且未被覆盖）。若该文件中未开启或注释了扩展模块，CLI执行就会报“函数未定义”。

诊断与排错步骤

要确认是否为配置文件路径不一致导致的问题，可以通过输出PHP当前加载的配置信息来进行对比。

第1步：生成环境信息快照

创建一个名为 check_env.php 的文件，内容如下：

<?php
phpinfo();
?>

第2步：分别在Web和命令行下执行

A. Web方式： 在浏览器中访问 http://localhost/check_env.php。
B. 命令行方式： 在CMD中运行：D:\php\php.exe check_env.php

第3步：对比Configuration File (php.ini) Path

查看两处输出的第一张表格，找到标题为 Configuration File (php.ini) Path 的行。你会观察到：

• Web模式下，该路径可能指向 C:\Windows。
• CLI模式下，该路径可能指向 D:\php 或其他安装目录。

接着，检查各自加载的 Loaded Configuration File 路径下的php.ini，搜索 extension 关键词。若Web环境的ini中启用了mysql扩展，而CLI环境的ini中被注释掉或未启用，即为症结所在。

解决方案

为了避免多份配置文件带来的维护混乱，建议采用以下标准做法：

清理冗余配置文件

在安装PHP for Windows时，官方推荐的标准步骤是：将PHP根目录下的 php.ini-recommended（或 php.ini-dist）复制一份并重命名为 php.ini。

如果之前已将 php.ini 复制到了 C:\Windows\ 目录下，请务必执行以下操作：

1. 备份风险提醒：在修改任何ini文件前，建议对现有的两份php.ini进行备份拷贝。
2. 删除本地副本：直接删除或重命名PHP安装目录（如 D:\php\）下的 php.ini 文件。确保系统中只存在唯一的一份有效配置文件（通常在 C:\Windows\ 下）。
3. 修正配置：打开那唯一的 C:\Windows\php.ini，确保以下行未被注释（去掉前面的分号 ;）：
   extension=php_mysql.dll

重启服务生效

修改ini文件后：

• 若是Web服务器，需重启Apache/IIS服务。
• 若是CLI模式，每次运行php.exe时都会即时读取最新的ini，无需额外重启进程，只需再次运行测试脚本即可。

验证结果

完成上述操作后，再次在命令行下运行测试脚本：

此时，命令行下应当也能正常识别 mysql_connect 函数，并返回“连接成功”。这表明CLI模式已经成功加载了正确的php.ini文件及其扩展模块。

总结来说，Windows下PHP的环境分离特性是导致此类“鬼畜”Bug的主因。保持全系统仅一份php.ini，并明确其存放位置，是避免Web端与CLI端行为不一致的最佳实践。

以上就是PHP命令行下mysql_connect函数未定义错误的详细内容，更多关于PHP环境配置排查的资料请关注本站其它相关文章！