docker如何安装php项目

发布时间：2021-12-21 10:33:12 作者：小新
来源：亿速云阅读：277

# Docker如何安装PHP项目

## 前言

在现代Web开发中，Docker已成为不可或缺的工具。它通过容器化技术解决了"在我机器上能运行"的经典问题，特别适合PHP项目的环境配置。本文将详细介绍如何使用Docker安装和运行PHP项目，涵盖从基础概念到实际部署的全过程。

## 一、Docker基础概念

### 1.1 什么是Docker

Docker是一个开源的容器化平台，允许开发者将应用及其依赖打包到轻量级、可移植的容器中。与传统虚拟机不同，Docker容器共享主机操作系统内核，启动更快且资源占用更少。

### 1.2 核心组件

- **镜像(Image)**：只读模板，包含运行应用所需的文件系统
- **容器(Container)**：镜像的运行实例
- **Dockerfile**：定义镜像构建步骤的脚本
- **docker-compose.yml**：定义多容器应用配置的文件

## 二、安装前准备

### 2.1 系统要求

- 64位Linux、Windows 10/11或macOS
- 至少4GB RAM（复杂项目建议8GB+）
- 20GB可用磁盘空间

### 2.2 Docker安装

#### Ubuntu示例：
```bash
sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl enable --now docker
sudo usermod -aG docker $USER  # 当前用户加入docker组

安装后验证：

docker --version
docker-compose --version
docker run hello-world

三、单容器PHP项目部署

3.1 准备PHP项目

假设项目结构如下：

my-php-app/
├── public/
│   └── index.php
├── src/
└── composer.json

3.2 编写Dockerfile

# 使用官方PHP镜像
FROM php:8.1-apache

# 安装依赖
RUN apt update && apt install -y \
    libzip-dev \
    zip \
    && docker-php-ext-install zip pdo_mysql

# 启用Apache重写模块
RUN a2enmod rewrite

# 复制项目文件
COPY . /var/www/html/
WORKDIR /var/www/html

# 安装Composer依赖
RUN curl -sS https://getcomposer.org/installer | php -- --install-dir=/usr/local/bin --filename=composer
RUN composer install --no-dev

# 设置权限
RUN chown -R www-data:www-data /var/www/html

3.3 构建并运行容器

docker build -t my-php-app .
docker run -d -p 8080:80 --name php-container my-php-app

访问 http://localhost:8080 即可查看项目

四、多容器环境部署（LAMP）

4.1 docker-compose.yml示例

version: '3.8'

services:
  app:
    build: .
    ports:
      - "8000:80"
    volumes:
      - ./:/var/www/html
    depends_on:
      - db
    environment:
      DB_HOST: db

  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: rootpass
      MYSQL_DATABASE: app_db
      MYSQL_USER: app_user
      MYSQL_PASSWORD: userpass
    volumes:
      - mysql_data:/var/lib/mysql

  phpmyadmin:
    image: phpmyadmin/phpmyadmin
    ports:
      - "8080:80"
    environment:
      PMA_HOST: db
    depends_on:
      - db

volumes:
  mysql_data:

4.2 常用命令

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f app

# 执行命令（如Composer）
docker-compose exec app composer update

# 停止服务
docker-compose down

五、高级配置技巧

5.1 自定义PHP配置

在项目根目录创建 php.ini 文件，然后在Dockerfile中添加：

COPY php.ini /usr/local/etc/php/conf.d/custom.ini

5.2 使用Xdebug调试

修改Dockerfile：

RUN pecl install xdebug && docker-php-ext-enable xdebug
COPY xdebug.ini /usr/local/etc/php/conf.d/xdebug.ini

xdebug.ini内容示例：

zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=host.docker.internal
xdebug.start_with_request=yes

5.3 多阶段构建优化

# 构建阶段
FROM composer:2 AS builder
WORKDIR /app
COPY . .
RUN composer install --no-dev --optimize-autoloader

# 生产阶段
FROM php:8.1-apache
COPY --from=builder /app /var/www/html

六、常见问题解决

6.1 权限问题

解决方案：

RUN chown -R www-data:www-data /var/www/html \
    && find /var/www/html -type d -exec chmod 755 {} \; \
    && find /var/www/html -type f -exec chmod 644 {} \;

6.2 性能优化

使用 :delegated 挂载模式（Mac/Windows） “`yaml volumes:
- ./:/var/www/html:cached
”`
禁用Xdebug生产环境

6.3 数据库连接问题

确保： - 容器在同一个网络 - 使用服务名作为主机名（如上述示例中的db） - 检查环境变量是否正确传递

七、实际项目示例

7.1 Laravel项目配置

修改docker-compose.yml：

services:
  app:
    environment:
      APP_ENV: local
      APP_KEY: base64:...
      DB_CONNECTION: mysql
      DB_HOST: db
      DB_PORT: 3306
    volumes:
      - ./:/var/www/html
    command: >
      sh -c "php artisan migrate --force &&
             apache2-foreground"

7.2 WordPress部署

services:
  wordpress:
    image: wordpress:php8.1
    ports:
      - "8000:80"
    environment:
      WORDPRESS_DB_HOST: db
      WORDPRESS_DB_USER: wpuser
      WORDPRESS_DB_PASSWORD: wppass
    volumes:
      - wordpress_data:/var/www/html

八、生产环境建议

使用专门的生产镜像（如 php:fpm-alpine）

配置适当的资源限制：


deploy:
 resources:
   limits:
     cpus: '0.5'
     memory: 512M

启用HTTPS（使用Nginx反向代理）
实现日志轮转和监控

结语

通过Docker部署PHP项目可以确保环境一致性，简化协作流程。本文涵盖了从单容器简单部署到复杂多服务编排的全过程。实际应用中，建议根据项目需求调整配置，并参考官方文档获取最新最佳实践。

附录

常用命令速查

命令	描述
`docker ps`	查看运行中的容器
`docker exec -it <container> bash`	进入容器
`docker system prune`	清理无用资源
`docker-compose restart`	重启服务