purescript-httpurple/docs/Basics.md

HTTPure Basics

This guide is a brief overview of the basics of creating a HTTPure server.

Creating a Server

To create a server, use HTTPure.serve (no SSL) or HTTPure.serveSecure (SSL). Both of these functions take a port number, a router function, and an Eff that will run once the server has booted. The signature of the router function is:

forall e. HTTPure.Request -> HTTPure.ResponseM e

For more details on routing, see the Routing guide. For more details on responses, see the Responses guide. The router can be composed with middleware; for more details, see the Middleware guide.

Non-SSL

You can create an HTTPure server without SSL using HTTPure.serve:

main :: forall e. HTTPure.ServerM (console :: Console.CONSOLE | e)
main = HTTPure.serve 8080 router $ Console.log "Server up"

Most of the examples, besides the SSL Example, use this method to create the server.

You can also create a server using a custom [HTTP.ListenOptions](http://bit.ly/2G42rLd) value:

main :: forall e. HTTPure.ServerM (console :: Console.CONSOLE | e)
main = HTTPure.serve' customOptions router $ Console.log "Server up"

SSL

You can create an SSL-enabled HTTPure server using HTTPure.serveSecure, which has the same signature as HTTPure.serve except that it additionally takes a path to a cert file and a path to a key file after the port number:

main :: forall e. HTTPure.SecureServerM (console :: Console.CONSOLE | e)
main =
  HTTPure.serveSecure 8080 "./Certificate.cer" "./Key.key" router $
    Console.log "Server up"

You can look at the SSL Example, which uses this method to create the server.

You can also create a server using a [HTTP.ListenOptions](http://bit.ly/2G42rLd) and a Options [HTTPS.SSLOptions](http://bit.ly/2G3Aljr):

main :: forall e. HTTPure.SecureServerM (console :: Console.CONSOLE | e)
main =
  HTTPure.serveSecure' customSSLOptions customOptions router $
    Console.log "Server up"