vapor-docs/3.0/docs/databases/mongodb/getting-started.md

Using MongoDB

The vapor/mongodb package is an extremely performant, reactive and pure swift MonogDB driver. It provides a simple interface to MongoDB for powerful features.

On top of vapor/mysql, we have built vapor/fluent-sqlite which allows SQLite databases to be used with Fluent.

Just MongoDB

This package works really well with and without Fluent. To include this package in your project, simply add it to your Package manifest.

// swift-tools-version:4.0
import PackageDescription

let package = Package(
    name: "Project",
    dependencies: [
        ...
        .package(url: "https://github.com/OpenKitten/MongoKitten.git", .revision("master/5.0")),
    ],
    targets: [
      .target(name: "Project", dependencies: ["MongoKitten", ... ])
    ]
)

If this is your first time adding a dependency, you should read our introduction to Package.swift.

If this is your first time using MongoDB, have a look at the setup guides.

The official documentation assumed either the MongoDB shell or one of their more popular (official) drivers. Please refer to the MongoKitten interpretation guide before reading the official documentation.

Use import MongoKitten to access the APIs.

With Fluent

MySQL works well Fluent, you just need to make sure to add the vapor/fluent-mysql package to your project.

To do this, add the Fluent MySQL package to your Package manifest.

// swift-tools-version:4.0
import PackageDescription

let package = Package(
    name: "Project",
    dependencies: [
        ...
        .package(url: "https://github.com/vapor/fluent-mysql.git", .revision("beta")),
    ],
    targets: [
      .target(name: "Project", dependencies: ["FluentMySQL", ... ])
    ]
)

If this is your first time adding a dependency, you should read our introduction to Package.swift.

Use import FluentMySQL to access MySQL's Fluent compatible APIs. Learn more about the Fluent APIs here

Setting up services

In order to set up MySQL with Fluent you first need to register the Fluent provider:

try services.provider(FluentProvider())

After this, you need to register the MySQL config and database.

services.instance(FluentMySQLConfig())

var databaseConfig = DatabaseConfig()

let username = "<mysql-user-here>"
let password = "<mysql-pass-here>"
let database = "<mysql-database>"

let db = MySQLDatabase(hostname: "localhost", user: username, password: password, database: database)
databaseConfig.add(database: db, as: .mysql)
services.instance(databaseConfig)

Notice the variable mysqlDB. This is an identifier for the MySQL database. You need to create an identifier for each database you attach to Fluent.

The following identifer can be global, or as a static variable in an extension on DatabaseIdentifier.

extension DatabaseIdentifier {
    static var mysql: DatabaseIdentifier<MySQLDatabase> {
        return .init("foo")
    }
}

Last, you can specify migrations for Fluent to execute. This can be used for creating and altering schemas and migrating data within the table.

Fluent Models that conform to the protocol Migration automatically inherit a migration for schema creation. Nothing needs to be programmed for this.

var migrationConfig = MigrationConfig()
migrationConfig.add(model: MyModel.self, database: .mysql)
services.instance(migrationConfig)

More info on working with Fluent can be found here.