swift搭建服务器

Swift 搭建服务器

在 Swift 中搭建服务器，通常可以使用 Vapor 框架，Vapor 是一个基于 Swift 的 web 框架，灵感来源于 Ruby on Rails 和 Laravel，它提供了简洁的 API 和强大的功能，用于构建 web 应用程序和 API，以下是使用 Vapor 搭建服务器的详细步骤：

环境准备

安装 Xcode

确保你的 Mac 上安装了 Xcode，因为我们需要使用 Xcode Command Line Tools 来管理 Swift 包和工具链。

安装 Homebrew

Homebrew 是 macOS 上的一个包管理器，可以用来安装各种开发工具和库，打开终端，执行以下命令安装 Homebrew：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Swift 和 Vapor

使用 Homebrew 安装 Swift 和 Vapor 工具箱：

brew install swift
brew tap vapor/homebrew-vapor
brew install vapor

创建 Vapor 项目

初始化项目

在终端中导航到你希望创建项目的目录,然后运行以下命令来初始化一个新的 Vapor 项目：

vapor new MyVaporApp

这将创建一个名为 MyVaporApp 的项目文件夹，其中包含了 Vapor 项目的基本结构。

进入项目目录

cd MyVaporApp

项目结构解析

Vapor 项目通常包含以下主要文件和文件夹：

配置和运行服务器

配置端口和环境

默认情况下,Vapor 应用运行在 http://localhost:8080，你可以在 configure.swift 文件中修改端口号和其他配置，要更改端口为 8000，可以这样修改：

// configure.swift
import Vapor
/// Called before your application initializes.
public func configure(_ config: inout Config, _ env: inout Environment, _ services: inout Services) throws {
    // 设置服务器端口为 8000
    services.register { container -> Config.Services in
        var services = container.services
        services.server.configuration.port = 8000
        return services
    }
    // 其他配置...
}

添加简单的路由

打开 Sources/App/Routes.swift，添加一个简单的路由以测试服务器是否正常运行：

// Sources/App/Routes.swift
import Vapor
func routes(_ app: Application) throws {
    app.get { req in
        return "Hello, Vapor!"
    }
}

运行服务器

在项目根目录下运行以下命令启动服务器：

vapor run serve

你应该会看到类似如下的输出,表示服务器已成功启动：

[ INFO ] Starting server on http://localhost:8000

在浏览器中访问 http://localhost:8080（或你设置的端口），应该会显示 "Hello, Vapor!"。

扩展功能

连接数据库

Vapor 支持多种数据库，如 SQLite、PostgreSQL、MySQL 等，以下是使用 PostgreSQL 的示例：

a. 安装 PostgreSQL

使用 Homebrew 安装 PostgreSQL：

brew install postgresql

b. 启动 PostgreSQL 服务

brew services start postgresql

c. 创建数据库和用户

在终端中使用 psql 命令行工具创建数据库和用户：

psql postgres

然后在 psql 提示符下执行：

CREATE DATABASE myvapordb;
CREATE USER myvaporuser WITH PASSWORD 'password';
GRANT ALL PRIVILEGES ON DATABASE myvapordb TO myvaporuser;
q

d. 配置 Vapor 连接数据库

在 configure.swift 中添加数据库配置：

// configure.swift
import Vapor
import Fluent
public func configure(_ config: inout Config, _ env: inout Environment, _ services: inout Services) throws {
    // 配置数据库连接
    let databaseConfig = PostgreSQLDatabaseConfig(hostname: "localhost", port: 5432, username: "myvaporuser", password: "password", database: "mevapordb")
    let database = PostgreSQLDatabase(config: databaseConfig)
    services.register { container -> PostgreSQLDatabase in
        return database
    }
    services.register { container -> DatabaseConfiguration in
        var configuration = DatabaseConfiguration()
        configuration.defaultDatabase = .postgresql
        return configuration
    }
    // 注册 Fluent 迁移生成器
    services.register { container in
        container.with { db in
            db.migrations.add(CreateUserMigration())
        }
    }
    // 其他配置...
}

e. 创建模型和迁移

在 Sources/App/Models 目录下创建 User.swift：

// Sources/App/Models/User.swift
import Vapor
import Fluent
final class User: Model, Content {
    static var schema: String = "users"
    @ID(key: .id)
    var id: UUID?
    @Field(key: "name")
    var name: String
    init() {}
    init(id: UUID? = nil, name: String) {
        self.id = id
        self.name = name
    }
}

创建迁移文件 CreateUserMigration.swift：

// Sources/App/Migrations/CreateUserMigration.swift
import Fluent
import Vapor
struct CreateUserMigration: Fluent.Migration {
    func prepare(on database: Database) -> EventLoopFuture<Void> {
        database.schema("users") // 与模型中的 schema 名称一致
            .id() // 自动创建 ID 列
            .field("name", .string, .required) // 创建 name 列，类型为字符串，必填
            .create() // 创建表
            .flatMap { _ in
                return database.table("users").createIfNotExists() // 确保表存在
            }
    }
    func revert(on database: Database) -> EventLoopFuture<Void> {
        return database.schema("users").delete() // 删除表
    }
}

f. 运行迁移

在终端中运行以下命令以应用迁移并创建数据库表：

vapor run migrate

添加 CRUD 路由

在 Sources/App/Routes.swift 中添加用户相关的 CRUD（创建、读取、更新、删除）路由：

// Sources/App/Routes.swift
import Vapor
import Fluent
func routes(_ app: Application) throws {
    // 获取所有用户
    app.get("users") { req async throws -> [User] in
        try await User.query(on: req.db).all()
    }
    // 创建新用户
    app.post("users") { req async throws -> User in
        let user = try req.content.decode(User.self)
        try await user.save(on: req.db)
        return user
    }
    // 根据 ID 获取单个用户
    app.get("users", ":userID") { req async throws -> User in
        guard let userID = req.parameters.get("userID"), let uuid = UUID(uuidString: userID) else { throw Abort(.badRequest) }
        let user = try await User.find(uuid, on: req.db) ?? abort(with: .notFound)
        return user
    }
    // 更新用户信息
    app.put("users", ":userID") { req async throws -> User in
        guard let userID = req.parameters.get("userID"), let uuid = UUID(uuidString: userID) else { throw Abort(.badRequest) }
        var user = try await User.find(uuid, on: req.db) ?? abort(with: .notFound)
        if let newName = req.content.getString("name") {
            user.name = newName
        }
        try await user.update(on: req.db)
        return user
    }
    // 删除用户
    app.delete("users", ":userID") { req async throws -> HTTPStatus in
        guard let userID = req.parameters.get("userID"), let uuid = UUID(uuidString: userID) else { throw Abort(.badRequest) }
        let user = try await User.find(uuid, on: req.db) ?? abort(with: .notFound)
        try await user.delete(on: req.db)
        return .ok
    }
}

测试 API

你可以使用工具如 Postman 或 curl 来测试这些 API，使用 curl 创建一个新用户：

curl -X POST http://localhost:8080/users -H "Content-Type: application/json" -d '{"name":"John Doe"}'

部署服务器（可选）

当你的应用开发完成后,你可能希望将其部署到生产环境，以下是一些常见的部署选项：

Heroku Deployment Guide for Vapor (https://github.com/Code-Hex/Vapor-Heroku-Sample)