qoorts/php-composer-yarn-rsync

PHP应用部署镜像文档

镜像概述和主要用途

该Docker镜像专为PHP应用部署设计，集成composer（PHP依赖管理工具）和yarn（前端资源构建工具）用于应用构建流程，并通过rsync实现文件同步功能。主要用途是简化PHP应用从依赖安装、资源构建到文件同步的完整部署流程，提供一体化解决方案。

核心功能和特性

• 集成构建工具：内置composer和yarn，支持PHP依赖安装（composer install）和前端资源构建（yarn install/yarn build）
• 文件同步能力：通过rsync工具实现应用文件的高效同步，支持本地或远程路径同步
• 部署流程整合：串联依赖安装、资源构建、文件同步环节，减少手动操作步骤
• 灵活配置支持：通过环境变量自定义构建参数、同步路径及工作目录

使用场景和适用范围

• PHP应用部署：适用于包含PHP后端和前端资源的Web应用部署
• CI/CD自动化：可集成到持续集成/部署流程，实现构建-同步-部署自动化
• 多环境同步：用于开发、测试、生产环境间的PHP应用代码及资源同步
• 中小型项目：尤其适合依赖composer和yarn管理依赖的中小型PHP项目

使用方法和配置说明

基本使用步骤

1. 拉取镜像

   bash
   docker pull [镜像仓库地址]/php-deploy:latest
   

2. 基本运行命令

   bash
   docker run -it --rm \
     -v /本地/php应用目录:/app \
     -e WORKDIR=/app \
     -e RSYNC_SRC=/app/dist \
     -e RSYNC_DEST=user@远程服务器:/var/www/html \
     [镜像仓库地址]/php-deploy:latest
   

环境变量配置

构建与同步流程

容器启动后默认执行以下流程：

1. 进入WORKDIR目录
2. 执行composer install ${COMPOSER_FLAGS}安装PHP依赖
3. 执行yarn ${YARN_FLAGS}处理前端依赖（如yarn build构建资源）
4. 执行rsync -avz ${RSYNC_SRC} ${RSYNC_DEST}同步文件

docker-compose配置示例

yaml
version: '3'
services:
  php-deploy:
    image: [镜像仓库地址]/php-deploy:latest
    volumes:
      - ./local-php-app:/app
      - ~/.ssh:/root/.ssh  # 远程同步需挂载SSH密钥
    environment:
      - WORKDIR=/app
      - RSYNC_SRC=/app/dist
      - RSYNC_DEST=***:/var/www/myapp
      - COMPOSER_FLAGS=--no-dev --optimize-autoloader
      - YARN_FLAGS=build --production