s390x/phpmyadmin

注意：这是https://hub.docker.com/_/phpmyadmin的`s390x`架构"每个架构"仓库——更多信息请参见官方镜像文档中的https://github.com/docker-library/official-images#architectures-other-than-amd64和官方镜像FAQ中的https://github.com/docker-library/faq#an-images-source-changed-in-git-now-what。

快速参考

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

• 获取帮助：
  https://dockr.ly/comm-slack、Server Fault、https://unix.stackexchange.com/help/on-topic 或 https://stackoverflow.com/help/on-topic

支持的标签及对应的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/、https://hub.docker.com/r/arm32v5/phpmyadmin/、https://hub.docker.com/r/arm32v6/phpmyadmin/、https://hub.docker.com/r/arm32v7/phpmyadmin/、https://hub.docker.com/r/arm64v8/phpmyadmin/、https://hub.docker.com/r/i386/phpmyadmin/、https://hub.docker.com/r/ppc64le/phpmyadmin/、https://hub.docker.com/r/riscv64/phpmyadmin/、https://hub.docker.com/r/s390x/phpmyadmin/

• 已发布镜像工件详情：
  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的phpMyAdmin运行环境。

如何使用本镜像

以下所有示例将在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查看。

镜像变体

我们提供三种变体：

• "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 docker.xuanyuan.run/s390x/phpmyadmin

与外部服务器一起使用

您可以在PMA_HOST环境变量中指定MySQL主机。如果服务器端口不是默认端口，还可以使用PMA_PORT指定端口：

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

与任意服务器一起使用

通过在启动命令中添加环境变量PMA_ARBITRARY=1，可以指定任意服务器：

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

使用Docker Compose与任意服务器

以下配置将运行启用任意服务器选项的phpMyAdmin，允许您在登录页面指定任何MySQL/MariaDB服务器。

... 通过https://github.com/docker/compose

compose.yaml示例：

yaml
services:
  db:
    image: docker.xuanyuan.run/mariadb:10.11
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: notSecureChangeMe

  phpmyadmin:
    image: docker.xuanyuan.run/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 docker.xuanyuan.run/s390x/phpmyadmin

确保配置文件的第一行为<?php，否则内容将不会被检测为PHP代码。

示例：

php
<?php

$cfg['ShowPhpInfo'] = true; // 在主页添加指向phpinfo()的链接

有关配置文件的更多信息，请参见以下链接：

• https://docs.phpmyadmin.net/zh/latest/config.html#config
• https://docs.phpmyadmin.net/zh/latest/setup.html

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

您也可以考虑将自定义配置文件存储在/etc/phpmyadmin/conf.d文件夹中，这非常适合管理不同主机的多个phpMyAdmin配置文件。您可以创建server-1.php、server-2.php或任何您想要的文件名，并将它们存储在主机上挂载的conf.d目录中。

在docker run命令中如下所示：

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 docker.xuanyuan.run/s390x/phpmyadmin

在反向代理后使用

将变量PMA_ABSOLUTE_URI设置为反向代理使phpMyAdmin可用的完全限定路径（如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 docker.xuanyuan.run/s390x/phpmyadmin

sh
docker run --name phpmyadmin -d -e PMA_HOSTS='sslhost,nosslhost' -e PMA_SSLS='1,0' -p 8080:80 docker.xuanyuan.run/s390x/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。在反向代理配置中有时需要。除非必要，否则不要设置。参见https://docs.phpmyadmin.net/zh/latest/config.html#cfg_PmaAbsoluteUri
• PMA_CONFIG_BASE64 - 如果设置，此选项将用变量的base64解码内容覆盖默认config.inc.php
• PMA_USER_CONFIG_BASE64 - 如果设置，此选项将用变量的base64解码内容覆盖默认config.user.inc.php
• PMA_UPLOADDIR - 如果定义，此选项将设置可保存文件以供导入的路径（https://docs.phpmyadmin.net/zh/latest/config.html#cfg_UploadDir）
• PMA_SAVEDIR - 如果定义，此选项将设置可保存导出文件的路径（https://docs.phpmyadmin.net/zh/latest/config.html#cfg_SaveDir）
• PMA_CONTROLHOST - 设置时，指向用于存储https://docs.phpmyadmin.net/zh/latest/setup.html#phpmyadmin-configuration-storage的备用数据库主机
• PMA_CONTROLPORT - 如果设置，将覆盖连接到控制主机以存储https://docs.phpmyadmin.net/zh/latest/setup.html#phpmyadmin-configuration-storage的默认端口（3306）
• PMA_PMADB - 定义用于https://docs.phpmyadmin.net/zh/latest/setup.html#phpmyadmin-configuration-storage的数据库名称。未设置时，默认不启用高级功能：用户仍可在使用零配置（zero configuration）功能登录时潜在启用这些功能。建议值：phpmyadmin或pmadb
• PMA_CONTROLUSER - 定义phpMyAdmin用于高级功能的用户名（https://docs.phpmyadmin.net/zh/latest/config.html#cfg_Servers_controluser）
• PMA_CONTROLPASS - 定义phpMyAdmin与https://docs.phpmyadmin.net/zh/latest/config.html#cfg_Servers_controlpass一起使用的密码
• PMA_QUERYHISTORYDB - 设置为https://docs.phpmyadmin.net/zh/latest/config.html#cfg_QueryHistoryDB时，启用将https://docs.phpmyadmin.net/zh/latest/config.html#cfg_Servers_history存储到https://docs.phpmyadmin.net/zh/latest/setup.html#phpmyadmin-configuration-storage。设置为https://docs.phpmyadmin.net/zh/latest/config.html#cfg_QueryHistoryDB时，历史存储在浏览器中，登出时清除
• PMA_QUERYHISTORYMAX - 设置为整数时，控制历史项目数量。参见https://docs.phpmyadmin.net/zh/latest/config.html#cfg_QueryHistoryMax。默认为`25`
• MAX_EXECUTION_TIME - 如果设置，将覆盖phpMyAdmin的最大执行时间（默认600秒）（[$cfg['ExecTimeLimit']](