打包和部署 Symfony 网站

Question

我是 Symfony 的新手，来自 .NET 世界。使用 Symfony (4) 文档，我设法创建了简单的网站。现在我想把它付诸实践，但我正在努力寻找任何有用的信息，我应该怎么做才能“打包”所有必要的东西并部署它。确实，有描述部署的页面 (How to Deploy a Symfony Application)，但我发现它缺少以下信息：

• 包含/排除什么（显然我不想打包dev 依赖项，部署composer 文件似乎也没有任何意义）
• 要更改什么（有 .env 文件 - 包含 APP_ENV 和 APP_SECRET - 我在哪里使用这些值？）
• 我的主机使用文件夹www 进行公开演示，在将public 目录重命名为www 之前是否必须更改/配置某些内容？
• 我是否必须配置 .htaccess 以不通过 PHP 路由图像/css/js？

我目前的项目结构是：

+ bin
+ config
+ public
  + css
  - index.php
+ src
  + Controller
  - Kernel.php
+ templates
+ var
+ vendor
- .env
- .gitignore
- composer.json
- composer.lock
- symfony.lock

---

编辑（2018-07-17）：

• 我正在使用 git
• 托管能够从名为production 的git 分支进行部署（每当我推送到此分支时，它都会调用composer install --no-dev）
• 配置公共目录名称在composer.json 中完成

composer.json 中的额外配置示例：

"extra": {
    "symfony": {
        "allow-contrib": false
    },
    "public-dir": "www"
}

关于我最初的问题 - 我现在使用 git 使用托管部署功能。在这种情况下，我确实需要作曲家文件。我最初的想法是构建和打包最少的东西，然后将此包部署到服务器。 （现在我还部署了bin、作曲家文件或.gitignore（可能还有更奇怪的东西）。

Answer 1

好吧，我会拍的。

要包含/排除的内容（显然我不想打包 dev 依赖项，并且部署作曲家文件似乎也没有 任何意义）

我注意到您没有.gitignore。如果你不使用 GIT（你应该）看看默认的 gitignore，它会告诉你哪些文件夹是你不需要的。

您是对的，供应商不是必需的。 Composer 的锁定文件包含您正在使用的确切版本。将文件复制到服务器后，只需执行composer install。 “部署”的最简单方法是使用 git(hub)，并在您的服务器上设置一个 ssh 密钥，并授予它对您的 git repo 的读取权限。 （部署密钥）

要更改的内容（有 .env 文件 - 包含 APP_ENV 和 APP_SECRET - 我在哪里使用这些值？）

.env 文件默认只能在开发模式下工作。 （注意 composer.json 中的 require-dev 部分）。

Symfony 建议在生产环境中使用“真实”环境变量，但您可以使用.env 文件。为此，您必须在 composer.json 中将 "symfony/dotenv" 从 require-dev 移动到 require。 （之后进行更新）

您还需要将 APP_ENV 设置为服务器上的 prod，同时配置 db access 和 mailer。

我的主机使用文件夹 www 进行公开展示，在将公共目录重命名为 www 之前我是否必须更改/配置某些内容？

我不会完全回答这个问题，那会花费太长时间。使用 VirtualHost 将 apache 配置为指向您的公共目录。更多内容：https://symfony.com/doc/current/setup/web_server_configuration.html

我是否必须将 .htaccess 配置为不路由图像/css/js 槽 PHP？

如果你安装了 apache 包，你会得到一个 .htaccess 文件，它会忽略文件。

# If the requested filename exists, simply serve it.
# We only want to let Apache serve files and not directories.
RewriteCond %{REQUEST_FILENAME} -f
RewriteRule ^ - [L]

这种方式请求的文件不会命中您的 PHP 代码。 但是，如果文件不存在，Symfony 将处理该请求。 我建议忽略常见的文件扩展名，例如：

# Do not allow image requests to hit symfony
RewriteCond %{REQUEST_URI} \.(gif|jpg|jpeg|png|ico|map)$ [NC]
RewriteRule .* - [L]

Answer 2

TL;DR

由于 PHP 不是一种编译语言，因此此处不涉及将代码编译为可执行文件的“构建”过程。

构建无状态容器

但是，如果您正在开发一个 Web 应用程序并且想要部署它，那么最好的方法（即行业标准）是从中“构建”一个无状态容器。在那个容器中，通常会有 Apache + PHP，或 Ngnix + PHP-FPM（甚至只是 PHP 和 PHP-PM）。这将是您的应用程序进程，通过端口 80 公开：一个漂亮、无状态且可扩展的 docker 容器。

在构建容器的过程中，您的想法是安装您选择的 PHP 版本（带有相关扩展）以及将通过 HTTP 端口运行的 Web 服务器或进程。然后，您使用 git 将代码拉入容器并设置环境变量，然后执行 composer install。结果将是一个包含应用程序版本的 docker 映像，可通过端口 80 访问。

更多关于 here.

嗯，不，我不做容器

当然，这可能不适合您，这取决于您的应用程序对the principles of a twelve factor app 的关注程度以及您将在何处托管它。

如果您想部署到共享主机，您需要更改主机提供商的文档根目录的public 文件夹。由于您无法访问共享主机中的 PHP 运行时，因此您需要复制 .env 文件并将其发送到网络主机（这是一种非常不安全的做法）。

要设置自动部署，您应该首选ssh。如果您没有控制台访问您的虚拟主机，那么git-ftp 可能是您最好的朋友。通过使用 webhook（例如在 Github 上），在接收后事件中，您将部署运行脚本的代码，该脚本将具有作曲家安装（具有锁定的依赖项）和所有内容到 www -data 用户（或网络服务器用户）。

现在，正确的答案

话虽如此，我会尽力回答你的一些问题：

1. 你是对的。 vendor/ 应该远离。但是不是composer.lock。基本上，您必须部署存储库中的所有代码。

2. 在您的部署脚本中（是的，您将拥有一个），您应该创建一个要添加的新 .env 文件。是的，您需要其中的所有参数，但显然需要生产环境的值。

3. 是的，您应该将 symfony 的 public 文件夹重命名为 www。就我而言，你不应该遇到问题。也就是说，除非您使用 symfony 服务器进行开发。但是在您的项目中一个简单的php -S localhost:8000 -t www 就足以用于开发目的。我一直在使用它。

   4. 如果您使用的是 apache，是的，您应该在部署中包含一个 .htaccess。

您的更新

所以我看到您的主机具有 git 部署功能。那挺好的。在这种情况下，必须有一种方法可以在位于那里的 repo 中配置一个 post-receive 钩子。该 post-receive 可以执行任何 bash 命令，例如 composer install。但是，这将是 composer 可执行文件，但我不认为它会被包含在内。您可以做的是在您的托管根目录中上传composer.phar。它是作曲家，在一个可执行文件中。

然后，在您的 post-receive 钩子（也就是您的部署脚本）中，您将运行 composer install 和提到的 chown。

非请求建议

我了解您的要求是部署到虚拟主机。但是，您正在以一种不是当前行业标准的方式寻求 CI/CD 的好处。 Web 托管自然不是为部署管道而设计的。你现在这样做的方式可能会在未来给你带来一些痛苦，尤其是在添加一些其他支持服务或扩展等时......

现在，如果您的应用程序小而简单，您可能可以忽略我的话。