Django源码阅读 (一) 项目的生成与启动

Posted 2023-02-15

参考技术A

诚实的说，直到目前为止，我并不欣赏django。在我的认知它并不是多么精巧的设计。只是由功能堆积起来的"成熟方案"。但每一样东西的崛起都是时代的选择。无论你多么不喜欢，但它被需要。希望有一天，python能有更多更丰富的成熟方案，且不再被诟病性能和可维护性。（屁话结束）
取其精华去其糟粕，django的优点是方便，我们这次源码阅读的目的是探究其方便的本质。计划上本次源码阅读不会精细到每一处，而是大体以功能为单位进行解读。

django-admin startproject HelloWorld 即可生成django项目，命令行是exe格式的。

manage.py 把参数交给命令行解析。

execute_from_command_line() 通过命令行参数，创建一个管理类。然后运行他的 execute() 。

如果设置了reload，将会在启动前先 check_errors 。

check_errors() 是个闭包，所以上文结尾是 (django.setup)() 。

直接看最后一句 settings.INSTALLED_APPS 。从settings中抓取app
注意，这个settings还不是我们项目中的settings.py。而是一个对象，位于 django\\conf\\__init__.py

这是个Settings类的懒加载封装类，直到 __getattr__ 取值时才开始初始化。然后从Settings类的实例中取值。且会讲该值赋值到自己的 __dict__ 上（下次会直接在自己身上找到，因为 __getattr__ 优先级较低）

为了方便debug，我们直接写个run.py。不用命令行的方式。
项目下建个run.py，模拟runserver命令

debug抓一下setting_module

回到 setup() 中的最后一句 apps.populate(settings.INSTALLED_APPS)
开始看 apps.populate()

首先看这段

这些App最后都会封装成为AppConfig。且会装载到 self.app_configs 字典中

随后，分别调用每个appConfig的 import_models() 和 ready() 方法。
App的装载部分大体如此

为了方便debug我们改写下最后一句

res的类型是 Command <django.contrib.staticfiles.management.commands.runserver.Command object at 0x00000101ED5163A0>
重点是第二句，让我们跳到 run_from_argv() 方法，这里对参数进行了若干处理。

用pycharm点这里的handle会进入基类的方法，无法得到正确的走向。实际上子类Commond重写了这个方法。

这里分为两种情况，如果是reload重载时，会直接执行 inner_run() ，而项目启动需要先执行其他逻辑。

django 项目启动时，实际上会启动两次，如果我们在项目入口(manage.py)中设置个print，会发现它会打印两次。

第一次启动时， DJANGO_AUTORELOAD_ENV 为None，无法进入启动逻辑。会进入 restart_with_reloader() 。

在这里会将 DJANGO_AUTORELOAD_ENV 置为True，随后重启。

第二次时，可以进入启动逻辑了。

这里创建了一个django主线程，将 inner_run() 传入。
随后本线程通过 reloader.run(django_main_thread) ，创建一个轮询守护进程。

我们接下来看django的主线程 inner_run() 。

当我们看到wsgi时，django负责的启动逻辑，就此结束了。接下来的工作交由wsgi服务器了
这相当于我们之前在fastapi中说到的，将fastapi的app交由asgi服务器。(asgi也是django提出来的，两者本质同源)

那么这个wsgi是从哪来的？让我们来稍微回溯下

这个settings是一个对象，在之前的操作中已经从 settings.py 配置文件中获得了自身的属性。所以我们只需要去 settings.py 配置文件中寻找。

我们来寻找这个 get_wsgi_application() 。

它会再次调用 setup() ，重要的是，返回一个 WSGIHandler 类的实例。

这就是wsgiapp本身。

load_middleware() 为构建中间件堆栈，这也是wsgiapp获取setting信息的唯一途径。导入settings.py，生成中间件堆栈。
如果看过我之前那篇fastapi源码的，应该对中间件堆栈不陌生。
app入口→中间件堆栈→路由→路由节点→endpoint
所以，wsgiapp就此构建完毕，服务器传入请求至app入口，即可经过中间件到达路由进行分发。