如何部署 Symfony 应用

基本文件传输

部署应用最基本的方法是通过 FTP/SCP（或类似方法）手动复制文件。这种方法有其缺点，因为您在升级过程中缺乏对系统的控制。此方法还需要您在传输文件后采取一些手动步骤（请参阅 常用部署任务）。

使用源代码控制

如果您使用源代码控制（例如 Git 或 SVN），您可以通过使您的在线安装也成为您仓库的副本进行简化。当您准备升级时，从您的源代码控制系统获取最新的更新。当使用 Git 时，一种常见的方法是为每个发布版本创建一个标签，并在部署时检出相应的标签（请参阅 Git 标签）。

这使得更新您的文件更容易，但您仍然需要担心手动执行其他步骤（请参阅 常用部署任务）。

使用平台即服务 (PaaS)

使用平台即服务 (PaaS) 可能是快速部署 Symfony 应用的好方法。有很多 PaaS，但我们推荐 Platform.sh，因为它提供了专门的 Symfony 集成并有助于资助 Symfony 开发。

使用构建脚本和其他工具

还有一些工具可以帮助减轻部署的痛苦。其中一些工具是专门为 Symfony 的需求量身定制的。

Deployer

这是 Capistrano 的另一个原生 PHP 重写版本，其中包含一些适用于 Symfony 的现成配方。

Ansistrano

一个 Ansible 角色，允许您通过 YAML 文件配置强大的部署。

Magallanes

这个类似 Capistrano 的部署工具是用 PHP 构建的，可能更容易让 PHP 开发人员根据自己的需求进行扩展。

Fabric

这个基于 Python 的库提供了一套基本操作，用于执行本地或远程 shell 命令以及上传/下载文件。

Capistrano 与 Symfony 插件

Capistrano 是一个用 Ruby 编写的远程服务器自动化和部署工具。Symfony 插件 是一个旨在简化 Symfony 相关任务的插件，灵感来源于 Capifony（仅适用于 Capistrano 2）。

A) 检查需求

运行 Symfony 应用有一些 技术要求。在您的开发机器中，检查这些要求的推荐方法是使用 Symfony CLI。但是，在您的生产服务器中，您可能更喜欢不安装 Symfony CLI 工具。在这些情况下，请在您的应用中安装此其他软件包

1

$ composer require symfony/requirements-checker

然后，确保检查器包含在您的 Composer 脚本中

1
2
3
4
5
6
7
8
9
10
11
12

{
    "...": "...",

    "scripts": {
        "auto-scripts": {
            "vendor/bin/requirements-checker": "php-script",
            "...": "..."
        },

        "...": "..."
    }
}

B) 配置您的环境变量

大多数 Symfony 应用从环境变量中读取其配置。在本地开发时，您通常会将这些变量存储在 .env 和 .env.local（用于本地覆盖）。在生产环境中，您有两种选择

1. 创建“真实”的环境变量。如何设置环境变量取决于您的设置：它们可以在命令行中设置，在您的 Nginx 配置中设置，或者通过您的托管服务提供的其他方法设置；
2. 或者，像您的本地开发一样创建一个 .env.local 文件。

这两种选择都没有明显的优势：使用在您的托管环境中最为自然的方式。

1

$ composer dump-env prod

1

$ composer dump-env prod --empty

C) 安装/更新您的供应商库

您的供应商库可以在传输您的源代码之前更新（即，更新 vendor/ 目录，然后将其与您的源代码一起传输），或者在之后在服务器上更新。无论哪种方式，都像平常一样更新您的供应商库

1

$ composer install --no-dev --optimize-autoloader

D) 清除您的 Symfony 缓存

确保您清除并预热您的 Symfony 缓存

1

$ APP_ENV=prod APP_DEBUG=0 php bin/console cache:clear

E) 其他事项！

根据您的设置，可能还有许多其他事情需要做

• 运行任何数据库迁移
• 清除您的 APCu 缓存
• 添加/编辑 CRON 任务
• 重启您的 Worker
• 使用 Webpack Encore 构建和压缩您的资源文件
• 如果您使用 AssetMapper 组件，则编译您的资源文件
• 将资源文件推送到 CDN
• 在使用 Apache Web 服务器的共享托管平台上，您可能需要安装 symfony/apache-pack 软件包
• 等等。

不使用 composer.json 文件的部署

项目根目录（其值通过 kernel.project_dir 参数和 getProjectDir() 方法使用）由 Symfony 自动计算为存储主 composer.json 文件的目录。

在不使用 composer.json 文件的部署中，您需要覆盖 getProjectDir() 方法 如本节中所述。