gediminasskucas/wibu-spryker-php

Wibu Spryker PHP Container 镜像文档### 1. 镜像概述Wibu Spryker PHP Container是一个针对Spryker电子商务平台优化的PHP运行环境容器。该镜像集成了运行Spryker应用所需的PHP版本、扩展及依赖项，提供开箱即用的容器化解决方案，旨在降低Spryker应用部署的复杂度，确保环境一致性和稳定性。### 2. 核心功能和特性-** 优化的PHP环境 **：预配置与Spryker兼容的PHP版本（如PHP 7.4/8.0等），包含必要扩展（如mbstring、curl、gd、redis等）及性能优化配置。

-** Spryker依赖集成 ：内置Spryker运行所需的系统依赖（如Composer、Node.js、Git等），支持Spryker应用的依赖安装与构建。 - 配置灵活性 ：支持通过环境变量、配置文件挂载等方式自定义PHP配置、Spryker参数及运行时行为。 - 多环境适配 ：可通过调整配置适配开发、测试及生产环境，满足不同阶段的部署需求。 - 轻量级设计 ：基于精简基础镜像构建，减少资源占用，提升运行效率。### 3. 使用场景和适用范围- Spryker应用开发 ：为开发团队提供一致的本地开发环境，避免"环境不一致"问题。 - 测试环境部署 ：快速搭建Spryker应用的测试环境，验证功能更新和版本兼容性。 - 生产环境运行 ：作为Spryker应用的运行容器，配合编排工具（如Kubernetes、Docker Compose）实现规模化部署。### 4. 使用方法和配置说明#### 4.1 基本使用（Docker Run）通过docker run命令快速启动容器：bashdocker run -d \ --name spryker-php \ -p 8080:80 \ -v /path/to/spryker/app:/app \ -e PHP_MEMORY_LIMIT=2G \ -e SPRYKER_ENV=dev \ wibu/spryker-php:latest 参数说明 ： --v /path/to/spryker/app:/app：挂载本地Spryker应用代码至容器内/app目录。 --e PHP_MEMORY_LIMIT=2G：设置PHP内存限制（默认1G）。 --e SPRYKER_ENV=dev：指定Spryker运行环境（可选：dev/test/prod，默认dev）。 --p 8080:80：映射容器80端口至主机8080端口，用于访问Spryker应用。#### 4.2 Docker Compose配置示例创建docker-compose.yml文件，集成Spryker PHP容器与其他服务（如数据库、Redis）：yamlversion: '3.8'services: spryker-php: image: wibu/spryker-php:latest container_name: spryker-php ports: - "8080:80" volumes: - ./spryker-app:/app - ./php.ini:/usr/local/etc/php/php.ini # 自定义PHP配置 environment: - PHP_MEMORY_LIMIT=4G - SPRYKER_ENV=prod - DB_HOST=mysql - DB_USER=spryker - DB_PASSWORD=secret depends_on: - mysql - redis mysql: image: mysql:8.0 environment: - MYSQL_ROOT_PASSWORD=root - MYSQL_DATABASE=spryker - MYSQL_USER=spryker - MYSQL_PASSWORD=secret redis: image: redis:6-alpine#### 4.3 关键环境变量配置| 环境变量名 | 描述 | 默认值 | 可选值 | |--------------------------|-------------------------------|--------------|----------------------------| | PHP_VERSION | PHP版本 | 8.0 | 7.4, 8.0, 8.1 | | PHP_MEMORY_LIMIT | PHP内存限制 | 1G | 512M, 2G, 4G等 | | SPRYKER_ENV | Spryker运行环境 | dev | dev, test, prod | | SPRYKER_DEBUG | 是否开启Spryker调试模式 | false | true, false | | COMPOSER_HOME | Composer缓存目录 | /root/.composer | 自定义路径 |#### 4.4 自定义PHP配置通过挂载本地php.ini文件覆盖容器默认配置：bashdocker run -d \ --name spryker-php \ -v /local/path/php.ini:/usr/local/etc/php/php.ini \ wibu/spryker-php:latest 常用配置项 ： -max_execution_time = 300：延长脚本执行时间（适应Spryker复杂操作）。 -upload_max_filesize = 100M：调整文件上传大小限制。 -date.timezone = UTC：设置时区。### 5. 注意事项- 代码权限 ：确保挂载的Spryker应用目录权限正确（建议容器内运行用户ID与主机一致，避免权限问题）。 - 版本兼容性 ：使用前确认镜像PHP版本与Spryker应用要求的PHP版本匹配（参考Spryker官方文档）。 - 数据持久化 **：生产环境中建议通过外部存储（如数据库、共享卷）持久化Spryker应用数据，避免容器销毁导致数据丢失。