PHP应用与MySQL数据库端口配置指南-php教程-PHP中文网

PHP应用与MySQL数据库端口配置指南

心靈之曲

发布： 2025-11-08 13:02:02

原创

597人浏览过

PHP应用与MySQL数据库端口配置指南

当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）字符串中指定。

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

<?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的配置中明确指定端口号，可以有效解决因端口不匹配导致的连接问题。遵循最佳实践，如避免硬编码和使用现代化的数据库连接扩展，将有助于构建更健壮、更易于维护的应用程序。

以上就是PHP应用与MySQL数据库端口配置指南的详细内容，更多请关注php中文网其它相关文章！