在PHP项目开发中，数据库连通性是核心基础，很多连接报错其实可以在编写PHP代码前通过命令行提前排查。不同数据库的命令行测试方式略有差异，下面分别介绍常用数据库的操作方法。
MySQL/MariaDB数据库命令行测试
MySQL是最常用的PHP搭配数据库，测试连通性可以直接使用自带的mysql客户端工具，具体步骤如下：
步骤1：确认数据库服务运行状态
先检查数据库服务是否正常启动，Linux系统可以执行以下命令：
# 查看MySQL服务状态 systemctl status mysql # 如果服务未启动，执行启动命令 systemctl start mysql
步骤2：使用命令行连接数据库
执行以下命令尝试连接，替换对应的参数：
mysql -h 数据库地址 -P 端口号 -u 用户名 -p # 示例：连接本地3306端口的MySQL，用户名为root mysql -h 127.0.0.1 -P 3306 -u root -p
执行后会提示输入密码，输入正确密码后如果能进入mysql>交互界面，说明连通性正常。如果报错，常见错误和原因如下：
| 报错信息 | 可能原因 |
|---|---|
| Can't connect to MySQL server on 'xxx' | 数据库地址或端口错误，服务未启动，防火墙拦截端口 |
| Access denied for user 'xxx'@'xxx' | 用户名或密码错误，该用户没有对应主机的访问权限 |
| Unknown database 'xxx' | 指定的数据库不存在 |
PostgreSQL数据库命令行测试
如果使用PostgreSQL作为数据库，测试连通性可以使用psql工具：
# 连接PostgreSQL数据库 psql -h 数据库地址 -p 端口号 -U 用户名 -d 数据库名 # 示例：连接本地5432端口的test数据库，用户名为postgres psql -h 127.0.0.1 -p 5432 -U postgres -d test
输入密码后能进入test=#交互界面即说明连通正常，报错原因和MySQL类似，可对照排查。
PHP连接数据库前的额外检查
命令行测试连通正常后，还需要确认PHP环境的相关配置，避免后续代码执行报错：
- 确认PHP已安装对应数据库的扩展，比如MySQL需要
mysqli或pdo_mysql扩展，PostgreSQL需要pgsql或pdo_pgsql扩展，可以通过php -m命令查看已安装的扩展。 - 确认PHP代码中的连接参数和命令行测试时使用的参数完全一致，包括地址、端口、用户名、密码、数据库名。
- 如果数据库不在本地，确认PHP所在服务器到数据库服务器的网络连通性，可以通过
ping 数据库地址和telnet 数据库地址 端口号命令验证。
PHP连接数据库示例代码
命令行测试通过后，可以使用以下PHP代码验证最终连接效果：
MySQLi方式连接
<?php
$host = '127.0.0.1';
$port = 3306;
$user = 'root';
$password = 'your_password';
$database = 'test';
// 创建连接
$conn = new mysqli($host, $user, $password, $database, $port);
// 检查连接
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "MySQL数据库连接成功";
$conn->close();
?>
PDO方式连接
<?php
$host = '127.0.0.1';
$port = 3306;
$user = 'root';
$password = 'your_password';
$database = 'test';
try {
$dsn = "mysql:host=$host;port=$port;dbname=$database;charset=utf8mb4";
$pdo = new PDO($dsn, $user, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "PDO连接MySQL数据库成功";
} catch (PDOException $e) {
echo "连接失败: " . $e->getMessage();
}
?>
执行以上PHP代码如果输出连接成功，说明整个数据库连通流程完全正常，可以开展后续的开发工作。
PHP数据库_connectivity命令行测试MySQL修改时间：2026-06-10 14:39:31