shinsenter/cakephp4

镜像概述和主要用途

生产就绪的PHP/CakePHP Docker镜像，具备自动CakePHP安装功能。支持通过环境变量轻松配置PHP和PHP-FPM设置，无需重建镜像即可调整配置。包含最新版Composer，便于快速启动项目。提供Debian和Alpine两种版本，满足不同环境需求。

核心功能和特性

• 自动CakePHP安装：挂载空目录时，容器会自动下载框架完整源码，快速引导新项目
• 环境变量配置：通过环境变量配置PHP和PHP-FPM参数，简化配置流程，无需重建镜像
• 内置Composer：包含最新版Composer，无需额外安装即可管理项目依赖
• 多版本支持：提供Debian和Alpine两种基础镜像版本，适应不同资源需求
• HTTPS支持：内置预生成SSL测试证书，支持替换为自定义证书以启用生产环境HTTPS
• 持续更新：每日构建以保持PHP、基础OS、Composer等组件为最新版本

使用场景和适用范围

• 快速新建CakePHP项目，自动完成框架源码下载和初始化
• 部署现有CakePHP应用，通过挂载代码目录直接运行
• 生产环境部署CakePHP应用，支持自定义配置和HTTPS
• 需要灵活调整PHP配置而无需重建镜像的开发或生产场景

详细使用方法和配置说明

创建新项目

当挂载空目录到容器时，容器会自动下载框架源码，快速搭建新项目。

步骤：

1. 在主机创建空目录用于项目代码，例如：

shell
mkdir cakephp4

2. 运行容器并将空目录挂载为卷，例如：

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

容器会检测到挂载到/var/www/html的空目录，并自动克隆框架源码到其中。

使用现有项目

将主机上的现有CakePHP项目代码目录挂载到容器的/var/www/html目录即可运行现有应用。由于源码以卷方式挂载，主机上的代码变更会实时反映到容器内，便于开发和测试。

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

使用HTTPS

镜像包含预生成的SSL测试证书，位于/etc/ssl/site/server.crt和/etc/ssl/site/server.key。生产环境中需替换为自定义有效证书，以下是三种配置方式：

通过Dockerfile配置

Dockerfile
FROM shinsenter/cakephp4: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 ./cakephp4/ /var/www/html/

通过docker run配置

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

通过docker-compose配置

yaml
services:
  web:
    image: shinsenter/cakephp4:latest
    volumes:
      - ./cakephp4:/var/www/html
      - ./my_domain.crt:/etc/ssl/site/server.crt
      - ./my_domain.key:/etc/ssl/site/server.key

稳定镜像标签

由于每日构建会更新相同标签的镜像，为确保生产环境稳定性，建议将latest标签镜像标记为稳定版本：

shell
docker pull shinsenter/cakephp4:latest
docker tag  shinsenter/cakephp4:latest your-repo/cakephp4:stable
docker push your-repo/cakephp4:stable

之后使用your-repo/cakephp4:stable作为生产环境基础镜像。

相关链接

• Docker Hub: [***]
• GitHub Packages: [***]
• 其他PHP应用镜像: [***]

贡献

如发现镜像有用，可通过******，或在GitHub提交issue。

许可证

本项目采用GNU General Public License v3.0许可证。使用或借鉴本项目时，请给予适当引用。

来自越南 🇻🇳 的爱心制作。