詳解如何在Apache中運行Python WSGI應用

在生產環境上,一般會使用比較健壯的Web服務器,如Apache來運行我們的應用,本文中我們就會介紹如何使用Apache模塊mod_wsgi來運行Python WSGI應用。感興趣的小夥伴們可以參考一下

在生產環境上,一般會使用比較健壯的Web服務器,如Apache來運行我們的應用。如果我們的Web應用是採用Python開發,而且符合WSGI規範,比如基於Django,Flask等框架,那如何將其部署在Apache中呢?本文中,我們就會介紹如何使用Apache模塊mod_wsgi來運行Python WSGI應用。

安裝mod_wsgi

我們假設你已經有了Apache和Python環境,在Linux或者Mac上,那第一步自然是安裝。在Ubuntu或Debian環境中,你可以使用apt-get命令來安裝:

$ sudo apt-get install libapache2-mod-wsgi
$ sudo apt-get install libapache2-mod-wsgi-py3  # For Python 3

不過我們建議採用編譯安裝,這樣在任何系統中都可以安裝成功,具體步驟如下:

1、下載源碼包

mod_wsgi的源碼託管在Github上,你可以從https://github.com/GrahamDumpleton/mod_wsgi/releases下載它各個版本的源碼包。

2、解壓後,配置編譯選項

一般採用默認配置即可,即執行:

$ ./configure

如果要指定Apache和Python環境,那你需要加上”–with-apxs”和”–with-python”選項:

$ ./configure --with-apxs=/usr/local/apache/bin/apxs --with-python=/usr/local/bin/python

3、編譯並安裝

$ sudo make && make install

4、在Apache配置文件中載入mod_wsgi

讓我們打開Apache的配置文件httpd.conf,默認是在:

$ sudo vi /etc/httpd/conf/httpd.conf  # For Linux
$ sudo vi /etc/apache2/httpd.conf   # For Mac

在所有”Load Module”配置項的最後,加上載入mod_wsgi的配置,注意Linux和Mac的模塊加載路徑不同:

LoadModule wsgi_module modules/mod_wsgi.so  # For Linux
# LoadModule wsgi_module libexec/apache2/mod_wsgi.so  # For Mac

5、重啓Apache來啓用配置

$ sudo service httpd restart    # For Linux
$ sudo service apachectl restart  # For Mac

測試mod_wsgi

最簡單的測試方法自然是Hello World,讓我們在Apache的DocumentRoot根目錄下創建一個文件”test.wsgi”。在文件中,我們寫入這樣的內容:

def application(environ, start_response):
  status = '200 OK'
  output = 'Hello World!'
 
  response_headers = [('Content-type', 'text/plain'),
            ('Content-Length', str(len(output)))]
  start_response(status, response_headers)
 
  return [output]

這裏的函數application即爲WSGI應用對象,它返回的值就是該應用收到請求後的響應。然後,再打開Apache的配置文件httpd.conf,在其最後加上URL路徑映射:

WSGIScriptAlias /test /var/www/test.wsgi

這裏我們假設Apache的文檔根目錄是”/var/www”。

現在你可以打開瀏覽器,訪問一下”http://localhost/test”,如果看到”Hello World!”了,就說明mod_wsgi已經安裝成功。

我們可以試試運行Flask應用,當然首先是你本地Python環境已經安裝了Flask,我們將”test.wsgi”改爲:

from flask import Flask
application = Flask(__name__)
 
@application.route('/')
def index():
  return '<h1>Hello World!</h1>'

注意,這裏必須要將Flask應用對象命名爲”application”,這樣才能被mod_wsgi識別。再用瀏覽器訪問下,是不是能看到大標題”Hello World!”?

使用Python虛擬環境

一般我們會將應用安裝在虛擬環境中,這樣應用的更新只需改變虛擬環境即可,不會影響到其他應用環境。要使用虛擬環境來運行當前WSGI應用的話,你必須在”.wsgi”文件中先執行虛擬環境的啓用腳本,基於上面的代碼,我們來做如下改動:

activate_this = '/home/bjhee/virtualenv/bin/activate_this.py'
execfile(activate_this, dict(__file__=activate_this))
 
from flask import Flask
application = Flask(__name__)
 
@application.route('/')
def index():
  return '<h1>Hello World!</h1>'

上例中,我們的虛擬環境在目錄”/home/bjhee/virtualenv”下,你可以在其”/bin”子目錄中找到啓用腳本”activate_this.py”。在WSGI應用的一開始執行它即可。

補充內容

當我們的Python環境中有模塊是以.egg壓縮包安裝的話,WSGI應用運行時需要將.egg壓縮包解開。默認的解壓路徑很有可能沒有訪問權限,比如Mac下是”/Library/WebServer/.python-eggs”,因此你需要指定臨時解壓目錄。方法有兩種,一是在Apache的httpd.conf文件中,使用”WSGIPythonEggs”配置項,配置參數就是我們的臨時目錄路徑;二是設置系統環境變量”PYTHON_EGG_CACHE”。我們建議採用第二種,並將其寫在”.wsgi”文件中,這樣就不會影響其他的應用:

activate_this = '/home/bjhee/virtualenv/bin/activate_this.py'
execfile(activate_this, dict(__file__=activate_this))
 
import os
os.environ['PYTHON_EGG_CACHE'] = '/home/bjhee/.python-eggs'
 
from flask import Flask
application = Flask(__name__)
 
@application.route('/')
def index():
  return '<h1>Hello World!</h1>'

運行前,請確保臨時目錄(上例中的”/home/bjhee/.python-eggs”)有訪問及寫權限。

更多內容請參閱mod_wsgi的官方文檔

以上就是本文的全部內容,希望對大家的學習有所幫助,也希望大家多多支持神馬文庫。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章