scotty 系列教程是建立在读者具有一定 haskell 基础的前提上，
若没有请移步去阅读一本关于 haskell 编程的书，如：《Real World Haskell》。

scotty 系列教程将一步一步引导读者开发一个 coin 项目。涉及的内容如下：

• 如何使用 stack 快速构建 haskell 项目
• 第一个应用 echo
• 访问 mysql 数据库
• 使用 haxl 框架
• rest ful json api
• 使用 graphql
• 结语

预备工作

haskell 所提供 cabal 构建工具相对来将比较复杂，所以我选择使用 stack 构建工具。

安装 stack

详细的安装请自行查看文档。
我自己使用的是 gentoo，安装如下：

emerge --ask dev-haskell/stack 

mac os 安装如下：

brew install haskell-stack 

第一个项目 hello world

$ stack new helloworld
Downloading template "new-template" to create project "helloworld" in helloworld/ ...
Looking for .cabal or package.yaml files to use to init the project.
Using cabal packages:
- helloworld/helloworld.cabal

Selecting the best among 10 snapshots...

Downloaded lts-8.5 build plan.
* Matches lts-8.5

Selected resolver: lts-8.5
Initialising configuration using resolver: lts-8.5
Total number of user packages considered: 1
Writing configuration to file: helloworld/stack.yaml
All done.

我们从日志可以看到 stack 使用的最新的模版创建 helloworld 这个项目，并且下载了最新的编译解决方案 lts-8.5。

编译

我们进入 helloworld 目录进行编译：

$ cd helloworld 
$ stack build 
No compiler found, expected minor version match with ghc-8.0.2 (x86_64) (based on resolver setting in /Users/lmj/repo/dispatch/helloworld/stack.yaml).
To install the correct GHC into /Users/lmj/.stack/programs/x86_64-osx/, try running "stack setup" or use the "--install-ghc" flag. To use your system GHC installation, run "stack config set system-ghc --global true", or use the "--system-ghc" flag.

报错了，从日志可以知道 stack 没有找到 ghc 编译器。
我们可以简单执行 stack setup 来安装 ghc 编译器。
我自己是使用系统的 ghc brew install ghc，所以后面的教程使用的都是系统的 ghc。

加了 --system-ghc 参数重新编译

$ stack build --system-ghc
Warning: File listed in helloworld.cabal file does not exist: README.md
helloworld-0.1.0.0: configure (lib + exe)
Configuring helloworld-0.1.0.0...
helloworld-0.1.0.0: build (lib + exe)
Preprocessing library helloworld-0.1.0.0...
[1 of 1] Compiling Lib              ( src/Lib.hs, .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/Lib.o )
Preprocessing executable 'helloworld-exe' for helloworld-0.1.0.0...
[1 of 1] Compiling Main             ( app/Main.hs, .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/helloworld-exe/helloworld-exe-tmp/Main.o )
Linking .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/helloworld-exe/helloworld-exe ...
Warning: File listed in helloworld.cabal file does not exist: README.md
helloworld-0.1.0.0: copy/register
Installing library in
/Users/lmj/repo/dispatch/helloworld/.stack-work/install/x86_64-osx/lts-8.5/8.0.2/lib/x86_64-osx-ghc-8.0.2/helloworld-0.1.0.0-44GC3BWnM1QFjPMM1ngxcQ
Installing executable(s) in
/Users/lmj/repo/dispatch/helloworld/.stack-work/install/x86_64-osx/lts-8.5/8.0.2/bin
Registering helloworld-0.1.0.0...

编译成功了，我们执行一下它：

$ stack exec --system-ghc helloworld-exe 
someFunc

哈哈，成功了。

Hello World!

下面我们把 someFunc 改成我们要的 Hello World!。
我们看一下目录树：

$ tree 
.
├── LICENSE
├── Setup.hs
├── app
│   └── Main.hs
├── helloworld.cabal
├── src
│   └── Lib.hs
├── stack.yaml
└── test
    └── Spec.hs

3 directories, 7 files

目录树中 app/Main.hs 为 helloworld 的入口。
src/Lib.hs 为 helloworld 的主代码，专门给 app/Main.hs 调用的。

我们打开 src/Lib.hs:

module Lib
    ( someFunc
    ) where

someFunc :: IO ()
someFunc = putStrLn "someFunc"

putStrLn "someFunc" 就是输出的信息，我们把 someFunc 改为 Hello World! 今天的教程就完工。

改完如下：

module Lib
    ( someFunc
    ) where

someFunc :: IO ()
someFunc = putStrLn "Hello World!"

编译执行一下：

$ stack build --system-ghc
Warning: File listed in helloworld.cabal file does not exist: README.md
helloworld-0.1.0.0: unregistering (local file changes: src/Lib.hs)
helloworld-0.1.0.0: build (lib + exe)
Preprocessing library helloworld-0.1.0.0...
[1 of 1] Compiling Lib              ( src/Lib.hs, .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/Lib.o )
Preprocessing executable 'helloworld-exe' for helloworld-0.1.0.0...
[1 of 1] Compiling Main             ( app/Main.hs, .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/helloworld-exe/helloworld-exe-tmp/Main.o ) [Lib changed]
Linking .stack-work/dist/x86_64-osx/Cabal-1.24.2.0/build/helloworld-exe/helloworld-exe ...
Warning: File listed in helloworld.cabal file does not exist: README.md
helloworld-0.1.0.0: copy/register
Installing library in
/Users/lmj/repo/dispatch/helloworld/.stack-work/install/x86_64-osx/lts-8.5/8.0.2/lib/x86_64-osx-ghc-8.0.2/helloworld-0.1.0.0-44GC3BWnM1QFjPMM1ngxcQ
Installing executable(s) in
/Users/lmj/repo/dispatch/helloworld/.stack-work/install/x86_64-osx/lts-8.5/8.0.2/bin
Registering helloworld-0.1.0.0...

$ stack exec --system-ghc helloworld-exe
Hello World!

课后作业

src/Lib.hs 和 app/Main.hs 里面的 someFunc 函数名也应该做相应的改动，这些就留给读者自己完成了。