Vapor 快速上手教程——用 Swift 开始你的第一次服务端

苹果宣布 Swift 这门现代编程语言开源，我们就能够预见这门优雅语言的无限可能，而 Vapor 便是实现其用于服务器端开发可能的 Web 框架之一。

上手前的准备

Vapor 用 Swift 3 进行开发，因此必须先能够安装 Swift 3 的运行环境，而 Swift 暂时还只能在 macOS 和 Ubuntu 下编译运行。而这次的上手教程，将在 macOS 下进行。

先安装 Swift 3

在 macOS 下安装 Swift 3 十分容易，去 Mac App Store 下载安装 Xcode 8，并将其运行一次便好了。

Xcode Mac App Store

在终端运行下面这行命令进行兼容性检查，确保 Swift 3 已正确安装

curl -sL check.vapor.sh | bash

安装 Vapor Toolbox

安装 Vapor 工具十分简单，通过终端下载并运行官方提供的脚本即可自动安装

curl -sL toolbox.vapor.sh | bash
vapor --help    // 确认是否安装成功
vapor self update    // 升级最新版本以避免一些未知错误发生

创建 Vapor 新项目

进入存放项目的目录下，通过 Vapor Toolbox 快速创建

vapor new MyFirstVaporServer

这为我们创建了一个示例项目，文件结构基本如下

.
├── App
│   └── Controllers
│   └── Middleware
│   └── Models
│   └── main.swift
├── Public
├── Resources
│   └── Views
└── Package.swift

那么让我们先来关注 App 目录下的 main.swift 文件

Droplet 组件

let drop = Droplet()

在这个示例项目中，我们只创建了 Droplet，这个类在 Vapor 中发挥着举足轻重的作用，接下来将不断用到它。

Routing 路由

drop.get("hello") { request in
    return "Hello, world!"
}

这几行代码用 Droplet 创建了用 Get 方式访问到 /hello 的路由，并给出了返回值。

运行 Droplet

drop.run()

在 main.swift 的最后，启动 Droplet 实例。

编译运行

回到终端，对项目进行编译，并运行

vapor build
vapor run serve

此时，通过浏览器访问：http://localhost:8080/hello，就可以看见 Vapor 和你 say Hi 了。

参考

Vapor Docs