在本地开发环境中更换 MySQL 端口后,WordPress 需要更新其配置文件中的数据库连接信息。请按照以下步骤操作:
1. 找到 WordPress 配置文件
打开你的 WordPress 根目录下的 wp-config.php 文件(通常位于网站根目录,如 /var/www/html/、htdocs/ 或项目根目录)。
2. 修改数据库主机配置
找到以下行(通常在文件开头部分):
define( 'DB_HOST', 'localhost' );
将其修改为包含新端口的格式:
- 如果使用的是 localhost:将
'localhost'改为'localhost:新端口号'define( 'DB_HOST', 'localhost:3307' ); // 假设新端口是 3307 - 如果使用的是 IP 地址:同样加上端口
define( 'DB_HOST', '127.0.0.1:3307' );
⚠️ 注意:MySQL 的默认端口通常是 3306。如果你改成了其他端口(如 3307、8806 等),必须显式指定端口。
3. 保存并测试
- 保存
wp-config.php文件。 - 刷新 WordPress 站点,检查是否出现“无法连接到数据库”错误。
- 如果仍有问题,请确认:
- MySQL 服务已启动且监听新端口;
- 防火墙允许该端口通信(本地环境通常不需要);
- 用户名、密码和数据库名是否正确;
- PHP 版本是否支持该端口格式(现代 PHP + MySQLi 均支持)。
4. 额外提示(可选)
如果你是通过 docker-compose 或类似容器化方式运行,还需确保:
- 容器内 MySQL 暴露的端口与
DB_HOST中指定的端口一致; - 容器网络配置正确(如使用
host模式或直接映射端口)。
完成以上步骤后,WordPress 应能正常连接新的 MySQL 端口。
云小栈