From 13c6eb2db00a51ef66f533eb60ff47d133c4084e Mon Sep 17 00:00:00 2001
From: jaystone776 <jilei776@gmail.com>
Date: Mon, 29 Jan 2024 02:23:10 +0800
Subject: [PATCH] =?UTF-8?q?=F0=9F=8C=90=20Add=20Chinese=20translation=20fo?=
 =?UTF-8?q?r=20`docs/zh/docs/advanced/events.md`=20(#3815)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/zh/docs/advanced/events.md | 51 +++++++++++++++++++++++++++++++++
 1 file changed, 51 insertions(+)
 create mode 100644 docs/zh/docs/advanced/events.md

diff --git a/docs/zh/docs/advanced/events.md b/docs/zh/docs/advanced/events.md
new file mode 100644
index 000000000..6017b8ef0
--- /dev/null
+++ b/docs/zh/docs/advanced/events.md
@@ -0,0 +1,51 @@
+# 事件：启动 - 关闭
+
+**FastAPI** 支持定义在应用启动前，或应用关闭后执行的事件处理器（函数）。
+
+事件函数既可以声明为异步函数（`async def`），也可以声明为普通函数（`def`）。
+
+!!! warning "警告"
+
+    **FastAPI** 只执行主应用中的事件处理器，不执行[子应用 - 挂载](./sub-applications.md){.internal-link target=_blank}中的事件处理器。
+
+## `startup` 事件
+
+使用 `startup` 事件声明 `app` 启动前运行的函数：
+
+```Python hl_lines="8"
+{!../../../docs_src/events/tutorial001.py!}
+```
+
+本例中，`startup` 事件处理器函数为项目数据库（只是**字典**）提供了一些初始值。
+
+**FastAPI** 支持多个事件处理器函数。
+
+只有所有 `startup` 事件处理器运行完毕，**FastAPI** 应用才开始接收请求。
+
+## `shutdown` 事件
+
+使用 `shutdown` 事件声明 `app` 关闭时运行的函数：
+
+```Python hl_lines="6"
+{!../../../docs_src/events/tutorial002.py!}
+```
+
+此处，`shutdown` 事件处理器函数在 `log.txt` 中写入一行文本 `Application shutdown`。
+
+!!! info "说明"
+
+    `open()` 函数中，`mode="a"` 指的是**追加**。因此这行文本会添加在文件已有内容之后，不会覆盖之前的内容。
+
+!!! tip "提示"
+
+    注意，本例使用 Python `open()` 标准函数与文件交互。
+
+    这个函数执行 I/O（输入/输出）操作，需要等待内容写进磁盘。
+
+    但 `open()` 函数不支持使用 `async` 与 `await`。
+
+    因此，声明事件处理函数要使用 `def`，不能使用 `asnyc def`。
+
+!!! info "说明"
+
+    有关事件处理器的详情，请参阅 <a href="https://www.starlette.io/events/" class="external-link" target="_blank">Starlette 官档 - 事件</a>。