使

使用 Docker 进行 Symfony 5 开发 MySQL 数据库 PHP-FPM NGINX Docker-Compose 配置 Symfony Play 时间

2025-06-09

使用 Docker 进行 Symfony 5 开发

MySQL 数据库

PHP-FPM

NGINX

Docker-Compose 配置

Symfony

游戏时间

我们上周在玩 Kubernetes ，但是该项目只是一个带有 phpinfo() 函数调用的小型 PHP 文件，没什么大不了的。

今天同事请我帮他学习一下 Docker，因为他想用一个实际的例子来试试：开发一个Symfony项目。那就来试试吧，快速、简单、有趣！

Symfony 使用Composer来管理其依赖项、脚本、命名空间等，文件名为 composer.json。依赖项将下载到名为vendor 的目录中。

专注于开发，我们希望创建一个已配置好且隔离的环境，以便任何人都可以轻松克隆代码库并运行应用程序。因此，我们将使用 3 个容器：

  • MySQL，带有挂载卷用于数据持久化
  • PHP-FPM，带有用于应用程序代码的挂载卷
  • NGINX，带有用于配置、日志的挂载卷，并与 PHP-FPM 共享挂载卷，用于应用程序的资产

替代文本

我们还需要使用一些环境变量作为容器的参数，例如数据库凭证、应用程序密钥等……

我们将使用Docker-Compose来配置并运行所有容器。

Project
│
├── docker-compose.yml
│
├── database/
│   ├── Dockerfile
│   └── data/
│
└── php-fpm/
│   └── Dockerfile
│
├── nginx/
│   ├── Dockerfile
│   └── nginx.conf
│
└── logs/
    └── nginx/
Enter fullscreen mode Exit fullscreen mode

MySQL 数据库

让我们创建一个 MariaDB 容器

# docker/database/Dockerfile

FROM mariadb:latest
CMD ["mysqld"]
EXPOSE 3306
Enter fullscreen mode Exit fullscreen mode

解释

  • 我们使用MariaDB官方镜像
  • 运行 mysqld 启动服务器
  • 公开端口 3306 用于数据库连接

PHP-FPM

使用 PHP-FPM 容器时，我们希望在启动时安装依赖项并运行数据库迁移。因此，我们需要安装 PDO MySQL 扩展，然后安装 Composer，最后安装 Symfony 迁移脚本。

但是，如果我们在 MySQL 服务器准备就绪之前运行迁移，可能会出现问题。我们也需要处理这个问题。

使用 Docker-compose，我们可以指定一个depends_on配置来让它等待另一个容器。但这并不意味着 Docker-compose 会等到 MySQL 服务器准备就绪，它只会等到 MySQL 容器启动。

幸运的是，借助wait-for-it脚本，我们可以尝试等到 MySQL 容器的 3306 端口打开（或者您甚至可以尝试等到可以使用凭据连接到 MySQL）。

# docker/php-fpm/Dockerfile

FROM php:fpm-alpine
COPY wait-for-it.sh /usr/bin/wait-for-it
RUN chmod +x /usr/bin/wait-for-it
RUN apk --update --no-cache add git
RUN docker-php-ext-install pdo_mysql
COPY --from=composer /usr/bin/composer /usr/bin/composer
WORKDIR /var/www
CMD composer install ; wait-for-it database:3306 -- bin/console doctrine:migrations:migrate ;  php-fpm 
EXPOSE 9000
Enter fullscreen mode Exit fullscreen mode

解释

  • 我们使用PHP-FPM官方镜像
  • 将 wait-for-it 脚本复制到容器中
  • 允许执行等待
  • 添加 git 来安装依赖项
  • 安装 PHP PDO MySQL
  • 从 Composer 官方镜像中获取 Composer 文件
  • 将工作目录设置为 /var/www
  • 安装依赖项，然后等待 MySQL 容器处于联机状态，再运行迁移脚本。最后，运行 php-fpm 启动服务器
  • 公开 PHP-FPM 端口（9000）

NGINX

好的，这部分有点复杂，我们将创建 NGINX 配置文件、PHP-FPM 代理和用于默认 NGINX 站点的单独文件。

首先是 Dockerfile 定义

# docker/nginx/Dockerfile

FROM nginx:alpine
WORKDIR /var/www
CMD ["nginx"]
EXPOSE 80
Enter fullscreen mode Exit fullscreen mode

解释

  • 同上，我们使用NGINX官方镜像
  • 将工作目录设置为 /var/www，与 PHP-FPM 位于同一目录，因为我们将与已安装的卷共享该目录
  • 启动 nginx
  • 暴露 80 端口用于 web

现在，NGINX 服务器配置

# docker/nginx/nginx.conf
user  nginx;
worker_processes  4;
daemon off;

error_log  /var/log/nginx/error.log warn;
pid        /var/run/nginx.pid;

events {
    worker_connections  1024;
}


http {
    include       /etc/nginx/mime.types;
    default_type  application/octet-stream;
    access_log  /var/log/nginx/access.log;
    sendfile        on;
    keepalive_timeout  65;

    include /etc/nginx/conf.d/*.conf;
    include /etc/nginx/sites-available/*.conf;
}
Enter fullscreen mode Exit fullscreen mode

NGINX – PHP-FPM 配置

# docker/nginx/conf.d/default.conf

upstream php-upstream {
    server php-fpm:9000;
}
Enter fullscreen mode Exit fullscreen mode

以及 NGINX 站点的配置

# docker/nginx/sites/default.conf

server {
    listen 80 default_server;
    listen [::]:80 default_server ipv6only=on;

    server_name localhost;
    root /var/www/public;
    index index.php index.html index.htm;

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

    location ~ \.php$ {
        try_files $uri /index.php =404;
        fastcgi_pass php-upstream;
        fastcgi_index index.php;
        fastcgi_buffers 16 16k;
        fastcgi_buffer_size 32k;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_read_timeout 600;
        include fastcgi_params;
    }

    location ~ /\.ht {
        deny all;
    }
}
Enter fullscreen mode Exit fullscreen mode

Docker-Compose 配置

我们有 3 个容器定义，现在我们只需要设置一个 Docker-compose 配置来将它们连接在一起：

# docker/docker-compose.yml
version: '3'

services:
  database:
    build:
      context: ./database
    environment:
      - MYSQL_DATABASE=${DATABASE_NAME}
      - MYSQL_USER=${DATABASE_USER}
      - MYSQL_PASSWORD=${DATABASE_PASSWORD}
      - MYSQL_ROOT_PASSWORD=${DATABASE_ROOT_PASSWORD}
    ports:
      - "3306:3306"
    volumes:
      - ./database/init.sql:/docker-entrypoint-initdb.d/init.sql
      - ./database/data:/var/lib/mysql

  php-fpm:
    build:
      context: ./php-fpm
    depends_on:
      - database
    environment:
      - APP_ENV=${APP_ENV}
      - APP_SECRET=${APP_SECRET}
      - DATABASE_URL=mysql://${DATABASE_USER}:${DATABASE_PASSWORD}@database:3306/${DATABASE_NAME}?serverVersion=5.7
    volumes:
      - ../src:/var/www

  nginx:
    build:
      context: ./nginx
    volumes:
      - ../src:/var/www
      - ./nginx/nginx.conf:/etc/nginx/nginx.conf
      - ./nginx/sites/:/etc/nginx/sites-available
      - ./nginx/conf.d/:/etc/nginx/conf.d
      - ./logs:/var/log
    depends_on:
      - php-fpm
    ports:
      - "80:80"
Enter fullscreen mode Exit fullscreen mode

以及示例环境变量：

# docker/.env

DATABASE_NAME=symfony
DATABASE_USER=appuser
DATABASE_PASSWORD=apppassword
DATABASE_ROOT_PASSWORD=secret

APP_ENV=dev
APP_SECRET=24e17c47430bd2044a61c131c1cf6990
Enter fullscreen mode Exit fullscreen mode

Symfony

让我们继续进行 Symfony 安装：

$ symfony new src
Enter fullscreen mode Exit fullscreen mode

游戏时间

一切设置正确！让我们开始玩容器吧！

$ docker-compose up
Enter fullscreen mode Exit fullscreen mode

当这些容器准备就绪后，您就可以打开http://localhost 了，您将看到 Symfony 5 欢迎屏幕。一切运行正常，祝您使用愉快！

我已经为我们上面讨论的所有文件创建了一个存储库https://gitlab.com/martinpham/symfony-5-docker

鏂囩珷鏉ユ簮锛�https://dev.to/martinpham/symfony-5-development-with-docker-4hj8
Devto 翻译
PREV
🚀 2025 年十大 Vercel 替代方案 🌐
NEXT
玩转 Kubernetes - 第一章 GenAI LIVE! | 2025 年 6 月 4 日