官方phpMyAdmin镜像不支持直接挂载php.ini，因其Apache模块模式下PHP配置路径为/etc/php/x.x/apache2/php.ini且未声明VOLUME；可靠方案是构建自定义镜像覆盖该路径，或改用fpm-alpine镜像挂载/usr/local/etc/php/php.ini。
不能直接映射到 phpmyadmin 容器的 php.ini —— 官方镜像（phpmyadmin/phpmyadmin）基于 apache + php，但不暴露 /usr/local/etc/php/ 供挂载；它用的是内置 php 环境，且未开放配置目录的写入或覆盖路径。
为什么 docker run -v /path/php.ini:/usr/local/etc/php/php.ini 不生效
官方 phpmyadmin/phpmyadmin 镜像（Apache 版）在构建时已将 PHP 编译进 Apache 模块，其 php.ini 路径为 /etc/php/8.2/apache2/php.ini（版本依镜像而定），但该路径不在容器启动时可挂载的“安全区”内。更关键的是：镜像未声明 VOLUME 或 EXPOSE 该路径，docker run -v 强行挂载会失败静默或被忽略——你改了宿主机文件，容器里 phpinfo() 仍显示默认值。
- 运行
docker exec -it phpmyadmin cat /etc/php/*/apache2/php.ini | grep memory_limit可验证实际加载路径 - 挂载
/etc/php/全路径风险极高：可能覆盖apache2/和cli/两套配置，甚至破坏mods-available/ - 环境变量如
PHP_INI_SCAN_DIR在该镜像中未启用，无法通过挂载额外 ini 文件注入
真正可行的两种方案：build 自定义镜像 or 用 fpm-alpine + Nginx 分离部署
若必须调 PHP 参数（如 upload_max_filesize、max_execution_time），只有以下路径可靠：
-
方案一（推荐）：基于官方镜像 build 新镜像
在
Dockerfile中COPY自定义php.ini到对应路径，并重载 Apache：FROM phpmyadmin/phpmyadmin:latest COPY my-php.ini /etc/php/8.2/apache2/php.ini RUN a2enmod rewrite && systemctl reload apache2 || true
注意：需先docker run --rm phpmyadmin/phpmyadmin:latest ls /etc/php/确认实际 PHP 版本路径 -
方案二：换用
phpmyadmin:fpm-alpine镜像 + 独立 Nginx 该镜像明确支持-v /path/php.ini:/usr/local/etc/php/php.ini:ro，因为它的 PHP 是 FPM 模式，且/usr/local/etc/php/是标准挂载点。搭配 Nginx 容器时，Nginx 的fastcgi_pass指向 phpmyadmin-fpm 容器即可
常见错误：试图用环境变量覆盖 PHP 配置
官方镜像不响应 PHP_INI_* 类环境变量（如 PHP_INI_MEMORY_LIMIT=512M）。这类变量仅在 PHP CLI 或某些 FPM 构建镜像中有效；Apache 模块模式下，PHP 初始化完全依赖 php.ini 文件本身。尝试设置只会无效，且无任何日志提示。
最易被忽略的一点：即使你成功挂载了 php.ini，phpMyAdmin 的上传限制还受其自身 $cfg['UploadDir'] 和 $cfg['SaveDir'] 配置、以及 Apache 的 LimitRequestBody 指令双重约束——光调 PHP 的 post_max_size 不够，必须同步检查 Web 服务器层。
立即学习“PHP免费学习笔记（深入）”；
