aspendigital/octobercms

Docker + October CMS

https://travis-ci.org/aspendigital/docker-octobercms.svg?branch=master](https://travis-ci.org/aspendigital/docker-octobercms) https://img.shields.io/docker/pulls/aspendigital/octobercms.svg](https://hub.docker.com/r/aspendigital/octobercms/) https://img.shields.io/badge/October%20CMS%20Build-473-red.svg](https://github.com/octobercms/october) https://img.shields.io/badge/Edge%20Build-473-lightgrey.svg](https://github.com/octobercms/october)

本仓库定义的Docker镜像为October CMS项目提供起点，基于https://hub.docker.com/_/php%E6%9E%84%E5%BB%BA%EF%BC%8C%E5%8C%85%E5%90%ABOctober CMS所需依赖、Composer及最新版本的October CMS核心。

镜像概述

该镜像支持多种PHP版本（7.1-7.4）及Apache/FPM两种运行模式，提供稳定版（latest）、边缘版（edge）、开发版（develop）和legacy版本，满足不同场景需求。

核心功能

1. 多版本适配：覆盖PHP 7.1至7.4，兼容不同项目的PHP版本要求；
2. 双运行模式：提供Apache和FPM两种部署模式，适配各类架构；
3. 数据库支持：兼容SQLite、MySQL、Postgres等主流数据库；
4. 定时任务：通过环境变量启用Cron进程，处理系统定时任务；
5. 命令行工具：内置artisan、composer等工具，支持October CMS命令行操作；
6. 灵活配置：通过环境变量自定义PHP参数、数据库连接、应用环境等。

使用场景

1. 快速体验：一键启动October CMS实例，快速测试系统功能；
2. 插件/主题开发：挂载本地插件或主题目录，实时调试开发；
3. 生产部署：结合Docker Compose配置数据库、Cron等服务，实现生产环境部署。

配置说明

支持的标签

• 稳定版：build.473-php7.2-apache、latest等；
• 边缘版：edge-build.473-php7.4-apache、edge等；
• 开发版：develop-php7.3-apache、develop等；
• Legacy版：build.419-php5.6-apache（适配旧版October CMS）。

快速启动

shell
# 前台运行
docker run -p 80:80 --name october aspendigital/octobercms:latest
# 后台运行
docker run -p 80:80 --name october -d aspendigital/octobercms:latest

访问http://localhost，后台登录用户名admin，密码admin。

本地文件挂载

挂载本地插件目录到容器：

shell
docker run -p 80:80 --rm \
  -v $(pwd):/var/www/html/plugins/aspendigital/resizer \
  aspendigital/octobercms:latest

Docker Compose示例（MySQL数据库）

yml
version: '2.2'
services:
  web:
    image: aspendigital/octobercms:latest
    ports:
      - 80:80
    environment:
      - DB_TYPE=mysql
      - DB_HOST=mysql
      - DB_DATABASE=octobercms
      - DB_USERNAME=root
      - DB_PASSWORD=root
  mysql:
    image: mysql:5.7
    ports:
      - 3306:3306
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=octobercms

启动后执行初始化：

shell
docker-compose up -d
docker-compose exec web php artisan october:up

环境变量配置

部分常用环境变量：

• ENABLE_CRON：是否启用Cron（默认false）；
• PHP_MEMORY_LIMIT：PHP内存限制（默认128M）；
• DB_TYPE：数据库类型（默认sqlite）；
• APP_DEBUG：是否开启调试模式（默认false）。

更多环境变量可参考官方文档。

!https://raw.githubusercontent.com/aspendigital/docker-octobercms/master/aspendigital-octobercms-docker-logo.png