4programmers/php-node

PHP with Node.js 镜像文档

镜像概述

本镜像集成了PHP和Node.js运行环境，旨在为需要同时依赖PHP后端服务与Node.js工具链（如前端构建、脚本执行等）的应用提供统一部署环境。通过单一容器即可满足PHP应用运行与Node.js辅助任务（如资源打包、自动化脚本）的需求，减少多容器协调复杂度。

核心功能和特性

• 多环境集成：同时包含PHP运行时与Node.js环境，无需额外容器即可满足混合依赖场景
• 工具链完整：内置PHP常用扩展（如mbstring、curl、json等）与Node.js包管理工具npm/yarn
• 灵活配置：支持通过环境变量自定义PHP.ini参数与Node.js运行配置
• 轻量基础：基于Debian或Alpine Linux构建，平衡功能与镜像体积

使用场景和适用范围

• PHP后端应用需通过Node.js工具（如Webpack、Gulp）构建前端资源
• 同一服务需同时运行PHP API与Node.js辅助服务（如定时任务、消息处理）
• 开发环境中需快速搭建同时支持PHP和Node.js的测试环境
• CI/CD流程中需在单一容器内完成PHP代码运行与Node.js构建步骤

使用方法和配置说明

基本使用（docker run）

bash
# 启动容器并映射应用目录
docker run -d \
  -p 8080:80 \          # 映射PHP Web服务端口
  -v $(pwd)/app:/app \  # 挂载本地应用代码目录
  -e PHP_INI_SETTINGS="display_errors=On" \  # 自定义PHP配置
  -e NODE_ENV=production \  # 设置Node.js环境变量
  php-with-node

Docker Compose配置

yaml
version: '3.8'
services:
  app:
    image: php-with-node
    ports:
      - "8080:80"
    volumes:
      - ./app:/app
      - ./php.ini:/usr/local/etc/php/php.ini  # 挂载自定义php.ini
      - ./node_modules:/app/node_modules     # 持久化Node.js依赖
    environment:
      - PHP_INI_SETTINGS="memory_limit=512M"
      - NODE_ENV=development
    restart: unless-stopped

环境变量配置

自定义配置

1. PHP配置：通过挂载外部php.ini文件覆盖默认配置

   bash
   docker run -v $(pwd)/custom-php.ini:/usr/local/etc/php/php.ini php-with-node
   

2. Node.js依赖安装：在应用目录中添加package.json，容器启动时自动执行npm install（需配合启动脚本）

   dockerfile
   # 示例启动脚本（Dockerfile中配置CMD ["sh", "/app/start.sh"]）
   # start.sh内容
   #!/bin/sh
   cd /app && npm install  # 安装Node.js依赖
   php-fpm &               # 启动PHP服务
   node /app/辅助脚本.js    # 启动Node.js任务
   

进入容器调试

bash
# 查看运行中容器ID
docker ps
# 进入容器终端
docker exec -it [容器ID] /bin/bash
# 验证环境
php -v      # 查看PHP版本
node -v     # 查看Node.js版本
npm -v      # 查看npm版本