nicoherbigde/neos-php

PHP for NEOS CMS 镜像文档

镜像概述

本镜像为NEOS CMS内容管理系统提供专用PHP运行环境，基于官方PHP镜像构建，预装NEOS CMS运行所需的全部PHP扩展、依赖库及基础配置，确保与NEOS CMS各版本的兼容性和运行稳定性，简化NEOS CMS的部署流程。

核心功能与特性

• 版本适配：支持PHP 8.1+版本，兼容NEOS CMS 7.0及以上版本需求
• 预装扩展：包含NEOS CMS必需PHP扩展，如mbstring、gd、imagick、pdo_mysql、zip、intl、opcache等
• 性能优化：默认启用OPcache缓存，支持PHP内存限制、执行时间等核心参数调优
• 安全配置：内置基础安全加固，如禁用危险函数、限制文件权限等
• 多环境支持：适配开发、测试、生产多环境配置，可通过环境变量快速切换

使用场景

• NEOS CMS项目的本地开发环境快速搭建
• CI/CD流程中NEOS CMS应用的自动化测试环境
• 生产环境中NEOS CMS应用的容器化部署
• 需要标准化NEOS CMS运行环境的团队协作场景

使用方法

基本使用（Docker Run）

通过以下命令快速启动NEOS CMS PHP环境：

bash
docker run -d \
  --name neos-php \
  -p 80:80 \
  -v /path/to/your/neos-project:/var/www/html \
  -e NEOS_ENV=production \
  -e PHP_MEMORY_LIMIT=512M \
  docker.xuanyuan.run/neos/php:latest

参数说明：

• -v /path/to/your/neos-project:/var/www/html：挂载本地NEOS CMS项目代码到容器内
• -e NEOS_ENV=production：设置NEOS运行环境（可选值：development/test/production）
• -p 80:80：映射容器80端口到主机，用于访问NEOS CMS应用

环境变量配置

Docker Compose 配置示例

推荐结合数据库容器使用，以下为完整docker-compose.yml示例：

yaml
version: '3.8'

services:
  neos-php:
    image: docker.xuanyuan.run/neos/php:latest
    container_name: neos-php
    ports:
      - "80:80"
    volumes:
      - ./your-neos-project:/var/www/html
      - neos-logs:/var/www/html/Data/Logs
    environment:
      - NEOS_ENV=production
      - PHP_MEMORY_LIMIT=512M
      - DB_HOST=mysql
      - DB_NAME=neos_db
      - DB_USER=neos_admin
      - DB_PASS=secure_password
    depends_on:
      - mysql
    restart: unless-stopped

  mysql:
    image: docker.xuanyuan.run/mysql:8.0
    container_name: neos-mysql
    volumes:
      - mysql-data:/var/lib/mysql
    environment:
      - MYSQL_DATABASE=neos_db
      - MYSQL_USER=neos_admin
      - MYSQL_PASSWORD=secure_password
      - MYSQL_ROOT_PASSWORD=root_password
    restart: unless-stopped

volumes:
  mysql-data:
  neos-logs:

数据持久化

为确保NEOS CMS数据安全，建议挂载以下目录：

• /var/www/html：NEOS CMS应用代码目录（开发环境推荐挂载本地目录，生产环境可考虑构建时打包）
• /var/www/html/Data：NEOS CMS数据目录（包含配置、缓存、用户上传文件等，必须持久化）
• /var/www/html/Configuration：NEOS CMS配置目录（如需自定义配置，建议挂载）

注意事项

• 生产环境中建议配合反向代理（如Nginx）使用，以优化静态资源处理和SSL终结
• 首次启动需执行NEOS CMS初始化命令：docker exec -it neos-php ./flow doctrine:migrate
• 定期更新镜像以获取安全补丁和功能优化
• 根据NEOS CMS官方文档调整PHP扩展和配置，确保与具体版本匹配