yiisoftware/yii2-php

Yii 2.x 官方Docker镜像文档

镜像概述

本镜像为Yii 2.x框架官方提供的Docker镜像，旨在简化Yii 2.x应用的部署流程。镜像内置了Yii 2.x运行所需的基础环境，包括PHP运行时、Web服务器及相关依赖，可直接用于开发、测试和生产环境，帮助开发者快速搭建标准化的Yii 2.x应用运行环境。

核心功能与特性

• 官方维护：由Yii框架官方团队维护，确保与Yii 2.x版本的兼容性和稳定性。
• 预配置环境：集成PHP、Nginx/Apache等Web服务器及Yii 2.x依赖组件，开箱即用。
• 版本支持：提供多种标签，对应不同PHP版本（如PHP 7.4、8.0等）和Yii 2.x版本，满足不同应用需求。
• 可扩展性：支持通过Dockerfile或环境变量自定义配置，适应个性化需求。
• 多场景适配：适用于开发、测试和生产环境，支持CI/CD流程集成。

使用场景

• 开发环境：快速搭建本地开发环境，避免环境配置差异导致的问题。
• 测试环境：在CI/CD流程中作为测试环境，确保代码在标准化环境中验证。
• 生产环境：通过适当配置，可直接部署到生产服务器，简化运维流程。

使用方法与配置说明

基本使用（Docker Run）

通过以下命令快速启动一个Yii 2.x应用容器：

bash
docker run -d -p 8080:80 --name yii2-app docker.xuanyuan.run/yiisoft/yii2-php:latest

• -p 8080:80：将容器内80端口映射到主机8080端口，通过http://localhost:8080访问应用。
• --name yii2-app：指定容器名称为yii2-app。
• yiisoft/yii2-php:latest：使用最新版本的Yii 2.x PHP镜像（具体标签可替换为特定PHP版本，如7.4-fpm-nginx）。

挂载本地代码（开发环境）

开发时可将本地代码目录挂载到容器内，实现代码实时更新：

bash
docker run -d -p 8080:80 -v /path/to/your/yii2-app:/app docker.xuanyuan.run/yiisoft/yii2-php:latest

• -v /path/to/your/yii2-app:/app：将本地Yii 2.x应用目录挂载到容器内/app目录（容器内应用默认路径）。

Docker Compose配置示例

创建docker-compose.yml文件，配置多容器环境（如应用+数据库）：

yaml
version: '3'

services:
  app:
    image: docker.xuanyuan.run/yiisoft/yii2-php:7.4-fpm-nginx
    ports:
      - "8080:80"
    volumes:
      - ./your-yii2-app:/app
    environment:
      - YII_ENV=dev  # 环境标识（dev/test/prod）
      - DB_HOST=db
      - DB_NAME=yii2app
      - DB_USER=root
      - DB_PASSWORD=secret
    depends_on:
      - db

  db:
    image: docker.xuanyuan.run/mysql:5.7
    environment:
      - MYSQL_ROOT_PASSWORD=secret
      - MYSQL_DATABASE=yii2app
    volumes:
      - db-data:/var/lib/mysql

volumes:
  db-data:

运行命令启动服务：

bash
docker-compose up -d

环境变量配置

镜像支持通过环境变量自定义应用配置，常用变量包括：

更多文档

完整配置和高级用法请参考官方GitHub文档：https://github.com/yiisoft/yii2-docker