Ubuntu上部署Docker管理PHP环境-精创网络云防护

帮助文档
Ubuntu上部署Docker管理PHP环境
来源：www.jcwlyf.com更新时间：2025-01-15
随着现代开发技术的不断发展，Docker已经成为开发者在部署和管理应用时的重要工具。特别是对于PHP开发环境的管理，Docker为开发者提供了高度灵活和可重复的环境配置，使得PHP应用能够在不同的开发和生产环境中保持一致性。本文将详细介绍如何在Ubuntu上使用Docker来管理PHP环境，涵盖从Docker安装到配置PHP环境的所有步骤，旨在帮助开发者更好地理解和使用Docker管理PHP环境。
本文将分为几个部分来详细介绍：如何安装Docker、如何创建PHP环境的Docker镜像、如何配置PHP及其常用扩展、如何连接MySQL数据库、以及如何部署应用等。通过这些步骤，您将能够轻松构建一个完整的PHP开发和生产环境。
一、在Ubuntu上安装Docker
在开始之前，首先需要在Ubuntu系统上安装Docker。Docker是一个开源的应用容器引擎，可以使应用在任何地方都能快速部署和运行。安装Docker的过程相对简单，下面是具体的步骤：
```
sudo apt update
sudo apt install -y apt-transport-https ca-certificates curl software-properties-common
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io
```
安装完成后，您可以使用以下命令验证Docker是否安装成功：
```
docker --version
```
如果安装成功，系统将显示Docker的版本信息。
二、安装Docker Compose
Docker Compose是一个用于定义和运行多容器Docker应用的工具。对于PHP环境，通常会涉及到多个服务，如PHP、Nginx和MySQL等。通过Docker Compose，我们可以使用一个配置文件来同时启动多个服务。
在Ubuntu上安装Docker Compose的步骤如下：
```
sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
sudo chmod +x /usr/local/bin/docker-compose
```
安装完成后，使用以下命令确认Docker Compose是否安装成功：
```
docker-compose --version
```
三、创建Dockerfile构建PHP环境
接下来，我们需要创建一个Dockerfile，用于构建PHP环境的镜像。Dockerfile是一个文本文件，包含了一组指令，用来自动化构建Docker镜像。在这个步骤中，我们将创建一个基本的PHP环境，并安装一些常用的PHP扩展。
首先，创建一个名为"Dockerfile"的文件，内容如下：
```
FROM php:8.0-fpm

# 安装常用扩展
RUN docker-php-ext-install pdo pdo_mysql mysqli

# 安装其他依赖
RUN apt-get update && apt-get install -y libpng-dev libjpeg-dev libfreetype6-dev
RUN docker-php-ext-configure gd --with-freetype --with-jpeg
RUN docker-php-ext-install gd

# 清理缓存
RUN apt-get clean && rm -rf /var/lib/apt/lists/*

# 设置工作目录
WORKDIR /var/www/html
```
上面的Dockerfile基于PHP 8.0 FPM镜像构建，安装了常见的PHP扩展，如PDO、MySQLi和GD库等。您可以根据自己的需求添加其他扩展。
四、使用Docker Compose配置PHP-Nginx-MySQL环境
在实际开发中，我们通常需要同时运行多个服务，如Web服务器（Nginx）、PHP服务以及数据库服务（MySQL）。Docker Compose允许我们使用一个"docker-compose.yml"文件来定义这些服务，并通过一个命令启动所有服务。
下面是一个简单的"docker-compose.yml"文件，它定义了三个服务：PHP-FPM、Nginx和MySQL。
```
version: '3.7'

services:
  php:
    build: .
    container_name: php-fpm
    volumes:
      - ./src:/var/www/html
    networks:
      - app_network

  nginx:
    image: nginx:latest
    container_name: nginx
    volumes:
      - ./src:/var/www/html
      - ./nginx.conf:/etc/nginx/nginx.conf
    ports:
      - "80:80"
    depends_on:
      - php
    networks:
      - app_network

  mysql:
    image: mysql:5.7
    container_name: mysql
    environment:
      MYSQL_ROOT_PASSWORD: rootpassword
      MYSQL_DATABASE: app_db
    volumes:
      - mysql-data:/var/lib/mysql
    networks:
      - app_network

networks:
  app_network:
    driver: bridge

volumes:
  mysql-data:
```
该配置定义了一个PHP服务，它将从当前目录的Dockerfile构建PHP镜像；一个Nginx服务，它将通过Nginx的默认配置文件提供PHP内容；以及一个MySQL服务，它使用MySQL 5.7版本并设置了一个数据库和密码。
在此配置文件中，我们还定义了一个自定义的网络"app_network"，使得所有容器可以相互通信。此外，Nginx和PHP服务都使用了"volumes"来挂载本地目录（"./src"）到容器的工作目录，这样就可以实时同步代码。
五、配置Nginx和PHP的连接
在Docker Compose配置中，Nginx和PHP服务通过自定义的网络相互连接。我们需要配置Nginx，以便它能够正确地与PHP-FPM服务配合工作。
首先，创建一个"nginx.conf"文件，并添加以下内容：
```
server {
    listen 80;
    server_name localhost;

    root /var/www/html;
    index index.php;

    location / {
        try_files $uri $uri/ /index.php?$args;
    }

    location ~ \.php$ {
        fastcgi_pass php:9000;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
        include fastcgi_params;
    }
}
```
这个配置文件告诉Nginx，在处理".php"文件时，应该将请求转发到PHP-FPM容器的9000端口。这里的"php"是Docker Compose中PHP服务的名称，它在自定义网络"app_network"中可以被Nginx访问。
六、构建并启动服务
完成以上配置后，我们可以开始构建并启动我们的Docker服务。进入项目目录，并运行以下命令：
```
docker-compose up --build
```
该命令会根据"docker-compose.yml"文件构建镜像，并启动所有服务。完成后，您可以在浏览器中访问"http://localhost"，即可看到PHP环境和Nginx服务正常工作。
七、总结
通过本文的介绍，我们详细探讨了如何在Ubuntu上使用Docker部署和管理PHP环境。我们从安装Docker开始，介绍了如何构建自定义PHP镜像，如何使用Docker Compose配置PHP-Nginx-MySQL服务，最后展示了如何启动并运行这些服务。Docker为PHP环境的管理提供了极大的便利，能够确保开发和生产环境的一致性，同时也提升了开发效率。
希望通过本文的讲解，您能够轻松上手并使用Docker来管理PHP应用。如果您在实践过程中遇到任何问题，欢迎随时查阅相关文档或向社区求助。