phpMyAdmin 配置中 port 字段被忽略的根本原因与正确配置方法
PhpStorm 是 JetBrains 推出的专业 PHP 集成开发环境，可在 Mac 上完成代码编写、智能检查、重构、调试、测试和数据库管理。它支持主流 PHP 框架、Composer、Git、Docker 与远程解释器。
phpMyAdmin连接MySQL时，port字段被忽略是因为host与port互斥：host中若含有冒号则port失效，导致端口重复。正确配置需二选一：方案一，host不带端口，显式设置connect_type为tcp和port；方案二，host带端口并删除port字段。此外需注意MySQL8.0+认证插件兼容性。
在 Docker 环境中用 phpMyAdmin 连接 MySQL 时，一个极其常见的困惑是：明明在配置文件里明明白白地设置了 port 字段，可登录页就是告诉你连不上。这事儿折腾过不少人，今天咱们就把这个“幽灵问题”彻底拆开看看。
先说几个核心判断：这并不是 phpMyAdmin 的 Bug，而是它的连接机制在设计上就有个小脾气——它不会自动把 port 字段里的值拼到 host 后面去用。这事儿听起来有点反直觉，但理解了它的逻辑，一切就都顺了。
核心原理：host 与 port 到底怎么协作？
phpMyAdmin 底层怎么决定连到哪个 MySQL 实例？这主要看三个字段的配合：
host：决定目标，可以是域名、IP 或者localhost。connect_type：决定通信协议走tcp还是socket。port：这个字段有个关键前提——只有当你把connect_type显式设为tcp，并且host里没有冒号时，它才会真正发挥作用。
那问题出在哪儿呢？很多人直接在 host 里写了 'localhost:3306'，然后又保留了 port = 3306。这时候 phpMyAdmin 会直接拿 host 里的完整字符串去建立 TCP 连接，完全无视 port 字段。更糟糕的是，它不会报错说“我不用你的 port”，而是默默地在界面或者日志里给你显示 localhost:3306:3306——端口重复了，连接自然失败。
简单记一句话：host 是“完整地址”，port 是“备用端口”——回到根上，它俩是互斥的，不能共存。
正确配置方案，二选一
既然知道了问题根源，解决方案就很清晰了。
方案一：纯 host + 显式 connect_type + port（推荐）
这种做法适合需要统一管理配置、或者通过变量注入端口号的场景。
$cfg['Servers'][$i]['host'] = 'localhost'; // 不带端口！
$cfg['Servers'][$i]['connect_type'] = 'tcp'; // 强制走 TCP
$cfg['Servers'][$i]['port'] = 3306; // 此时 port 生效
$cfg['Servers'][$i]['extension'] = 'mysqli';这样配置，语义清楚，以后改端口只改一个变量就行，不容易出错。但要警惕：host 里绝对不能出现冒号，否则 port 会被静默忽略。
方案二：host 直接携带端口
如果你追求直觉式的写法，觉得“地址就该是一个整体”，那也可以这样：
$cfg['Servers'][$i]['host'] = 'localhost:3306'; // 完整地址，port 字段废弃
// $cfg['Servers'][$i]['port'] = 3306; // ← 一定要注释或删掉！
$cfg['Servers'][$i]['connect_type'] = 'tcp'; // 建议显式声明这种做法的好处是直观，但一旦你在其他地方（比如 config-db.php）定义了 $dbport，又用 "{$dbserver}:{$dbport}" 拼接了 host，还顺手把 $dbport 赋值给了 port 字段——那就等着端口重复吧。
Docker 场景下的特别提醒
很多人是在 Docker 里遇到这个问题的，比如你用 init.sh 创建了一个 'admin'@'localhost' 用户，并且用了 mysql_native_password 插件，这一步没错。但有一个隐蔽的坑：
MySQL 8.0+ 默认的认证插件是 caching_sha2_password，而 phpMyAdmin 4.9.5 根本不支持这个新插件。哪怕你的连接地址完全正确，它也会静默失败——没有明确的报错，只是提示“无法登录”。
解决办法是在初始化脚本里强制把 admin 用户的认证方式改回来：
mysql -u root -e "
ALTER USER 'admin'@'localhost' IDENTIFIED WITH mysql_native_password BY 'admin';
FLUSH PRIVILEGES;"同时确认 config.inc.php 里启用了 mysqli 扩展（你已经做了），并且把 AllowNoPassword 关掉，除非你真的需要允许空密码登录。
常见陷阱一览
| 错误操作 | 后果 | 修正方式 |
|---|---|---|
host = 'localhost:3306' + port = 3306 | 界面显示 localhost:3306:3306，连接失败 | 删除或注释 port 行 |
host = '127.0.0.1' 且 MySQL 绑定 127.0.0.1 | 可能因 DNS 解析延迟或权限 Host 不匹配失败 | 改用 localhost（触发 socket），或确认 MySQL 用户表里有 'user'@'127.0.0.1' |
| 用 phpMyAdmin 4.x 连接 MySQL 8.0+ | 用户管理页空白、权限加载异常 | 升级到 phpMyAdmin ≥ 5.0，这是官方最低要求 |
config-db.php 与 config.inc.php 中 $dbport 未同步 | 配置割裂，调试起来很头疼 | 统一在 config-db.php 定义 $dbport，然后严格按「方案一」引用 |
最终验证步骤
按下面的顺序走一遍，基本就能确认问题已经解决：
- 修改
config.inc.php，采用方案一进行配置。 - 重启容器：
docker restart <容器名>。 - 访问
http://localhost/phpmyadmin，用admin / admin登录。 - 登录成功后，点击右上角 → 服务器：localhost:3306 —— 应该只显示一个端口，干净利落。
- 进入「用户账户」页，确认可以正常查看和管理用户。如果这里报
#1146错误，说明表结构有问题，需要回查 MySQL 版本兼容性。
配置这件事，一旦摸清了 phpMyAdmin 的性格，其实并不复杂。关键在于理解它“先看 host，再决定用不用 port”的逻辑，然后根据自己的部署方式，把二选一做到位。这样，Docker 环境下的数据库管理就能稳稳地跑起来。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境，重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具，并可借助插件扩展语言和框架支持。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境，提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片，核心功能可免费使用。
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境，可智能理解项目结构，提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
Adobe After Effects 是面向动态图形、影视特效与视频合成的专业创作软件。它提供关键帧动画、遮罩抠像、运动跟踪、三维空间、文字动画和表达式等工具，并可与 Premiere Pro、Photoshop、Illustrator
Adobe Audition 是面向播客、影视后期、音乐制作及内容创作者的专业音频工作站，提供波形精修、多轨录制与混音、频谱编辑、降噪修复、响度匹配和效果处理工具，并可与 Adobe Premiere 协同完成视频声音制作。
Adobe Bridge 是面向摄影师、设计师及内容团队的免费数字资产管理工具，可集中预览照片、视频和 Adobe 项目文件，并利用评级、标签、关键词、元数据、筛选与收藏集完成分类检索。它还支持批量重命名、格式导出、相机导入及 Camera
Adobe Illustrator 是 Adobe 推出的专业矢量图形设计软件，适合在 Mac 上制作标志、图标、插画、包装、信息图及印刷版面。它以路径和锚点构建可无损缩放的图形，并提供钢笔、形状、文字、图像描摹、渐变、画板及生成式功能。
Adobe InDesign 是面向印刷品与数字出版物的专业版面设计软件，可在 Mac 上制作书籍、杂志、宣传册、海报、报告及交互式文档。它提供精细的文字样式、网格、母版、长文档管理和印前输出能力。
Adobe Lightroom Classic 是面向桌面摄影工作流的照片管理与后期处理软件，可将原始照片保存在本地硬盘，通过目录、关键词、评分和收藏夹高效整理图库，并提供 RAW 冲印、蒙版、镜头校正、批量同步及多格式导出等功能。
Adobe Media Encoder 是 Adobe 推出的专业音视频编码与转码工具，可通过队列、预设和监视文件夹批量完成格式转换、代理文件创建及多平台成片输出，并与 Premiere Pro、After Effects 等软件紧密协作。
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理软件，提供图层、蒙版、选区、修复、调色、文字排版、智能对象及生成式编辑等能力。Mac 版支持 Intel 与 Apple Silicon 处理器。
Adobe Premiere Pro 是面向专业视频制作的非线性剪辑软件，提供多轨时间线、调色、音频处理、字幕、代理工作流和多格式输出能力，并可与 After Effects、Audition、Photoshop 及 Frame.io 协同
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境，提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目，
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境，提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序，
PyCharm 是 JetBrains 推出的 Python 集成开发环境，提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能，
WebStorm 是 JetBrains 面向 JavaScript、TypeScript 和现代 Web 技术打造的集成开发环境。它提供项目级代码分析、智能补全、安全重构、导航搜索，并集成调试、测试、终端、Git 与常用前端工具，
Adobe Photoshop 是面向摄影师、设计师和内容创作者的专业图像处理工具，可在 Windows 上完成照片修饰、选区抠图、图层合成、文字排版、绘画及生成式编辑。软件采用订阅授权，由 Creative Cloud 管理安装、更新与许
Adobe InDesign 是面向印刷与数字出版的专业页面排版工具，可制作书籍、杂志、宣传册、海报、交互式 PDF 和电子书。它提供精细的文字样式、多页面管理、印前检查及多格式输出能力，并能与 Photoshop、Illustrator
Adobe Illustrator 是用于绘制矢量图形、插画、图标、徽标和版式的专业设计工具。它以路径和锚点为核心，作品放大后仍能保持清晰，并提供画板、文字、渐变、图像描摹及精确变换等功能，适合品牌视觉、印刷物料、数字界面和商业插画创作。
Adobe Bridge 是 Adobe 推出的创意资产管理工具，可集中预览、分类和查找照片、视频、PDF及多种设计文件，并支持元数据、关键词、评级、批量重命名和格式导出。它可与 Photoshop、Illustrator 等应用衔接，
Adobe Lightroom Classic 是面向 Windows 桌面摄影工作流的照片管理与无损编辑工具，可通过目录集中整理大型图库，并完成 RAW 显影、局部蒙版、批量调整、打印和多格式导出。它强调本地文件管理与精细控制，
Adobe Acrobat Pro 是面向专业 PDF 工作的综合解决方案，可在 Windows 中创建、编辑、转换、比较、整理和保护文档，并支持表单、电子签名、扫描件文字识别及敏感信息永久遮盖。订阅还包含网页、移动服务和云端协作能力，
Adobe After Effects 是面向动态图形、动画与影视视觉特效制作的专业工具，可完成关键帧动画、图层合成、遮罩跟踪、抠像、文字动画和二维三维元素整合。Windows 版通过 Adobe Creative Cloud 安装及更新，
Adobe Media Encoder 是 Adobe 面向视频与音频制作流程提供的专业编码和转码工具，可批量处理媒体文件、创建代理、套用输出预设并监控文件夹自动执行任务。它与 Premiere、After Effects、Audition