arm32v7/phpmyadmin

phpmyadmin (arm32v7) 镜像文档

注意：这是https://hub.docker.com/_/phpmyadmin%E7%9A%84%60arm32v7%60%E6%9E%B6%E6%9E%84%E6%9E%84%E5%BB%BA%E7%9A%84%E2%80%9C%E6%8C%89%E6%9E%B6%E6%9E%84%E2%80%9D%E4%BB%93%E5%BA%93%E2%80%94%E2%80%94%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E8%A7%81%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8F%E6%96%87%E6%A1%A3%E4%B8%AD%E7%9A%84%E2%80%9C%E9%99%A4amd64%E4%B9%8B%E5%A4%96%E7%9A%84%E6%9E%B6%E6%9E%84%EF%BC%9F%E2%80%9Dhttps://github.com/docker-library/official-images#architectures-other-than-amd64%E5%92%8C%E5%AE%98%E6%96%B9%E9%95%9C%E5%83%8FFAQ%E4%B8%AD%E7%9A%84%E2%80%9C%E9%95%9C%E5%83%8F%E6%BA%90%E5%9C%A8Git%E4%B8%AD%E6%9B%B4%E6%94%B9%E5%90%8E%EF%BC%8C%E8%AF%A5%E6%80%8E%E4%B9%88%E5%8A%9E%EF%BC%9F%E2%80%9Dhttps://github.com/docker-library/faq#an-images-source-changed-in-git-now-what%E3%80%82

快速参考

• 维护者：
  https://github.com/phpmyadmin/docker

• 获取帮助：
  Docker社区Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的Dockerfile链接

• https://github.com/phpmyadmin/docker/blob/452a995fe6c90b96473fc17c3d704786c33d42bc/apache/Dockerfile

• https://github.com/phpmyadmin/docker/blob/452a995fe6c90b96473fc17c3d704786c33d42bc/fpm/Dockerfile

• https://github.com/phpmyadmin/docker/blob/452a995fe6c90b96473fc17c3d704786c33d42bc/fpm-alpine/Dockerfile

快速参考（续）

• 问题反馈地址：
  https://github.com/phpmyadmin/docker/issues?q=

• 支持的架构：(https://github.com/docker-library/official-images#architectures-other-than-amd64)
  https://hub.docker.com/r/amd64/phpmyadmin/%E3%80%81https://hub.docker.com/r/arm32v5/phpmyadmin/%E3%80%81https://hub.docker.com/r/arm32v6/phpmyadmin/%E3%80%81https://hub.docker.com/r/arm32v7/phpmyadmin/%E3%80%81https://hub.docker.com/r/arm64v8/phpmyadmin/%E3%80%81https://hub.docker.com/r/i386/phpmyadmin/%E3%80%81https://hub.docker.com/r/ppc64le/phpmyadmin/%E3%80%81https://hub.docker.com/r/riscv64/phpmyadmin/%E3%80%81https://hub.docker.com/r/s390x/phpmyadmin/

• 镜像 artifact 详情：
  https://github.com/docker-library/repo-info/blob/master/repos/phpmyadmin (https://github.com/docker-library/repo-info/commits/master/repos/phpmyadmin)
  （镜像元数据、传输大小等）

• 镜像更新：
  https://github.com/docker-library/official-images/issues?q=label%3Alibrary%2Fphpmyadmin
  https://github.com/docker-library/official-images/blob/master/library/phpmyadmin (https://github.com/docker-library/official-images/commits/master/library/phpmyadmin)

• 本描述的来源：
  https://github.com/docker-library/docs/tree/master/phpmyadmin (https://github.com/docker-library/docs/commits/master/phpmyadmin)

什么是 phpMyAdmin？

phpMyAdmin 是一款用PHP编写的免费软件工具，旨在通过Web界面管理MySQL。phpMyAdmin支持对MySQL和MariaDB的多种操作，常用操作（管理数据库、表、列、关系、索引、用户、权限等）可通过用户界面执行，同时仍支持直接执行任何SQL语句。

可运行在Alpine、Apache和PHP FPM环境中。

!https://raw.githubusercontent.com/docker-library/docs/1a06458dd2512b5bcda0a849738bb5ca32bf8ec0/phpmyadmin/logo.png

如何使用本镜像

以下所有示例将在http://localhost:8080启动phpMyAdmin，您可在此进行MySQL和MariaDB管理。

凭据

phpMyAdmin使用MySQL服务器凭据连接。请查看相应数据库服务器镜像的文档，了解默认用户名和密码，或如何在安装时指定自定义凭据。

官方MySQL和MariaDB镜像使用以下环境变量定义凭据：

• MYSQL_ROOT_PASSWORD - 此变量为必填项，指定root超级用户账户的密码。
• MYSQL_USER、MYSQL_PASSWORD - 这些变量为可选，用于创建新用户并设置密码。

支持的 Docker Hub 标签

以下标签可用：

• latest、fpm 和 fpm-alpine 始终为最新发布版本
• 主要版本，如 5、5-fpm 和 5-fpm-alpine
• 次要版本，如 5.0、5.0-fpm 和 5-fpm-alpine
• 补丁版本，如 5.0.0、5.0.0-fpm 和 5.0.0-fpm-alpine。注意，在极少数情况下，可能会有中间的“仅Docker”版本，如4.9.2-1

完整标签列表可在https://hub.docker.com/_/phpmyadmin?tab=tags%E6%9F%A5%E7%9C%8B%E3%80%82

镜像变体

提供三种变体：

• apache：包含完整的Apache Web服务器和PHP，开箱即用。当仅请求版本号时，这是默认变体。
• fpm：仅启动PHP FPM容器。如果已有独立Web服务器，使用此变体。包含更多工具，因此比fpm-alpine体积更大。
• fpm-alpine：体积极小，基于Alpine Linux，仅启动PHP FPM进程。如果已有独立Web服务器，使用此变体。如果需要Alpine Linux不提供的更多工具，使用fpm镜像。

使用链接的数据库服务器

首先需在Docker中运行MySQL或MariaDB服务器，phpMyAdmin镜像需链接到运行中的数据库容器：

sh
docker run --name phpmyadmin -d --link mysql_db_server:db -p 8080:80 arm32v7/phpmyadmin

使用外部服务器

可通过PMA_HOST环境变量指定MySQL主机，通过PMA_PORT指定非默认端口：

sh
docker run --name phpmyadmin -d -e PMA_HOST=dbhost -p 8080:80 arm32v7/phpmyadmin

使用任意服务器

添加环境变量PMA_ARBITRARY=1可允许连接到任意服务器：

sh
docker run --name phpmyadmin -d -e PMA_ARBITRARY=1 -p 8080:80 arm32v7/phpmyadmin

使用docker compose与任意服务器

以下示例通过docker compose运行phpMyAdmin，启用任意服务器选项，允许在登录页面指定任何MySQL/MariaDB服务器。

通过https://github.com/docker/compose%EF%BC%9A

compose.yaml示例：

yaml
services:
  db:
    image: mariadb:10.11
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: notSecureChangeMe

  phpmyadmin:
    image: phpmyadmin
    restart: always
    ports:
      - 8080:80
    environment:
      - PMA_ARBITRARY=1

添加自定义配置

可通过创建config.user.inc.php文件添加自定义config.inc.php设置（如配置存储设置），并将其挂载到容器中：

sh
-v /some/local/directory/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php

完整docker run命令示例：

sh
docker run --name phpmyadmin -d --link mysql_db_server:db -p 8080:80 -v /some/local/directory/config.user.inc.php:/etc/phpmyadmin/config.user.inc.php arm32v7/phpmyadmin

确保配置文件首行为<?php，否则内容不会被识别为PHP代码。

示例配置：

php
<?php

$cfg['ShowPhpInfo'] = true; // 在首页添加phpinfo()链接

配置文件详情可参考：

• [***]
• [***]

在/etc/phpmyadmin/conf.d中添加自定义配置

也可将自定义配置文件存储在/etc/phpmyadmin/conf.d目录，适合管理多个主机的配置文件。创建如server-1.php、server-2.php等文件，挂载主机目录到容器的conf.d：

sh
docker run --name phpmyadmin -d --link mysql_db_server:db -p 8080:80 -v /some/local/directory/conf.d:/etc/phpmyadmin/conf.d:ro arm32v7/phpmyadmin

在反向代理后使用

设置变量PMA_ABSOLUTE_URI为反向代理提供phpMyAdmin的完整URL（如https://pma.example.net/）。

会话持久化

为保持容器更新之间的会话活动，需挂载/sessions目录：

sh
-v /some/local/directory/sessions:/sessions:rw

通过SSL连接数据库

设置变量PMA_SSL=1启用phpMyAdmin到MySQL服务器的SSL连接，默认值为0。PMA_SSLS可用于多个主机，为逗号分隔的0和1序列，顺序需与PMA_HOSTS对应。

sh
docker run --name phpmyadmin -d -e PMA_HOSTS=sslhost -e PMA_SSL=1 -p 8080:80 arm32v7/phpmyadmin

sh
docker run --name phpmyadmin -d -e PMA_HOSTS='sslhost,nosslhost' -e PMA_SSLS='1,0' -p 8080:80 arm32v7/phpmyadmin

环境变量摘要

• PMA_ARBITRARY - 设为1时允许连接到任意服务器
• PMA_HOST - 定义MySQL服务器的地址/主机名
• PMA_VERBOSE - 定义MySQL服务器的显示名称
• PMA_PORT - 定义MySQL服务器的端口
• PMA_HOSTS - 定义逗号分隔的MySQL服务器地址/主机名列表
• PMA_VERBOSES - 定义逗号分隔的MySQL服务器显示名称列表
• PMA_PORTS - 定义逗号分隔的MySQL服务器端口列表
• PMA_SOCKET - 定义MySQL连接的套接字文件
• PMA_SOCKETS - 定义逗号分隔的MySQL连接套接字文件列表
• PMA_SSL_DIR - 定义从环境变量生成的SSL文件路径，默认值为/etc/phpmyadmin/ssl
• PMA_SSL - 设为1时启用MySQL连接的SSL
• PMA_SSLS - 逗号分隔的0和1列表，定义对应MySQL连接的SSL启用状态
• PMA_SSL_VERIFY - 设为1时启用MySQL连接的SSL证书验证
• PMA_SSL_VERIFIES - 逗号分隔的0和1列表，定义多个MySQL连接的SSL证书验证状态
• PMA_SSL_CA - 在双向TLS安全上下文中，允许将CA证书文件作为字符串设置到默认config.inc.php中
• PMA_SSL_CAS - 在双向TLS安全上下文中，允许将多个CA证书文件作为逗号分隔的字符串列表设置到默认config.inc.php中
• PMA_SSL_CERT - 在双向TLS安全上下文中，允许将证书文件作为字符串设置到默认config.inc.php中
• PMA_SSL_CERTS - 在双向TLS安全上下文中，允许将多个证书文件作为逗号分隔的字符串列表设置到默认config.inc.php中
• PMA_SSL_KEY - 在双向TLS安全上下文中，允许将私钥文件作为字符串设置到默认config.inc.php中
• PMA_SSL_KEYS - 在双向TLS安全上下文中，允许将多个私钥文件作为逗号分隔的字符串列表设置到默认config.inc.php中
• PMA_USER 和 PMA_PASSWORD - 仅用于config认证方式的用户名和密码
• PMA_ABSOLUTE_URI - phpMyAdmin的完整URL，在反向代理配置中可能需要，除非必要否则不设置。参见文档
• PMA_CONFIG_BASE64 - 若设置，此选项将用变量的base64解码内容覆盖默认config.inc.php
• PMA_USER_CONFIG_BASE64 - 若设置，此选项将用变量的base64解码内容覆盖默认config.user.inc.php
• PMA_UPLOADDIR - 若定义，设置可导入文件的保存路径（[$cfg['UploadDir']]([***]
• PMA_SAVEDIR - 若定义，设置导出文件的保存路径（[$cfg['SaveDir']]([***]
• PMA_CONTROLHOST - 设置用于存储phpMyAdmin配置存储数据库的备用数据库主机
• PMA_CONTROLPORT - 设置连接到配置存储数据库主机的端口，覆盖默认3306
• PMA_PMADB - 定义用于phpMyAdmin配置存储数据库的数据库名。未设置时，高级功能默认不启用，但用户仍可通过零配置功能登录时启用。建议值：phpmyadmin或pmadb
• PMA_CONTROLUSER - 定义phpMyAdmin用于高级功能的用户名（controluser）
• PMA_CONTROLPASS - 定义phpMyAdmin与controluser一起使用的密码
• PMA_QUERYHISTORYDB - 设为true时启用将SQL历史存储到配置存储数据库；设为false时，历史存储在浏览器中，登出时清除
• PMA_QUERYHISTORYMAX - 设为整数时控制历史记录项数量。参见文档，默认值为25
• MAX_EXECUTION_TIME - 若设置，覆盖phpMyAdmin的最大执行时间（默认600秒）（[$cfg['ExecTimeLimit']]([***]
• MEMORY_LIMIT - 若设置，覆盖phpMyAdmin的内存限制（默认512M）（[$cfg['MemoryLimit']]([***]`[0-9+](K,M