Neurony PHP Dockerfiles 是一个提供多版本PHP环境的Docker镜像配置仓库,旨在简化PHP应用的容器化部署流程。该仓库包含针对不同PHP版本(如7.4、8.0、8.1、8.2等)的Dockerfile配置,预集成常用PHP扩展、环境变量管理及性能优化设置,支持开发环境与生产环境的差异化配置,帮助开发者快速构建稳定、高效的PHP容器环境。
{PHP_VERSION}-{ENV_TYPE}格式,如8.2-fpm(生产环境FPM模式)、8.1-cli-dev(开发环境CLI模式),清晰区分环境类型。mbstring、mysqli、pdo_mysql、json、curl等核心扩展,满足PHP基础功能需求。redis、memcached、gd、imagick、xdebug(仅开发环境)、opcache(生产环境默认启用)等扩展,支持缓存、图像处理及调试功能。适用于基于Laravel、Symfony、WordPress、Drupal等框架开发的PHP Web应用,可与Nginx等反向代理配合构建完整Web服务。
支持PHP微服务组件(如消息队列消费者、定时任务)及CLI工具(如脚本执行、数据迁移)的容器化运行。
为本地开发或CI/CD流程提供一致的PHP环境,避免"本地运行正常,线上报错"的环境差异问题,支持调试工具集成。
通过预优化的生产配置(如OPcache、资源限制、安全加固),保障PHP应用在生产环境的高性能与稳定性。
可直接使用Docker Hub上的预构建镜像(需确认仓库是否提供***镜像,或通过GitHub仓库构建本地镜像):
bash# 拉取生产环境PHP 8.2 FPM镜像(示例,实际需替换为仓库提供的镜像名) docker pull neurony/php:8.2-fpm
bash# 启动PHP-FPM容器 docker run -d --name php-app \ -v /path/to/your/php/app:/var/www/html \ -e PHP_INI_MEMORY_LIMIT=256M \ -e PHP_OPCACHE_ENABLE=1 \ neurony/php:8.2-fpm # 启动Nginx容器(示例配置,需自行准备nginx.conf) docker run -d --name nginx \ -v /path/to/nginx.conf:/etc/nginx/conf.d/default.conf \ -v /path/to/your/php/app:/var/www/html \ --link php-app:php \ -p 80:80 \ nginx:alpine
bashdocker run -it --rm \ -v /path/to/your/php/app:/var/www/html \ -e XDEBUG_ENABLE=1 \ -e XDEBUG_CLIENT_HOST=host.docker.internal \ neurony/php:8.1-cli-dev \ php /var/www/html/script.php
创建docker-compose.yml文件,整合PHP与Nginx服务:
yamlversion: '3.8' services: php: image: neurony/php:8.2-fpm volumes: - ./app:/var/www/html environment: - PHP_INI_MEMORY_LIMIT=512M - PHP_INI_MAX_EXECUTION_TIME=60 - APP_ENV=production restart: unless-stopped nginx: image: nginx:alpine ports: - "80:80" volumes: - ./app:/var/www/html - ./nginx/conf.d:/etc/nginx/conf.d depends_on: - php restart: unless-stopped
如需添加额外扩展或修改配置,可基于仓库Dockerfile构建自定义镜像:
dockerfile# 基于***8.2-fpm镜像构建 FROM neurony/php:8.2-fpm # 安装额外扩展(示例:安装swoole扩展) RUN docker-php-ext-install swoole # 修改PHP.ini配置 RUN echo "max_input_vars = 5000" >> /usr/local/etc/php/conf.d/custom.ini
构建命令:docker build -t my-php-app .
| 环境变量 | 描述 | 默认值 |
|---|---|---|
PHP_INI_MEMORY_LIMIT | PHP内存限制 | 128M |
PHP_INI_MAX_EXECUTION_TIME | 最大执行时间(秒) | 30 |
PHP_OPCACHE_ENABLE | 是否启用OPcache(生产环境) | 1(启用) |
XDEBUG_ENABLE | 是否启用Xdebug(开发环境) | 0(禁用) |
XDEBUG_CLIENT_HOST | Xdebug远程调试主机 | host.docker.internal |
APP_ENV | 应用环境(dev/prod) | production |
www-data)匹配;docker-php-ext-install或pecl install命令在Dockerfile中添加。来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速
需要其他帮助?请查看我们的 常见问题 或 官方QQ群: 13763429