phpCacheAdmin Docker镜像文档

镜像概述

phpCacheAdmin是一个Web图形界面工具，用于管理Redis、Memcached、APCu、OPCache和Realpath等多种缓存系统，提供直观的数据管理功能。

核心功能和特性

• 支持多种缓存系统管理：Redis、Memcached、APCu、OPCache和Realpath
• 提供Web图形界面，实现缓存数据的可视化管理
• 支持通过环境变量灵活配置，也可使用自定义配置文件
• 支持添加多个服务器实例，满足多节点管理需求
• 轻量级Docker部署，易于集成到现有环境

使用场景

适用于需要可视化管理多种缓存系统的开发、测试或生产环境，可帮助开发人员和系统管理员方便地监控、查看和管理各类缓存数据，简化缓存系统的运维工作。

使用方法

快速启动

通过单条命令即可运行：

bash
docker run -p 8080:80 -d --name phpcacheadmin \
  -e "PCA_REDIS_0_HOST=redis_host" \
  -e "PCA_REDIS_0_PORT=6379" \
  -e "PCA_MEMCACHED_0_HOST=memcached_host" \
  -e "PCA_MEMCACHED_0_PORT=***" \
  robinn/phpcacheadmin

Docker Compose配置

也可在docker-compose.yml中使用：

yaml
services:
  phpcacheadmin:
    image: robinn/phpcacheadmin
    ports:
      - "8080:80"
    #volumes:
    # 如需使用config.php而非环境变量，可取消注释
    #  - "./config.php:/var/www/html/config.php"
    environment:
      - PCA_REDIS_0_HOST=redis
      - PCA_REDIS_0_PORT=6379
      - PCA_MEMCACHED_0_HOST=memcached
      - PCA_MEMCACHED_0_PORT=***
    links:
      - redis
      - memcached
  redis:
    image: redis
  memcached:
    image: memcached

环境变量配置

配置文件中的所有键均支持通过环境变量设置，只需添加PCA_前缀。数组类型的配置项可使用"点表示法"（用_代替点），或使用JSON格式（如Redis SSL选项）。

Redis服务器配置

• PCA_REDIS_0_NAME：服务器名称（可选）
• PCA_REDIS_0_HOST：主机地址（指定路径时可选）
• PCA_REDIS_0_PORT：端口（使用默认端口时可选）
• PCA_REDIS_0_SCHEME：连接协议（可选，如需TLS连接，设置为tls）
• PCA_REDIS_0_SSL：TLS的SSL选项（可选，需Redis >= 6.0），可设为JSON格式，如{"cafile":"private.pem","verify_peer":true}（详见PHP SSL上下文选项）
• PCA_REDIS_0_DATABASE：默认数据库（可选）
• PCA_REDIS_0_USERNAME：ACL用户名（可选，需Redis >= 6.0）
• PCA_REDIS_0_PASSWORD：密码（可选）
• PCA_REDIS_0_AUTHFILE：密码文件路径，如Docker secrets（可选）
• PCA_REDIS_0_PATH：Unix域套接字路径（可选）
• PCA_REDIS_0_DATABASES：数据库数量，当CONFIG命令被禁用时使用（可选）
• PCA_REDIS_0_SCANSIZE：SCAN命令扫描的键数量，用于替代KEYS命令（可选）

Memcached服务器配置

• PCA_MEMCACHED_0_NAME：服务器名称（可选）
• PCA_MEMCACHED_0_HOST：主机地址（指定路径时可选）
• PCA_MEMCACHED_0_PORT：端口（使用默认端口时可选）
• PCA_MEMCACHED_0_PATH：Unix域套接字路径（可选）

PHP配置

• PCA_PHP_MEMORY_LIMIT：PHP内存限制，用于在Docker中调整内存大小

查看配置文件获取更多信息。

如需添加其他服务器，只需使用相同的环境变量，将0改为1（第三台服务器改为2，以此类推）。

系统要求

• Redis服务器 >= 4.0
• Memcached服务器 >= 1.4.31（不支持SASL，因无法获取键）

无需启用所有仪表板，可根据实际需求选择启用的缓存系统。