0.前言

1.安裝

在你安裝pyramid之前

Pyramid的安裝需要使用pip和 setuptools工具，python2>2.7.9以及python3>3.4的版本已經內建了pip和setuptools工具包，如果你對專案的python版本沒有特別要求，強烈建議使用最新的python版本，會為你省去不少麻煩。如果你使用的是舊版的python，則需要先使用二進位制檔案或其他方式安裝setuptools，pip。

為你的作業系統安裝Python2.7，Python3.4或更高的版本，並確保相關的其他包都被安裝（Requirements for Installing Packages

Pyramid框架可以執行在所有主流的UNIX風格的作業系統上，比如Linux,Mac OS X,FreeBSD等，也可以執行在windows平臺以及PyPy(1.9+)之上.

在Unix類系統上安裝pyramid

當你的作業系統已經包含了python並且裝好了pip時，安裝pyramid變得非常簡單

1. 建立python虛擬環境（不建立亦可，為了防止不同版本python間問題）：
   pip install virtualenv
virtualenv <DIR>
source <DIR>/bin/activate

2. 使用
   pip install “pyramid==1.9.1”
   來安裝pyramid

2.建立你的第一個pyramid專案

在這一節中，我們會演示建立一個最輕量級別的Pyramid應用。在我們完成建立應用之後，我們會從細節上解釋它是如何工作的。這部分文件建立在你已經安裝好Pyramid的基礎之上。

Hello World

以下是一個最簡單的Pyramid應用：

我們將這段程式碼寫入一個名為helloworld.py的Python指令碼檔案並且使用一個已經安裝了pyramid的python編譯器執行這個檔案之後，一個HTTP服務就已經在TCP協議的8080埠上啟動了。

在UNIX上： python helloworld.py

這個指令不會有任何的返回並且控制檯不會有任何的輸出。當我們在一個瀏覽器上訪問hostname:8080/hello/world地址,伺服器會簡單的返回一個“Hello world!”.如果你的應用是在你的本地環境執行，在你的瀏覽器內的位址列輸入http://localhost:8080/hello/world即可顯示這個結果。

每次你通過瀏覽器訪問一個該應用的URL地址時，一條記錄了主機名，日期，請求方法和路徑，以及一些額外資訊的日誌就會被輸出出到控制檯。這些日誌輸出是通過搭載了我們的應用的wsgiref伺服器輸出的。它的輸出形式結合了Apache的日誌輸出和控制檯的日誌輸出方式。

通過快捷鍵Ctrl+C可以停止這個應用。
到此，我們已經對這個應用有了初步的瞭解，下面，我們一步一步來詳細解釋這段程式碼。

匯入依賴

上面的helloworld.py指令碼使用了下面幾條匯入依賴的宣告：

這個指令碼從pyramid.config模組匯入了Configurator類。一個Configurator類的例項在後面的程式碼中會被用來配置你的pyramid應用。
像很多其他的Python web框架一樣，Pyramid使用了WSGI 閘道器協議來將web伺服器和應用連線在一起。在這個例子中，wsgiref 伺服器模組被用來很方便的啟用WSGI服務，整合各模組也是被Python標準庫所支援的。

這個例子中還匯入了pyramid.response.Response 類。一個這個類的例項將被用來建立一個web響應。

檢視呼叫宣告

上面的例子中，在匯入依賴的部分之下，定義了一個叫hello_world的函式。

這個函式接收一個請求引數（request）並且他返回一個pyramid.response.Response類的例項。這個請求引數是由URL的引數匹配得到的字串。在這個例子中，這個值被作為響應的body部分返回了。

這個函式就是檢視的呼叫（view callable）。一個view callable函式接收一個request引數. 它被期望能夠返回一個response物件。view callable不一定是一個函式，也可以是一個類或者一個例項。但是在這個例子裡，一個函式形式的view callable是最適合我們的。

view callable也經常被稱作一個request請求物件，它可以解釋為通過一個執行的wsgi伺服器向pyramid傳送的HTTP請求的表述資訊（如request請求方式cookie等）。即包含了request請求資訊的一個物件。

view callable需要返回一個response物件因為response物件包含了所有能夠發起一個http response的所有必要資訊。這個物件會被WSGI伺服器轉換成文字的形式來呼叫Pyramid並最終用於真正去響應我們的瀏覽器。為了返回一個reponse物件，每個view callable建立了一個response類的例項。

應用配置

在上面的例子中，下面的程式碼表示對這個簡單的應用進行配置。這個應用在一個if程式碼塊中，通過事先匯入的類以及函式宣告來進行配置。

讓我們一步步的解析它。

配置器結構

上面程式碼裡的這個if程式碼塊（__name__ == '__main__'） 是一種python的約定俗成的寫法：只有當包含這塊程式碼的指令碼是被系統命令列直接執行的，這個if塊中的程式碼才會被呼叫，否則它將不會執行。舉例來說，如果helloworld.py指令碼包含了全部的if程式碼塊，只有python helloworld.py這條指令是從命令列執行的，這個if程式碼塊的內容才會被執行。
使用這個if程式碼塊是必要的，或者說是一種最佳實踐，這是因為在python中，.Py檔案可能作為模組會被其他的.py檔案所匯入引用宣告。使用__name__== __main__的if程式碼塊可以保證指令碼作為模組被載入進其他指令碼的時候程式碼塊中的內容不會被執行，僅當它被直接被執行時才會生效。

第二行的with Congiurator() as config:使用上下文環境（context manager）建立了一個Configurator 類的例項物件config。

後面的程式碼都是使用這個config例項物件來呼叫Configurator類中的方法來進行Pyramid應用的配置。對Configurator（）建構函式的呼叫將會對應用進行應用註冊（由金字塔提供的配置資訊的登錄檔，併為應用程式提供服務。應用程式登錄檔將資源型別對映到檢視，以及其他特定於應用程式的元件註冊。每個金字塔應用程式都有且僅有一個應用程式登錄檔。）。

新增配置屬性

上面的第一行呼叫了Configurator類中的add_route方法，顧名思義，用於添加了一個匹配“/hello/”URL地址的路由，這個url地址由/hello/和一個字串組成。
第二行將hello_world方法註冊成為一個view callable ,它保證了當hello路由匹配時，hello_world方法會被呼叫。

建立WSGI 應用

完成了檢視的配置部分後，指令碼通過Configurator類的make_wsgi_app()建立了一個WSGI應用。這個方法的呼叫必須是在所有的配置完成之後，並使得所有的配置生效。這個方法會返回一個WSGI應用的物件，這個物件可以被用於任何WSGI伺服器來實現和Python web 應用的通訊。我們不在這裡深入的討論WSGI的內容，如果你感興趣，可以在它的文件中機繼續深入https://wsgi.readthedocs.io/en/latest/

這個應用物件，實際上也是一個包含了Pyramid路由資訊的類的例項。它引用了應用程式的登錄檔，這裡的應用程式登錄檔是由configurator建構函式呼叫生成的。前面說到過登錄檔包含了路由的對映關係，路由器將會查詢登錄檔，以決定應用以何種策略對應每一跳路由（對應到每個url請求）。這裡的策略是前面的config例項呼叫的配置方法完成的。在我們的示例中，add_view和add_route方法在呼叫時都沒有設定策略，使用的預設的策略屬性。

啟動WSGI 應用

最後，我們終於可以通過·WSGI伺服器啟動我們的應用了。我們使用了wsgiref中的make_server方法來配置伺服器，這裡的‘0.0.0.0’表示監聽所有的TCPip地址.預設情況下，http伺服器將會監聽127.0.0.1本地埠,這會導致你通過遠端訪問應用時出現問題。同時我們也規定了8080埠作為第二個引數，最後一個引數便是app物件（同時也是路由物件），它我們希望啟動服務的應用物件。最後，我們呼叫了伺服器的serve_forever方法，它會進入等待賴在外界的http請求的迴圈。
當這2行程式碼被呼叫時，伺服器會監聽8080埠所有請求。伺服器將會一直執行直到我們通過ctrl+C手動將它停止。

結論

以上是一個最簡單的hello_world應用，它被以命令式形式配置的。後文會介紹命令式及宣告式配置的區別。