步骤 3: 从零开始直到投入生产环境

步骤 3: 从零开始直到投入生产环境

我喜欢迅速行动。我想要我们的小项目尽快上线，比如现在就上线，投入生产环境中。我们现在还没有开发任何东西，那我们就从一个漂亮简约的“在建设中”页面开始。你会喜欢它的！

花点时间去试着找一张你满意的老式“在建设中” GIF 动图。我要用的是这张：

我告诉过你了，这会非常有趣的。

初始化项目

我们之前已经一起安装了 symfony 命令行工具，现在用它来创建一个新的 Symfony 项目。

$ symfony new guestbook --version=5.2
$ cd guestbook

这个命令对 Composer 做了一层简单的封装，用来方便地创建 Symfony 项目。它使用一个包含了最少依赖的项目骨架，这些依赖是几乎所有项目都要用到的 Symfony 组件：一个控制台工具和创建 web 应用必需的 HTTP 抽象。

如果你去看一下这个项目骨架在 GitHub 上的代码仓库，你会注意到它只有一个 composer.json 文件，几乎是空的。但是 guestbook 目录下有好多文件了，这是怎么做到的？答案就在 symfony/flex 这个包里。Symfony Flex 是一个 Composer 插件，它可以介入到包的安装过程中。当它检测到新装的包对应有一个 recipe，这个插件就会执行它。

Symfony Recipe 的主入口是一个 manifest 文件，它描述了在 Symfony 应用中自动注册一个包时所进行的操作。你在 Symfony 应用下安装一个包的时候，永远不需要去阅读包的 README 文件。自动化是 Symfony 的重要特点。

因为 Git 已经在你的电脑上安装过了，所以 symfony new 也会为我们创建一个 Git 仓库，并且会进行首次代码提交。

看一下目录结构：

├── bin/
├── composer.json
├── composer.lock
├── config/
├── public/
├── src/
├── symfony.lock
├── var/
└── vendor/

bin/ 目录包含了主要的命令行入口：console 程序。你会一直用到它。

config/ 目录由一套配置文件组成，它们提供了合理的缺省值。每个包对应一个配置文件。你很少会改动它们，信赖缺省值几乎总是个好主意。

public/ 目录是 web 根目录，下面的 index.php 脚本是所有 HTTP 动态资源的主入口。

src/ 目录存放你将要写的代码；你大部分时间都会花在里面。默认情况下，该目录下所有类都是用 App 作为命名空间。这里是你的主目录、你的代码、你的业务逻辑。Symfony 把这个目录下的主动权留给你。

var/ 目录包含了缓存，日志和其它应用程序运行时产生的文件。你可以不用管它。它是生产环境下唯一一个需要写权限的目录。

vendor/ 目录包含了所有由 Composer 安装的包，包括 Symfony 本身。这个目录是提高生产率的秘密武器。我们不要重新发明轮子，而是要依赖已有的程序库来完成那些困难的工作。这个目录由 Composer 管理，永远不要去动它。

这就是你目前所需知道的一切。

创建一些公开可访问资源

public/ 目录下的任何文件都是可以通过浏览器直接访问的。比如说，如果你把你的 GIF 动图文件（把它命名为 under-construction.gif）移动到新建的 public/images/ 目录下，它就可以通过诸如 https://localhost/images/under-construction.gif 这样的 URL 来访问。

在这里下载我的 GIF 图：

$ mkdir public/images/
$ php -r "copy('http://clipartmag.com/images/website-under-construction-image-6.gif', 'public/images/under-construction.gif');"

启动本地 web 服务器

symfony 命令自带了一个为开发工作优化过的 web 服务器。如果我和你说它和 Symfony 搭配得很好，你不会惊讶的。但注意，不要在生产环境中使用这个 web 服务器。

在项目目录下，以后台运行的方式启动 web 服务器（用 -d 选项）：

$ symfony server:start -d

web 服务器启动了，它会使用从 8000 端口开始的第一个可用端口。你可以执行如下命令作为快捷方式，从而在浏览器里打开网站：

$ symfony open:local

你的默认浏览器应该会获得焦点，并且新开一个标签页，展示出和下图类似的内容：

小技巧

运行 symfony server:log 来排查问题，它会把来自 web 服务器，PHP 和应用程序的最新日志显示出来。

浏览到 /images/under-construction.gif。看上去像是这样吗？

满意了吧？让我们来提交我们的代码。

$ git add public/images
$ git commit -m'Add the under construction image'

添加一个 favicon

浏览器会请求 favicon，缺失它的话，日志里会产生大量的 404 HTTP 错误消息。为了避免这种情况，让我们现在来加一个 favicon：

$ php -r "copy('https://symfony.com/favicon.ico', 'public/favicon.ico');"
$ git add public/
$ git commit -m'Add a favicon'

为生产环境做准备

把我们的工作发布到生产环境中，你觉得如何？我知道，我们甚至还没有一个正式的 HTML 页面来欢迎我们的用户。但哪怕是在生产服务器上看到那个”在建设中“的图片，也是向前迈进的伟大一步。你知道这句格言：尽早部署，经常部署。

你可以把你的应用放在任何支持 PHP 的主机供应商那里……这意味着市面上几乎所有的主机供应商。但还是要做几点检查：我们想要最新的 PHP 版本，而且需要有数据库、消息队列和其它更多的服务。

我做了我的选择，那就是用 SymfonyCloud。它提供了我们所需的一切，而且它的收入也会用来资助Symfony的开发。

symfony 命令内置对 SymfonyCloud 的支持。让我们来初始化一个 SymfonyCloud 项目：

$ symfony project:init

这个命令会生成几个 SymfonyCloud 所需的新文件：.symfony/services.yaml、.symfony/routes.yaml 和 .symfony.cloud.yaml。

把它们纳入 Git 的管理，并且提交：

$ git add .
$ git commit -m"Add SymfonyCloud configuration"

注解

git add . 命令意味着包含所有文件，所以执行它会有点危险，但在这里使用没有问题，因为一个 .gitignore 文件已经生成，它会自动排除所有我们不想要提交的文件。

进入生产环境

部署的时刻？

新建一个 SymfonyCloud 项目：

$ symfony project:create --title="Guestbook" --plan=development

这个命令会做很多工作：

你第一次执行这个命令的时候，如果还没有用你的 SymfonyConnect 凭证来认证过身份的话，请做一下。
它会在 SymfonyCloud 上创建一个新项目（对于每个新的开发项目，你都有 7 天的免费使用期）。

然后就部署：

$ symfony deploy

把代码推送到 Git 代码仓库后，它就会部署好。在该命令执行后，这个项目就会有一个特定的域名，可以用来访问这个项目。

检查一下，看一切是否顺利运行：

$ symfony open:remote

你应该会看到一个 404 错误页面，但浏览 /images/under-construction.gif 的话，你应该会看到我们的图片。

请注意你在 SymfonyCloud 上不会看到那个漂亮的 Symfony 默认页面。为什么呢？你一会就会知道 Symfony 支持若干环境变量，而 SymfonyCloud 把代码自动部署在了生产环境下。

小技巧

如果你要在 SymfonyCloud 上删除项目，就用 project:delete 命令。

深入学习

在 Symfony 的 recipe 服务器上，你能找到开发 Symfony 应用时所有可用的 recipe。
这个 recipe 仓库里有 Symfony 官方 recipe，也有社区贡献的 recipe，你可以把自己的 recipe 提交到后者。
Symfony 本地 web 服务器；
SymfonyCloud 文档。

This work, including the code samples, is licensed under a Creative Commons BY-NC-SA 4.0 license.