当mysql数据库服务器的监听端口发生变更时，所有连接该数据库的客户端应用，包括php应用程序、mysql命令行工具以及phpmyadmin等，都必须同步更新其连接配置以指定新的端口号。未能正确配置将导致连接失败，影响应用的正常运行。本文将详细指导如何在不同客户端环境中正确配置mysql连接端口。
在开发和部署Web应用程序时，PHP与MySQL数据库的结合是常见的技术栈。然而，当MySQL服务器的默认端口（通常是3306）被修改为其他端口（例如1308）时，如果不相应地更新客户端配置，就会出现连接错误。这通常发生在同一台机器上运行多个MySQL实例、解决端口冲突或出于特定安全考虑时。
理解MySQL端口配置的重要性
MySQL服务器通过特定的网络端口监听客户端连接请求。当客户端尝试连接时，如果未显式指定端口，它会默认尝试连接到标准端口3306。如果MySQL服务器实际监听的是非标准端口，客户端就必须在连接字符串中明确指出该端口，才能建立成功的连接。
PHP应用中MySQL连接端口的配置
PHP提供了多种扩展来连接MySQL数据库，包括mysqli、PDO以及已废弃的mysql扩展。无论使用哪种扩展，核心原则都是在连接参数中指定正确的端口。
1. 使用 mysqli 扩展
mysqli扩展是PHP官方推荐的MySQL连接方式，支持面向对象和面向过程两种风格。
立即学习“PHP免费学习笔记（深入）”；
面向过程风格：
在 mysqli_connect() 函数中，端口号作为第五个参数传入。
<?php
$servername = "localhost";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";
$port = 1308; // 你的MySQL服务器新端口
// 创建连接
$conn = mysqli_connect($servername, $username, $password, $dbname, $port);
// 检查连接
if (!$conn) {
die("连接失败: " . mysqli_connect_error());
}
echo "使用 mysqli_connect 连接成功！";
// 执行数据库操作...
// 关闭连接
mysqli_close($conn);
?>面向对象风格：
在 new mysqli() 构造函数中，端口号同样作为第五个参数传入。
<?php
$servername = "localhost";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";
$port = 1308; // 你的MySQL服务器新端口
// 创建连接
$mysqli = new mysqli($servername, $username, $password, $dbname, $port);
// 检查连接
if ($mysqli->connect_error) {
die("连接失败: " . $mysqli->connect_error);
}
echo "使用 new mysqli 连接成功！";
// 执行数据库操作...
// 关闭连接
$mysqli->close();
?>2. 使用 PDO 扩展
PDO（PHP Data Objects）提供了一个统一的接口来访问多种数据库，是现代PHP应用中推荐的数据库抽象层。端口号需要在DSN（Data Source Name）字符串中指定。
<?php
$servername = "localhost";
$username = "your_username";
$password = "your_password";
$dbname = "your_database";
$port = 1308; // 你的MySQL服务器新端口
// 构建DSN字符串
$dsn = "mysql:host={$servername};port={$port};dbname={$dbname}";
try {
// 创建PDO连接
$pdo = new PDO($dsn, $username, $password);
// 设置错误模式为抛出异常，便于调试
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO_ERRMODE_EXCEPTION);
echo "使用 PDO 连接成功！";
// 执行数据库操作...
} catch (PDOException $e) {
die("连接失败: " . $e->getMessage());
}
// PDO连接在脚本结束时自动关闭，也可手动设置为null
$pdo = null;
?>3. 使用 mysql 扩展（已废弃）
尽管 mysql 扩展已在PHP 5.5.0 中废弃，并在PHP 7.0.0 中移除，但为了兼容旧代码，了解其端口配置方式仍有必要。端口号直接附加在主机名后面，用冒号分隔。
<?php
// 注意：此扩展已废弃，不推荐在新项目中使用
$servername = "localhost:1308"; // 主机名后直接加端口
$username = "your_username";
$password = "your_password";
$conn = mysql_connect($servername, $username, $password);
if (!$conn) {
die("连接失败: " . mysql_error());
}
echo "使用 mysql_connect 连接成功！";
// 切换数据库（如果需要）
// mysql_select_db("your_database", $conn);
// 执行数据库操作...
// 关闭连接
mysql_close($conn);
?>强烈建议将使用 mysql 扩展的旧代码迁移到 mysqli 或 PDO，以确保应用程序的安全性、性能和兼容性。
MySQL Shell连接端口的配置
当使用命令行工具 mysql 连接数据库时，可以通过 -P 或 --port 参数指定端口。
mysql -h localhost -P 1308 -u your_username -p
执行上述命令后，系统会提示你输入密码。-h 用于指定主机，-P (大写P) 用于指定端口，-u 用于指定用户名，-p 用于提示输入密码。
phpMyAdmin端口配置
phpMyAdmin是一个基于Web的MySQL管理工具。其连接配置通常在 config.inc.php 文件中定义。如果你通过phpMyAdmin连接的MySQL服务器端口发生了变化，你需要修改此文件。
找到类似以下的代码段，并修改 port 参数：
<?php /* Servers configuration */ $i = 0; /* Server: MySQL [1] */ $i++; $cfg['Servers'][$i]['verbose'] = 'MySQL'; $cfg['Servers'][$i]['host'] = 'localhost'; $cfg['Servers'][$i]['port'] = '1308'; // 将此行修改为你的MySQL服务器新端口 $cfg['Servers'][$i]['socket'] = ''; $cfg['Servers'][$i]['auth_type'] = 'config'; $cfg['Servers'][$i]['user'] = 'root'; $cfg['Servers'][$i]['password'] = ''; /* End of servers configuration */ ?>
保存 config.inc.php 文件后，刷新phpMyAdmin页面即可生效。
注意事项与最佳实践
- 一致性是关键： 确保所有需要连接到MySQL服务器的客户端（PHP应用、命令行工具、phpMyAdmin等）都配置了正确的、与MySQL服务器监听端口一致的端口号。
- 避免硬编码： 对于生产环境，建议将数据库连接参数（包括端口）存储在单独的配置文件、环境变量或配置服务中，而不是直接硬编码在PHP代码中。这样可以方便地在不同环境（开发、测试、生产）之间切换配置，并提高安全性。
- 检查防火墙： 如果MySQL服务器和客户端位于不同的机器上，或者即使在同一台机器上，也要确保操作系统或网络防火墙允许通过新端口进行连接。
- 重启服务： 修改MySQL服务器的端口后，务必重启MySQL服务使其生效。同样，修改PHP应用程序的配置后，可能需要重启Web服务器（如Apache或Nginx）或PHP-FPM服务。
总结
当MySQL数据库服务器的端口发生变更时，核心任务是确保所有客户端连接都能正确地指向新的端口。通过在PHP代码、MySQL命令行工具和phpMyAdmin的配置中明确指定端口号，可以有效解决因端口不匹配导致的连接问题。遵循最佳实践，如避免硬编码和使用现代化的数据库连接扩展，将有助于构建更健壮、更易于维护的应用程序。
