django python manage.py runserver 流程

python manage.py runserver 流程分析

版本

python27
django 1.0

搭建可運行的環境

創建python27 虛擬環境
github 下載 django-1.0.tar.gz（1.0 版本的django）
解壓
可以看到，有個 demo 在 examples 目錄
把 django 目錄拷貝到 examples 下面，這樣 example 可以正確導入 django1.0
啟動項目

python manage.py runserver

項目啟動成功，可以修改代碼來跟蹤執行流程

流程

以下代碼存在刪減，主要展示代碼流程

從 manage.py 開始，執行了 execute_manager 方法，傳入 settings 模塊

execute_manager(settings)

django.core.management.execute_manager 方法

def execute_manager(settings_mod, argv=None):
    # setup_environ 函數，只是設置了環境變量，執行配置模塊
    # os.environ['DJANGO_SETTINGS_MODULE'] = examples.settting
    setup_environ(settings_mod)

    # admin manage 工具類
    utility = ManagementUtility(argv)
    utility.execute()

ManagementUtility 類

class ManagementUtility(object):
    def __init__(self, argv=None):
        # 初始化，例如
        self.argv = ['.../examples/manage.py', 'runserver']
        self.prog_name = 'manage.py'
    def execute(self):
        # 刪除了部分代碼，最終執行代碼大致如下
    
        # 這是一個命令行工具類，表名能接受什么樣的參數，這里主要檢查兩個參數
        # --settings 指定配置文件
        # --pythonpath 執行 python 環境變量
        parser = LaxOptionParser(usage="%prog subcommand [options] [args]",
                                 version=get_version(),
                                 option_list=BaseCommand.option_list)
    
        # 使用命令行工具類解析命令行參數，也就是獲取 --settings 和 --pythonpath 的參數值
        options, args = parser.parse_args(self.argv)
        # 如果 --settings 參數存在，會覆蓋之前設置的 os.environ['DJANGO_SETTINGS_MODULE']
        # 如果 --pythonpath 參數存在，會把指定路徑添加到 sys.path 的第一位，優先從此處加載模塊
        handle_default_options(options)
    
        # fetch_command
        # fetch_command 分析在下邊
        # fetch_command 返回 django.core.management.commands.runserver.Command
        # run_from_argv
        # run_from_argv 分析在下邊
        self.fetch_command(subcommand).run_from_argv(self.argv)
    
    def fetch_command(self, subcommand):
        # get_commands
        # get_commands 返回 django.core.management.commands 目錄下的所有模塊，每個模塊處理對應的參數
        # 每個模塊的值都是 django.core，app_name = 'django.core'
        app_name = get_commands()[subcommand]
    
        # load_command_class 方法
        # 返回了 django.core.management.commands.runserver.Command
        klass = load_command_class(app_name, subcommand)
    
        return klass

run_from_argv 方法

# django.core.management.commands.runserver.Command 
# 繼承 django.core.management.base import BaseCommand
# run_from_argv 也是繼承的
def run_from_argv(self, argv):
    # 調用 execute
    self.execute(*args, **options.__dict__)

def execute(self, *args, **options):
    # 調用 handle
    # 注意 handle 被重寫了
    # 調用的是 django.core.management.commands.runserver.Command.handle
    output = self.handle(*args, **options)

handle

def handle(self, addrport='', *args, **options):
    def inner_run():
        # WSGI 處理程序
        # WSGIHandler 可調用，是 WSGI 處理程序
        # AdminMediaHandler 是對 WSGIHandler 的封裝
        # AdminMediaHandler 特殊處理媒體文件請求
        # AdminMediaHandler 非媒體文件的 HTTP 請求，直接返回 WSGIHandler
        handler = AdminMediaHandler(WSGIHandler(), path)
        
        # 
        run(addr, int(port), handler)
        # run 在 django.core.servers.basehttp.run
        # run 定義如下
        # run 啟動了 HTTP 服務，這個服務器只能用於開發調試
        def run(addr, port, wsgi_handler):
            # 綁定地址端口
            server_address = (addr, port)
            # 服務實例
            httpd = WSGIServer(server_address, WSGIRequestHandler)
            # 傳入 WSGI 處理程序
            httpd.set_app(wsgi_handler)
            # 監聽請求
            httpd.serve_forever()
    
    inner_run()