shinsenter/cakephp5

🔋 (PHP/CakePHP) 生产就绪的Docker镜像，包含CakePHP自动安装器。

Docker Hub: [***]
GitHub Packages: [***]
更多PHP应用和框架的预构建Docker镜像可查看 shinsenter Docker Hub组织

该Docker镜像提供Debian和Alpine两种版本。

镜像概述和主要用途

shinsenter/cakephp5是基于shinsenter/php镜像构建的生产级Docker镜像，专为CakePHP 5框架设计。镜像集成了自动CakePHP安装器，支持通过环境变量灵活配置PHP和PHP-FPM参数，无需重建镜像即可调整配置。同时内置最新版Composer，可快速启动CakePHP项目开发或部署流程，适用于从项目初始化到生产环境部署的全流程需求。

核心功能和特性

生产就绪：预配置适合生产环境的PHP和Web服务器设置，开箱即用
自动安装：挂载空目录时自动下载并初始化CakePHP框架源码，快速搭建新项目
多系统支持：提供Debian和Alpine两种基础镜像版本，满足不同轻量化需求
灵活配置：通过环境变量自定义PHP和PHP-FPM参数，无需修改Dockerfile或重建镜像
Composer集成：内置最新版Composer，支持依赖管理和项目构建
HTTPS支持：包含测试用SSL证书，可通过挂载或替换证书实现生产环境HTTPS
实时同步：宿主机代码目录挂载到容器后，本地修改可实时同步至容器内，便于开发调试

使用场景和适用范围

新建CakePHP项目：快速初始化CakePHP框架，无需手动下载源码和配置环境
现有项目部署：将本地开发完成的CakePHP项目挂载到容器，直接部署运行
开发环境一致性：团队共享统一的开发环境，避免"本地能跑线上不行"的环境差异问题
生产环境部署：通过替换SSL证书、配置环境变量等方式，直接用于生产环境

详细使用方法和配置说明

基础使用前提

该镜像基于shinsenter/php构建，如需自定义PHP配置（如扩展、内存限制等），可参考其***文档。

新建CakePHP项目

当挂载空目录到容器时，镜像会自动检测并下载CakePHP框架源码，快速完成项目初始化。

步骤

在宿主机创建空目录用于存放项目代码：
```
shell
mkdir cakephp5
```

运行容器并挂载该目录：

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./cakephp5:/var/www/html \
    shinsenter/cakephp5:latest

容器会检测到/var/www/html为空，自动克隆CakePHP框架源码到该目录，完成项目初始化。

使用现有项目

将宿主机上的现有CakePHP项目目录挂载到容器的/var/www/html路径，即可直接运行项目。由于采用卷挂载方式，宿主机代码修改会实时同步至容器内，支持开发调试和生产部署。

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v /path/to/your/existing/cakephp/project:/var/www/html \
    shinsenter/cakephp5:latest

配置HTTPS

镜像内置测试用SSL证书（位于/etc/ssl/site/server.crt和/etc/ssl/site/server.key），生产环境需替换为有效证书。以下是三种替换方式：

方法1：通过Dockerfile构建

dockerfile
FROM shinsenter/cakephp5:latest

# 复制自定义证书到容器
COPY my_domain.crt /etc/ssl/site/server.crt
COPY my_domain.key /etc/ssl/site/server.key

# 可选：添加项目代码（如未通过卷挂载）
# ADD --chown=$APP_USER:$APP_GROUP ./your-project/ /var/www/html/

方法2：通过docker run命令挂载

shell
docker run -p 80:80 -p 443:443 -p 443:443/udp \
    -v ./cakephp5:/var/www/html \
    -v ./my_domain.crt:/etc/ssl/site/server.crt \
    -v ./my_domain.key:/etc/ssl/site/server.key \
    shinsenter/cakephp5:latest

方法3：通过docker-compose配置

yaml
services:
  web:
    image: shinsenter/cakephp5:latest
    ports:
      - "80:80"
      - "443:443"
      - "443:443/udp"
    volumes:
      - ./cakephp5:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

稳定镜像标签策略

由于基础镜像（PHP、OS、Composer等）会定期更新，同一标签（如latest）的镜像内容可能变化。为确保生产环境稳定性，建议将镜像标记为自定义稳定版本：

shell
# 拉取最新镜像
docker pull shinsenter/cakephp5:latest

# 标记为稳定版本
docker tag shinsenter/cakephp5:latest your-repo/cakephp5:stable

# 推送至私有仓库（如需要）
docker push your-repo/cakephp5:stable

生产环境中使用your-repo/cakephp5:stable作为基础镜像，避免因上游更新导致环境变化。