A Swift API for Apache. This wraps the CApache system package and provides Swift convenience on top of that. This package is part of the mod_swift effort.

Apache provides a very low level API towards Apache, for something more convenient, checkout ApacheExpress.

Using the Apache package

NOTE: This requires a mod_swift installation. W/o it, it will fail to built CApache!

If you setup a new module from scratch, use:

swift apache init

Otherwise setup your Package.swift to include Apache:

import PackageDescription

let package = Package(
  name: "MyTool",
	
  dependencies: [
    .Package(url: "git@github.com:modswift/Apache.git", from: "0.5.0"),
  ]
)

Building an Apache module

Simply invoke

swift apache build

This wraps Swift Package Manager to build your package and then produce a proper module which can be loaded into Apache.

To run a test Apache instance, use:

swift apache serve

Access the Apache using: http://localhost:8042/.

Example

Check mods_baredemo for a low level Apache module which uses the APIs of this package.

A simple Apache handler:

func HelloHandler(p: UnsafeMutablePointer<request_rec>?) -> Int32 {
  let req = ApacheRequest(raw: p!)
  guard req.handler == "helloswift" else { return DECLINED }
  req.puts("Hello World!")
  return OK
}

An Apache handler using the database:

func DatabaseHandler(p: UnsafeMutablePointer<request_rec>?) -> Int32 {
  let req = ApacheRequest(raw: p!)
  guard req.handler == "dbswift" else { return DECLINED }
  
  guard let dbd = req.dbdAcquire() else {
    req.puts("Could not access database!")
    return 500
  }
  
  dbd.select("SELECT name, count FROM pets") { (name : String, count : Int?) in
    req.puts("\(name): \(count)\n")
  }

  return OK
}

Apache Configuration for both:

<Location /helloworld>
  SetHandler helloswift
</Location>

<Location /database>
  SetHandler dbswift
  DBDriver   sqlite3
  DBDParams  "absolute-path-to-testdb.sqlite3"
</Location>

Who

mod_swift is brought to you by ZeeZide. We like feedback, GitHub stars, cool contract work, presumably any form of praise you can think of.

There is a #mod_swift channel on the Noze.io Slack.