From 86ac3a4d7b725ef62592ccb79b4bf12b3460febe Mon Sep 17 00:00:00 2001
From: Hex <hex@codeigniter.org.cn>
Date: Thu, 19 Sep 2024 17:44:18 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8D=87=E7=BA=A7=E5=88=B0=20v4.5.5=20(#167)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 source/changelogs/index.rst                   |  1 +
 source/changelogs/v4.1.2.rst                  |  2 +-
 source/changelogs/v4.5.5.rst                  | 21 ++++
 source/conf.py                                |  2 +-
 source/helpers/html_helper.rst                | 97 ++++++++++---------
 source/helpers/text_helper.rst                |  4 +-
 source/helpers/text_helper/009.php            |  2 +-
 source/helpers/text_helper/010.php            |  2 +-
 source/incoming/routing.rst                   | 28 ++++++
 source/incoming/routing/071.php               | 14 +++
 source/incoming/routing/072.php               |  8 ++
 source/installation/upgrade_455.rst           | 39 ++++++++
 source/installation/upgrade_models.rst        | 16 ++-
 source/installation/upgrade_models/001.php    | 17 +++-
 source/installation/upgrade_models/002.php    | 26 +++++
 .../upgrade_models/ci3sample/001.php          | 16 +--
 source/installation/upgrading.rst             |  1 +
 source/libraries/curlrequest.rst              |  9 +-
 source/libraries/curlrequest/028.php          | 10 +-
 source/libraries/validation.rst               |  4 +
 source/models/model.rst                       | 23 +++--
 source/models/model/057.php                   |  2 +-
 source/outgoing/api_responses/002.php         |  4 +-
 source/outgoing/localization.rst              | 78 +++++++++++----
 source/outgoing/localization/020.php          |  4 +
 source/outgoing/localization/021.php          |  5 +
 26 files changed, 328 insertions(+), 107 deletions(-)
 create mode 100644 source/changelogs/v4.5.5.rst
 create mode 100644 source/incoming/routing/071.php
 create mode 100644 source/incoming/routing/072.php
 create mode 100644 source/installation/upgrade_455.rst
 create mode 100644 source/installation/upgrade_models/002.php
 create mode 100644 source/outgoing/localization/020.php
 create mode 100644 source/outgoing/localization/021.php

diff --git a/source/changelogs/index.rst b/source/changelogs/index.rst
index 5a68623e..d979f492 100644
--- a/source/changelogs/index.rst
+++ b/source/changelogs/index.rst
@@ -12,6 +12,7 @@
 .. toctree::
     :titlesonly:
 
+    v4.5.5
     v4.5.4
     v4.5.3
     v4.5.2
diff --git a/source/changelogs/v4.1.2.rst b/source/changelogs/v4.1.2.rst
index 9515cc3b..804e2968 100644
--- a/source/changelogs/v4.1.2.rst
+++ b/source/changelogs/v4.1.2.rst
@@ -56,7 +56,7 @@
 - 统一并弃用 ``ControllerResponse`` 和 ``FeatureResponse``,改用 ``TestResponse``。
 - 弃用 ``Time::instance()``,改用 ``Time::createFromInstance()`` (现在接受 ``DateTimeInterface``)。
 - 弃用 ``IncomingRequest::removeRelativeDirectory()``,改用 ``URI::removeDotSegments()``。
-- 弃用 ``\API\ResponseTrait::failValidationError``,改用 ``\API\ResponseTrait::failValidationErrors``。
+- 弃用 ``\API\ResponseTrait::failValidationError()``,改用 ``\API\ResponseTrait::failValidationErrors()``。
 
 错误修复
 ----------
diff --git a/source/changelogs/v4.5.5.rst b/source/changelogs/v4.5.5.rst
new file mode 100644
index 00000000..cbc09ea2
--- /dev/null
+++ b/source/changelogs/v4.5.5.rst
@@ -0,0 +1,21 @@
+#############
+版本 4.5.5
+#############
+
+发布日期：2024 年 9 月 7 日
+
+**CodeIgniter4 的 4.5.5 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+**********
+修复的错误
+**********
+
+- **URL 辅助函数:** 修复了 :php:func:`auto_link()` 中正则表达式过时的错误。通过此修复，现在使用与 CodeIgniter 3 相同的正则表达式。
+
+请参阅仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取修复错误的完整列表。
diff --git a/source/conf.py b/source/conf.py
index da89b8e9..af33866b 100755
--- a/source/conf.py
+++ b/source/conf.py
@@ -26,7 +26,7 @@
 version = '4.5'
 
 # The full version, including alpha/beta/rc tags.
-release = '4.5.4'
+release = '4.5.5'
 
 # -- General configuration ---------------------------------------------------
 
diff --git a/source/helpers/html_helper.rst b/source/helpers/html_helper.rst
index 1f1931d5..7655ef3e 100755
--- a/source/helpers/html_helper.rst
+++ b/source/helpers/html_helper.rst
@@ -11,7 +11,7 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 配置
 =============
 
-从 ``v4.3.0`` 开始, ``html_helper`` 函数中的空 HTML 元素(如 ``<img>``)默认为兼容 HTML5,如果你需要兼容 XHTML,必须在 **app/Config/DocTypes.php** 中将 ``$html5`` 属性设置为 ``false``。
+从 ``v4.3.0`` 开始, ``html_helper`` 函数中的空 HTML 标签(如 ``<img>``)默认为兼容 HTML5,如果你需要兼容 XHTML,必须在 **app/Config/DocTypes.php** 中将 ``$html5`` 属性设置为 ``false``。
 
 加载此辅助函数
 ===================
@@ -30,24 +30,24 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
     :param  string|array  $src: 图像源 URI,或属性和值的数组
     :param  bool    $indexPage:  是否将 ``$src`` 视为路由的 URI 字符串
     :param  mixed   $attributes: 其他 HTML 属性
-    :returns:   HTML 图像标签
+    :returns:   一个 HTML img 标签
     :rtype: string
 
-    允许你创建 HTML ``<img />`` 标签。第一个参数包含图像源。示例:
+    允许你创建 HTML ``<img>`` 标签。第一个参数包含图像源。示例:
 
     .. literalinclude:: html_helper/002.php
 
-    有一个可选的第二个参数,它是一个 true/false 值,指定 *src* 是否应该添加由 ``$config['indexPage']`` 指定的页面地址。这可能是如果你使用媒体控制器的情况:
+    有一个可选的第二个参数，一个 true/false 值，用于指定是否应在创建的地址中添加 ``Config\App::$indexPage`` 到 *src*。假设你在使用一个媒体控制器：
 
     .. literalinclude:: html_helper/003.php
 
-    另外,可以将关联数组作为第一个参数传递,以完全控制所有属性和值。如果没有提供 *alt* 属性,CodeIgniter 将生成一个空字符串。
+    此外，可以将一个关联数组作为第一个参数传递，以完全控制所有属性和值。如果没有提供 *alt* 属性，CodeIgniter 将生成一个空字符串的 *alt* 属性。
 
     示例:
 
     .. literalinclude:: html_helper/004.php
 
-.. php:function:: img_data([$src = ''[, $indexPage = false[, $attributes = '']]])
+.. php:function:: img_data($path[, $mime = null])
 
     :param string $path: 图像文件路径
     :param string|null $mime: 要使用的 MIME 类型,如果为 null 将猜测
@@ -73,10 +73,10 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
     :param  string  $media:     媒体类型
     :param  bool    $indexPage: 是否将 ``$src`` 视为路由的 URI 字符串
     :param  string  $hreflang:  Hreflang 类型
-    :returns:   HTML 链接标签
+    :returns:   一个 HTML link 标签
     :rtype: string
 
-    允许你创建 HTML ``<link />`` 标签。这对于样式表链接很有用,也用于其他链接。参数是 *href*,可选的 *rel*、*type*、*title*、*media* 和 *indexPage*。
+    允许你创建 HTML ``<link>`` 标签。这对于样式表链接很有用,也用于其他链接。参数是 *href*,可选的 *rel*、*type*、*title*、*media* 和 *indexPage*。
 
     *indexPage* 是一个布尔值,指定 *href* 是否应该添加由 ``$config['indexPage']`` 指定的页面地址。
 
@@ -96,10 +96,10 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 
     :param  array|string  $src: JavaScript 文件的源名称或 URL,或指定属性的关联数组
     :param  bool          $indexPage: 是否将 ``$src`` 视为路由的 URI 字符串
-    :returns:   HTML script 标签
+    :returns:   一个 HTML script 标签
     :rtype: string
 
-    允许你创建 HTML ``<script></script>`` 标签。参数是 *src*,可选的 *indexPage*。
+    允许你创建 HTML ``<script>`` 标签。参数是 *src* 和可选的 *indexPage*。
 
     *indexPage* 是一个布尔值,指定 *src* 是否应该添加由 ``$config['indexPage']`` 指定的页面地址。
 
@@ -115,7 +115,7 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 
     :param  array   $list: 列表项
     :param  array   $attributes: HTML 属性
-    :returns:   HTML 格式的无序列表
+    :returns:   一个 HTML 无序列表标签
     :rtype: string
 
     允许你从简单或多维数组生成无序 HTML 列表。示例:
@@ -187,7 +187,7 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 
     :param  array   $list: 列表项
     :param  array   $attributes: HTML 属性
-    :returns:   HTML 格式的有序列表
+    :returns:   一个 HTML 有序列表标签
     :rtype: string
 
     与 :php:func:`ul()` 相同,只是它生成 ``<ol>`` 标签用于有序列表,而不是 ``<ul>``。
@@ -195,14 +195,14 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 .. php:function:: video($src[, $unsupportedMessage = ''[, $attributes = ''[, $tracks = [][, $indexPage = false]]]])
 
     :param  mixed   $src:                 源字符串或源数组。参见 :php:func:`source()` 函数
-    :param  string  $unsupportedMessage: 如果浏览器不支持媒体标签应显示的消息
+    :param  string  $unsupportedMessage: 如果浏览器不支持 video 标签应显示的消息
     :param  string  $attributes:          HTML 属性
     :param  array   $tracks:              在数组内使用 track 函数。参见 :php:func:`track()` 函数
     :param  bool    $indexPage:
-    :returns:                             HTML 格式的视频元素
+    :returns:                             一个 HTML video 标签
     :rtype: string
 
-    允许你从简单或源数组生成 HTML 视频元素。示例:
+    允许你从一个源字符串或一个源数组生成一个 HTML video 标签。示例:
 
     .. literalinclude:: html_helper/014.php
 
@@ -233,24 +233,24 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
 .. php:function:: audio($src[, $unsupportedMessage = ''[, $attributes = ''[, $tracks = [][, $indexPage = false]]]])
 
     :param  mixed   $src:                 源字符串或源数组。参见 :php:func:`source()` 函数
-    :param  string  $unsupportedMessage: 如果浏览器不支持媒体标签应显示的消息
+    :param  string  $unsupportedMessage: 如果浏览器不支持 audio 标签应显示的消息
     :param  string  $attributes:
     :param  array   $tracks:              在数组内使用 track 函数。参见 :php:func:`track()` 函数
     :param  bool    $indexPage:
-    :returns:                             HTML 格式的音频元素
+    :returns:                             一个 HTML audio 标签
     :rtype: string
 
     与 :php:func:`video()` 相同,只是它生成 ``<audio>`` 标签而不是 ``<video>``。
 
-.. php:function:: source($src = ''[, $type = false[, $attributes = '']])
+.. php:function:: source($src, $type = 'unknown', $attributes = '', $indexPage = false)
 
     :param  string  $src:        媒体资源路径
     :param  bool    $type:       资源的 MIME 类型,可选编解码器参数
     :param  array   $attributes: HTML 属性
-    :returns:   HTML 源标签
+    :returns:   一个 HTML source 标签
     :rtype: string
 
-    允许你创建 HTML ``<source />`` 标签。第一个参数包含源源。示例:
+    允许你创建 HTML ``<source>`` 标签。第一个参数包含资源的路径。示例:
 
     .. literalinclude:: html_helper/015.php
 
@@ -260,23 +260,23 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
     :param  bool    $type:       MIME 类型
     :param  array   $attributes: HTML 属性
     :param  bool    $indexPage:
-    :returns:   HTML 嵌入标签
+    :returns:   一个 HTML embed 标签
     :rtype: string
 
-    允许你创建 HTML ``<embed />`` 标签。第一个参数包含嵌入源。示例:
+    允许你创建 HTML ``<embed>`` 标签。第一个参数包含 embed 源。示例:
 
     .. literalinclude:: html_helper/016.php
 
-.. php:function:: object($data = ''[, $type = false[, $attributes = '']])
+.. php:function:: object($data[, $type = 'unknown'[, $attributes = ''[, $params = [][, $indexPage = false]]]])
 
     :param  string  $data:       资源 URL
     :param  bool    $type:       资源的内容类型
     :param  array   $attributes: HTML 属性
     :param  array   $params:     在数组中使用 param 函数。参见 :php:func:`param()` 函数
-    :returns:   HTML 对象标签
+    :returns:   一个 HTML object 标签
     :rtype: string
 
-    允许你创建 HTML ``<object />`` 标签。第一个参数包含对象数据。示例:
+    允许你创建 HTML ``<object>`` 标签。第一个参数包含对象数据。示例:
 
     .. literalinclude:: html_helper/017.php
 
@@ -291,64 +291,65 @@ HTML 辅助函数文件包含了帮助处理 HTML 的函数。
           <param name="hello" type="ref" value="world" class="test" />
         </object>
 
-.. php:function:: param($name = ''[, $type = false[, $attributes = '']])
+.. php:function:: param($name, $value[, $type = 'ref'[, $attributes = '']])
 
     :param  string  $name:       参数名称
     :param  string  $value:      参数值
     :param  array   $attributes: HTML 属性
-    :returns:   HTML param 标签
+    :returns:   一个 HTML param 标签
     :rtype: string
 
-    允许你创建 HTML ``<param />`` 标签。第一个参数包含 param 源。示例:
+    允许你创建 HTML ``<param>`` 标签。第一个参数包含 param 源。示例:
 
     .. literalinclude:: html_helper/018.php
 
-.. php:function:: track($name = ''[, $type = false[, $attributes = '']])
+.. php:function:: track($src, $kind, $srcLanguage, $label)
 
-    :param  string  $name:       参数名称
-    :param  string  $value:      参数值
-    :param  array   $attributes: HTML 属性
-    :returns:   HTML track 标签
+    :param  string $src:         track 文件 (.vtt 文件) 的路径
+    :param  string $kind:        定时 track 的类型
+    :param  string $srcLanguage: 定时 track 的语言
+    :param  string $label:       定时 track 的用户可读标题
+    :returns:   一个 HTML track 标签
     :rtype: string
 
-    生成用于指定定时轨道的 track 元素。轨道以 WebVTT 格式格式化。示例:
+    生成用于指定定时轨道的 track 标签。轨道以 WebVTT 格式格式化。示例:
 
     .. literalinclude:: html_helper/019.php
 
 .. php:function:: doctype([$type = 'html5'])
 
     :param  string  $type: 文档类型名称
-    :returns:   HTML DocType 标签
+    :returns:   一个 HTML DocType 标签
     :rtype: string
 
-    帮助生成文档类型声明或 DTD。默认使用 HTML 5,但有许多可用的文档类型。
+    帮助你生成文档类型声明（DTD）。默认使用 HTML 5，但也有许多其他可用的文档类型。
 
     示例:
 
     .. literalinclude:: html_helper/020.php
 
-    以下是预定义的文档类型选择的列表。这些是可配置的,从 **app/Config/DocTypes.php** 中获取,或者可以在你的 **.env** 配置中重写。
+    以下是预定义的文档类型列表。这些文档类型从 **app/Config/DocTypes.php** 中提取，或者可以在你的 **.env** 配置中重写。
 
     =============================== =================== ==================================================================================================================================================
-    文档类型                        选项                结果
+    文档类型                        $type 参数          结果
     =============================== =================== ==================================================================================================================================================
     XHTML 1.1                       xhtml11             <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
-    XHTML 1.0 严格                  xhtml1-strict       <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
-    XHTML 1.0 过渡                  xhtml1-trans        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
-    XHTML 1.0 框架集                xhtml1-frame        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
+    XHTML 1.0 Strict                xhtml1-strict       <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+    XHTML 1.0 Transitional          xhtml1-trans        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+    XHTML 1.0 Frameset              xhtml1-frame        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Frameset//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-frameset.dtd">
     XHTML Basic 1.1                 xhtml-basic11       <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML Basic 1.1//EN" "http://www.w3.org/TR/xhtml-basic/xhtml-basic11.dtd">
     HTML 5                          html5               <!DOCTYPE html>
-    HTML 4 严格                     html4-strict        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
-    HTML 4 过渡                     html4-trans         <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
-    HTML 4 框架集                   html4-frame         <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
+    HTML 4 Strict                   html4-strict        <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
+    HTML 4 Transitional             html4-trans         <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
+    HTML 4 Frameset                 html4-frame         <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Frameset//EN" "http://www.w3.org/TR/html4/frameset.dtd">
     MathML 1.01                     mathml1             <!DOCTYPE math SYSTEM "http://www.w3.org/Math/DTD/mathml1/mathml.dtd">
     MathML 2.0                      mathml2             <!DOCTYPE math PUBLIC "-//W3C//DTD MathML 2.0//EN" "http://www.w3.org/Math/DTD/mathml2/mathml2.dtd">
     SVG 1.0                         svg10               <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.0//EN" "http://www.w3.org/TR/2001/REC-SVG-20010904/DTD/svg10.dtd">
-    SVG 1.1 完整                    svg11               <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
-    SVG 1.1 基本                    svg11-basic         <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1 Basic//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd">
+    SVG 1.1 Full                    svg11               <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+    SVG 1.1 Basic                   svg11-basic         <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1 Basic//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-basic.dtd">
     SVG 1.1 Tiny                    svg11-tiny          <!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1 Tiny//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11-tiny.dtd">
-    XHTML+MathML+SVG (XHTML 主机)   xhtml-math-svg-xh   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">
-    XHTML+MathML+SVG (SVG 主机)     xhtml-math-svg-sh   <!DOCTYPE svg:svg PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">
+    XHTML+MathML+SVG (XHTML host)   xhtml-math-svg-xh   <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">
+    XHTML+MathML+SVG (SVG host)     xhtml-math-svg-sh   <!DOCTYPE svg:svg PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" "http://www.w3.org/2002/04/xhtml-math-svg/xhtml-math-svg.dtd">
     XHTML+RDFa 1.0                  xhtml-rdfa-1        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.0//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-1.dtd">
     XHTML+RDFa 1.1                  xhtml-rdfa-2        <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML+RDFa 1.1//EN" "http://www.w3.org/MarkUp/DTD/xhtml-rdfa-2.dtd">
     =============================== =================== ==================================================================================================================================================
diff --git a/source/helpers/text_helper.rst b/source/helpers/text_helper.rst
index 71decc33..baefb401 100755
--- a/source/helpers/text_helper.rst
+++ b/source/helpers/text_helper.rst
@@ -110,7 +110,7 @@
 
     .. note:: 出于历史原因,此函数也接受并处理字符串输入。但是,这使它只是一个 ``stripslashes()`` 的别名。
 
-.. php:function:: reduce_multiples($str[, $character = ''[, $trim = false]])
+.. php:function:: reduce_multiples($str[, $character = ','[, $trim = false]])
 
     :param    string    $str: 要搜索的文本
     :param    string    $character: 要缩减的字符
@@ -122,7 +122,7 @@
 
     .. literalinclude:: text_helper/009.php
 
-    如果第三个参数设置为 true,则会移除字符串开头和结尾处的字符出现。示例:
+    如果第三个参数设置为 ``true``，它将移除字符串开头和结尾处出现的字符。例如：
 
     .. literalinclude:: text_helper/010.php
 
diff --git a/source/helpers/text_helper/009.php b/source/helpers/text_helper/009.php
index 60f35bc4..073efcee 100644
--- a/source/helpers/text_helper/009.php
+++ b/source/helpers/text_helper/009.php
@@ -1,4 +1,4 @@
 <?php
 
 $string = 'Fred, Bill,, Joe, Jimmy';
-$string = reduce_multiples($string, ','); // results in "Fred, Bill, Joe, Jimmy"
+$string = reduce_multiples($string); // results in "Fred, Bill, Joe, Jimmy"
diff --git a/source/helpers/text_helper/010.php b/source/helpers/text_helper/010.php
index fd79b8f6..7c69ac5a 100644
--- a/source/helpers/text_helper/010.php
+++ b/source/helpers/text_helper/010.php
@@ -1,4 +1,4 @@
 <?php
 
 $string = ',Fred, Bill,, Joe, Jimmy,';
-$string = reduce_multiples($string, ', ', true); // results in "Fred, Bill, Joe, Jimmy"
+$string = reduce_multiples($string, ',', true); // results in "Fred, Bill, Joe, Jimmy"
diff --git a/source/incoming/routing.rst b/source/incoming/routing.rst
index 74c2e984..a7606b6c 100755
--- a/source/incoming/routing.rst
+++ b/source/incoming/routing.rst
@@ -983,3 +983,31 @@ spark 路由
 .. code-block:: console
 
     php spark routes --host accounts.example.com
+
+获取路由信息
+***************************
+
+在 CodeIgniter 4 中，理解和管理路由信息对于有效处理 HTTP 请求至关重要。这涉及到检索有关活动控制器和方法的详细信息，以及应用于特定路由的过滤器。下面，我们探讨如何访问这些路由信息，以帮助完成诸如日志记录、调试或实现条件逻辑等任务。
+
+检索当前控制器/方法名称
+==============================================
+
+在某些情况下，你可能需要确定当前 HTTP 请求触发了哪个控制器和方法。这对于日志记录、调试或基于活动控制器方法的条件逻辑非常有用。
+
+CodeIgniter 4 提供了一种简单的方法来使用 ``Router`` 类访问当前路由的控制器和方法名称。以下是一个示例：
+
+.. literalinclude:: routing/071.php
+
+当你需要动态地与控制器交互或记录处理特定请求的方法时，这个功能特别有用。
+
+获取当前路由的活动过滤器
+============================================
+
+:doc:`过滤器 <filters>` 是一个强大的功能，使你能够在处理 HTTP 请求之前或之后执行诸如身份验证、日志记录和安全检查等操作。要访问特定路由的活动过滤器，你可以使用 ``Router`` 类中的 :php:meth:`CodeIgniter\\Router\\Router::getFilters()` 方法。
+
+此方法返回当前正在处理的路由的活动过滤器列表：
+
+.. literalinclude:: routing/072.php
+
+.. note:: ``getFilters()`` 方法仅返回为特定路由定义的过滤器。
+     它不包括全局过滤器或在 **app/Config/Filters.php** 文件中指定的过滤器。
diff --git a/source/incoming/routing/071.php b/source/incoming/routing/071.php
new file mode 100644
index 00000000..fe56c279
--- /dev/null
+++ b/source/incoming/routing/071.php
@@ -0,0 +1,14 @@
+<?php
+
+// Get the router instance.
+/** @var \CodeIgniter\Router\Router $router */
+$router = service('router');
+
+// Retrieve the fully qualified class name of the controller handling the current request.
+$controller = $router->controllerName();
+
+// Retrieve the method name being executed in the controller for the current request.
+$method = $router->methodName();
+
+echo 'Current Controller: ' . $controller . '<br>';
+echo 'Current Method: ' . $method;
diff --git a/source/incoming/routing/072.php b/source/incoming/routing/072.php
new file mode 100644
index 00000000..dbf695c5
--- /dev/null
+++ b/source/incoming/routing/072.php
@@ -0,0 +1,8 @@
+<?php
+
+// Get the router instance.
+/** @var \CodeIgniter\Router\Router $router */
+$router  = service('router');
+$filters = $router->getFilters();
+
+echo 'Active Filters for the Route: ' . implode(', ', $filters);
diff --git a/source/installation/upgrade_455.rst b/source/installation/upgrade_455.rst
new file mode 100644
index 00000000..bcea4a41
--- /dev/null
+++ b/source/installation/upgrade_455.rst
@@ -0,0 +1,39 @@
+#############################
+从 4.5.4 升级到 4.5.5
+#############################
+
+请参考与你的安装方法相对应的升级说明。
+
+- :ref:`Composer 安装 App Starter 升级 <app-starter-upgrading>`
+- :ref:`Composer 安装 将 CodeIgniter4 添加到现有项目 升级 <adding-codeigniter4-upgrading>`
+- :ref:`手动安装 升级 <installing-manual-upgrading>`
+
+.. contents::
+    :local:
+    :depth: 2
+
+*************
+项目文件
+*************
+
+**项目空间** （根目录、app、public、writable）中的一些文件收到了更新。由于这些文件位于 **system** 范围之外，因此不会在没有你干预的情况下进行更改。
+
+.. note:: 有一些第三方 CodeIgniter 模块可以帮助合并项目空间的更改：
+    `在 Packagist 上探索 <https://packagist.org/explore/?query=codeigniter4%20updates>`_。
+
+内容更改
+===============
+
+以下文件进行了重大更改（包括弃用或视觉调整），建议你将更新版本与应用程序合并：
+
+配置
+------
+
+- composer.json
+
+所有更改
+===========
+
+这是 **项目空间** 中所有收到更改的文件列表；许多只是简单的注释或格式调整，对运行时没有影响：
+
+- composer.json
diff --git a/source/installation/upgrade_models.rst b/source/installation/upgrade_models.rst
index 4706ca5e..cca8b23c 100644
--- a/source/installation/upgrade_models.rst
+++ b/source/installation/upgrade_models.rst
@@ -20,11 +20,13 @@
 升级指南
 =============
 
-1. 首先,将所有模型文件移到 **app/Models** 文件夹中。
-2. 在打开的 php 标记之后添加此行:``namespace App\Models;``。
-3. 在 ``namespace App\Models;`` 行的下面添加此行:``use CodeIgniter\Model;``。
+1. 首先，将所有模型文件移动到文件夹 **app/Models**。
+2. 在 PHP 标签的开头之后添加这一行：``namespace App\Models;``。
+3. 在 ``namespace App\Models;`` 行的下面添加这一行：``use CodeIgniter\Model;``。
 4. 将 ``extends CI_Model`` 替换为 ``extends Model``。
-5. 与 CI3 的 ``$this->load->model('x');`` 不同,你现在会使用 ``$this->x = new X();``,遵循组件的命名空间约定。或者,你可以使用 :php:func:`model()` 函数:``$this->x = model('X');``。
+5. 添加 ``protected $table`` 属性并设置表名。
+6. 添加 ``protected $allowedFields`` 属性并设置允许插入/更新的字段名称数组。
+7. 代替 CI3 的 ``$this->load->model('x');``，你现在应该使用 ``$this->x = new X();``，遵循组件的命名空间约定。或者，你可以使用 :php:func:`model()` 函数：``$this->x = model('X');``。
 
 如果在模型结构中使用子目录,则必须根据情况更改命名空间。
 例如:你有一个版本 3 模型位于 **application/models/users/user_contact.php**,命名空间必须是 ``namespace App\Models\Users;``,版本 4 中的模型路径应如下所示:**app/Models/Users/UserContact.php**
@@ -51,4 +53,8 @@ CodeIgniter 4.x 版本
 
 .. literalinclude:: upgrade_models/001.php
 
-要插入数据,可以直接调用 ``$model->insert()``,因为这个方法在 CI4 中是内置的。
+上述代码是从 CI3 到 CI4 的直接翻译。它在模型中直接使用了查询构建器。请注意，当你直接使用查询构建器时，你将无法使用 CodeIgniter 模型中的功能。
+
+如果你想使用 CodeIgniter 模型的功能，代码将是：
+
+.. literalinclude:: upgrade_models/002.php
diff --git a/source/installation/upgrade_models/001.php b/source/installation/upgrade_models/001.php
index 0d7882ed..a09dfdfb 100644
--- a/source/installation/upgrade_models/001.php
+++ b/source/installation/upgrade_models/001.php
@@ -4,7 +4,20 @@
 
 use CodeIgniter\Model;
 
-class UserContact extends Model
+class NewsModel extends Model
 {
-    // insert() method already implemented in parent
+    // Sets the table name.
+    protected $table = 'news';
+
+    public function setNews($title, $slug, $text)
+    {
+        $data = [
+            'title' => $title,
+            'slug'  => $slug,
+            'text'  => $text,
+        ];
+
+        // Gets the Query Builder for the table, and calls `insert()`.
+        return $this->builder()->insert($data);
+    }
 }
diff --git a/source/installation/upgrade_models/002.php b/source/installation/upgrade_models/002.php
new file mode 100644
index 00000000..a34937f1
--- /dev/null
+++ b/source/installation/upgrade_models/002.php
@@ -0,0 +1,26 @@
+<?php
+
+namespace App\Models;
+
+use CodeIgniter\Model;
+
+class NewsModel extends Model
+{
+    // Sets the table name.
+    protected $table = 'news';
+
+    // Sets the field names to allow to insert/update.
+    protected $allowedFields = ['title', 'slug', 'text'];
+
+    public function setNews($title, $slug, $text)
+    {
+        $data = [
+            'title' => $title,
+            'slug'  => $slug,
+            'text'  => $text,
+        ];
+
+        // Uses Model's`insert()` method.
+        return $this->insert($data);
+    }
+}
diff --git a/source/installation/upgrade_models/ci3sample/001.php b/source/installation/upgrade_models/ci3sample/001.php
index 1ab3917c..d9f3a3d7 100644
--- a/source/installation/upgrade_models/ci3sample/001.php
+++ b/source/installation/upgrade_models/ci3sample/001.php
@@ -1,13 +1,15 @@
 <?php
 
-class User_contact extends CI_Model
+class News_model extends CI_Model
 {
-    public function insert($name, $address, $email)
+    public function set_news($title, $slug, $text)
     {
-        $this->db->insert('user_contacts', array(
-            'name'    => $name,
-            'address' => $address,
-            'email'   => $email,
-        ));
+        $data = array(
+            'title' => $title,
+            'slug'  => $slug,
+            'text'  => $text,
+        );
+
+        return $this->db->insert('news', $data);
     }
 }
diff --git a/source/installation/upgrading.rst b/source/installation/upgrading.rst
index 993bddf5..b0886b97 100755
--- a/source/installation/upgrading.rst
+++ b/source/installation/upgrading.rst
@@ -14,6 +14,7 @@
 
     backward_compatibility_notes
 
+    upgrade_455
     upgrade_454
     upgrade_453
     upgrade_452
diff --git a/source/libraries/curlrequest.rst b/source/libraries/curlrequest.rst
index b06bbed2..adef5655 100755
--- a/source/libraries/curlrequest.rst
+++ b/source/libraries/curlrequest.rst
@@ -215,7 +215,7 @@ form_params
 
 .. literalinclude:: curlrequest/024.php
 
-.. note:: ``form_params`` 不能与 ``multipart`` 选项一起使用。你需要使用其中一个。对 ``application/x-www-form-urlencoded`` 请求使用 ``form_params``,对 ``multipart/form-data`` 请求使用 ``multipart``。
+.. note:: ``form_params`` 不能与 `multipart`_ 选项一起使用。你需要使用其中一个。对 ``application/x-www-form-urlencoded`` 请求使用 ``form_params``,对 ``multipart/form-data`` 请求使用 ``multipart``。
 
 .. _curlrequest-request-options-headers:
 
@@ -249,12 +249,13 @@ json
 multipart
 =========
 
-当你需要通过 POST 请求发送文件和其他数据时,可以使用 ``multipart`` 选项,以及 `CURLFile 类 <https://www.php.net/manual/en/class.curlfile.php>`_。值应该是一个关联数组,包含要发送的 POST 数据。为了更安全地使用,上传文件通过在名称前加上 `@` 的遗留方法已被禁用。你想要发送的任何文件必须作为 CURLFile 实例传递:
+当你需要通过 POST 请求发送文件和其他数据时，可以使用 ``multipart`` 选项，以及 `CURLFile 类 <https://www.php.net/manual/zh/class.curlfile.php>`_。
+
+这些值应该是一个关联数组，包含要发送的 POST 数据。为了更安全地使用，前缀带有 ``@`` 的旧方法已被禁用。任何你想发送的文件必须作为 CURLFile 的实例传递：
 
 .. literalinclude:: curlrequest/028.php
 
-.. note:: ``multipart`` 不能与 ``form_params`` 选项一起使用。你只能使用其中一个。对 ``application/x-www-form-urlencoded`` 请求使用
-        ``form_params``,对 ``multipart/form-data`` 请求使用 ``multipart``。
+.. note:: ``multipart`` 不能与 `form_params`_ 选项一起使用。你只能使用其中一个。使用 ``form_params`` 进行 ``application/x-www-form-urlencoded`` 请求，使用 ``multipart`` 进行 ``multipart/form-data`` 请求。
 
 .. _curlrequest-request-options-proxy:
 
diff --git a/source/libraries/curlrequest/028.php b/source/libraries/curlrequest/028.php
index fcce227c..e56b96b1 100644
--- a/source/libraries/curlrequest/028.php
+++ b/source/libraries/curlrequest/028.php
@@ -1,6 +1,8 @@
 <?php
 
-$post_data = [
-    'foo'      => 'bar',
-    'userfile' => new \CURLFile('/path/to/file.txt'),
-];
+$client->request('POST', '/post', [
+    'multipart' => [
+        'foo'      => 'bar',
+        'userfile' => new \CURLFile('/path/to/file.txt'),
+    ],
+]);
diff --git a/source/libraries/validation.rst b/source/libraries/validation.rst
index 0381d3e6..8996ff46 100755
--- a/source/libraries/validation.rst
+++ b/source/libraries/validation.rst
@@ -390,6 +390,8 @@ withRequest()
 .. literalinclude:: validation/045.php
    :lines: 2-
 
+.. _saving-validation-rules-to-config-file:
+
 将一组验证规则保存到配置文件
 ==================================================
 
@@ -738,6 +740,8 @@ PHP 请求之间不共享任何内容。所以在验证失败时重定向,重定
 .. literalinclude:: validation/047.php
    :lines: 2-
 
+.. _validation-available-rules:
+
 ***************
 可用规则
 ***************
diff --git a/source/models/model.rst b/source/models/model.rst
index 1ce677b8..5043526a 100644
--- a/source/models/model.rst
+++ b/source/models/model.rst
@@ -185,12 +185,13 @@ $deletedField
 $validationRules
 ^^^^^^^^^^^^^^^^
 
-包含 :ref:`validation-array` 中描述的验证规则数组或包含要应用的验证组名称的字符串,如同一节中所述。下面更详细地描述。
+包含一个验证规则数组，如 :ref:`validation-array` 中所述，或者包含验证组名称的字符串，如同一节中所述。
+另请参见 :ref:`model-setting-validation-rules`。
 
 $validationMessages
 ^^^^^^^^^^^^^^^^^^^
 
-包含应在验证期间使用的自定义错误消息数组,如 :ref:`validation-custom-errors` 中所述。下面更详细地描述。
+包含一个自定义错误消息数组，这些消息将在验证过程中使用，如 :ref:`validation-custom-errors` 中所述。另请参见 :ref:`model-setting-validation-rules`。
 
 $skipValidation
 ^^^^^^^^^^^^^^^
@@ -540,10 +541,12 @@ purgeDeleted()
 模型内验证
 ===================
 
+.. warning:: 在模型内验证是在数据存储到数据库之前进行的。在此之前，数据尚未经过验证。在验证之前处理用户输入的数据可能会引入漏洞。
+
 验证数据
 ---------------
 
-对于许多人来说，在模型中验证数据是确保数据保持单一标准而不重复代码的首选方式。Model 类提供了一种方法，可以在使用 ``insert()``、``update()`` 或 ``save()`` 方法保存到数据库之前自动验证所有数据。
+Model 类提供了一种方法，可以在使用 ``insert()``、``update()`` 或 ``save()`` 方法保存到数据库之前自动验证所有数据。
 
 .. important:: 当你更新数据时，默认情况下，模型类中的验证只会验证提供的字段。这是为了避免在仅更新某些字段时出现验证错误。
 
@@ -553,14 +556,20 @@ purgeDeleted()
 
     为了避免这种问题，可以通过配置更改此行为。详情请参见 :ref:`clean-validation-rules`。
 
+.. _model-setting-validation-rules:
+
 设置验证规则
 ------------------------
 
-第一步是用将应用的字段和规则填充 `$validationRules`_ 类属性。如果你有要使用的自定义错误消息,请将其放入 `$validationMessages`_ 数组中:
+第一步是填写 `$validationRules`_ 类属性，包含需要应用的字段和规则。
+
+.. note:: 你可以在 :ref:`validation-available-rules` 中查看内置验证规则的列表。
+
+如果你有自定义的错误消息，可以将它们放在 `$validationMessages`_ 数组中：
 
 .. literalinclude:: model/027.php
 
-如果你更喜欢在验证配置文件中组织你的规则和错误消息，你可以这样做，并将 `$validationRules`_ 设置为你创建的验证规则组的名称：
+如果你更愿意在 :ref:`Validation Config File <saving-validation-rules-to-config-file>` 中组织你的规则和错误消息，你可以这样做，然后只需将 `$validationRules`_ 设置为你创建的验证规则组的名称：
 
 .. literalinclude:: model/034.php
 
@@ -819,10 +828,10 @@ beforeInsert      **data** = 正在插入的键/值对。如果将对象或 Enti
 afterInsert       **id** = 新行的主键，如果失败则为 0。
                   **data** = 正在插入的键/值对。
                   **result** = 通过查询构建器使用的 ``insert()`` 方法的结果。
-beforeUpdate      **id** = 正在更新的行的主键数组。
+beforeUpdate      **id** = 传递给 ``update()`` 方法的行的主键数组。
                   **data** = 正在更新的键/值对。如果将对象或 Entity 类传递给
                   ``update()`` 方法，它首先会被转换为数组。
-afterUpdate       **id** = 正在更新的行的主键数组。
+afterUpdate       **id** = 传递给 ``update()`` 方法的行的主键数组。
                   **data** = 正在更新的键/值对。
                   **result** = 通过查询构建器使用的 ``update()`` 方法的结果。
 beforeFind        调用 **method** 的名称，是否请求了 **singleton**，以及以下附加字段：
diff --git a/source/models/model/057.php b/source/models/model/057.php
index 6b7ca325..8184fd35 100644
--- a/source/models/model/057.php
+++ b/source/models/model/057.php
@@ -7,7 +7,7 @@
 class UserModel extends Model
 {
     // ...
-    protected $casts = [
+    protected array $casts = [
         'id'        => 'int',
         'birthdate' => '?datetime',
         'hobbies'   => 'json-array',
diff --git a/source/outgoing/api_responses/002.php b/source/outgoing/api_responses/002.php
index e383ddc3..5484a5a3 100644
--- a/source/outgoing/api_responses/002.php
+++ b/source/outgoing/api_responses/002.php
@@ -24,8 +24,8 @@
 // Resource Not Found
 $this->failNotFound($description);
 
-// Data did not validate
-$this->failValidationError($description);
+// Data was not validated
+$this->failValidationErrors($errors);
 
 // Resource already exists
 $this->failResourceExists($description);
diff --git a/source/outgoing/localization.rst b/source/outgoing/localization.rst
index 2ec61ed7..822172ab 100644
--- a/source/outgoing/localization.rst
+++ b/source/outgoing/localization.rst
@@ -12,18 +12,6 @@
 
 CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用程序。尽管完整地本地化一个应用程序是个复杂的题目,但在应用程序中用不同的支持语言交换字符串是非常简单的。
 
-语言字符串存储在 **app/Language** 目录中,每个支持的语言都有对应的子目录::
-
-    app/
-        Language/
-            en/
-                App.php
-            fr/
-                App.php
-
-.. important:: 仅基于网络的请求才会启用本地化检测,需要使用 IncomingRequest 类。
-    命令行下的请求不支持这些特性。
-
 配置语言环境
 ======================
 
@@ -43,7 +31,12 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 语言环境检测
 ================
 
-在请求期间支持两种方法来检测正确的语言环境。第一种方法是一个“设置完就忘记”的方式,将自动为你执行 :doc:`内容协商 </incoming/content_negotiation>` 以确定使用的正确语言环境。第二种方法允许你在路由中指定一个片段来设置语言环境。
+.. important:: 语言环境检测仅适用于使用 IncomingRequest 类的基于 Web 的请求。命令行请求将不具备这些功能。
+
+在请求期间，有两种方法可以检测正确的语言环境。
+
+1. `内容协商`_：第一种是"设置完就忘记"的方法，它将自动为你执行 :doc:`内容协商 </incoming/content_negotiation>`，以确定要使用的正确语言环境。
+2. `在路由中`_：第二种方法允许你在路由中指定一个段，该段将用于设置语言环境。
 
 如果你需要直接设置语言环境,请参见 `设置当前语言环境`_ 。
 
@@ -68,19 +61,27 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 第二种方法使用一个自定义占位符来检测所需的语言环境并在 Request 中设置它。可以将占位符 ``{locale}`` 作为路由中的一个片段。如果存在,匹配片段的内容将是你的语言环境:
 
 .. literalinclude:: localization/004.php
+    :lines: 2-
 
 在这个例子中,如果用户试图访问 **http://example.com/fr/books**,那么语言环境将被设置为 ``fr``,假设它已经在 ``$supportedLocales`` 中被配置为有效的语言环境。
 
 如果该值与 ``app/Config/App.php`` 中定义的 ``$supportedLocales`` 中的有效语言环境不匹配,将使用默认语言环境取代,除非你设置只使用 App 配置文件中定义的受支持语言环境:
 
 .. literalinclude:: localization/018.php
+    :lines: 2-
 
 .. note:: ``useSupportedLocalesOnly()`` 方法可以在 v4.3.0 及以上版本中使用。
 
 设置当前语言环境
 ==========================
 
-如果你想直接设置语言环境，可以使用 ``IncomingRequest::setLocale(string $locale)``。
+IncomingRequest 语言环境
+------------------------
+
+如果你想直接设置语言环境，你可以在 :doc:`../incoming/incomingrequest` 中使用 ``setLocale()`` 方法：
+
+.. literalinclude:: localization/020.php
+    :lines: 2-
 
 在设置语言环境之前，你必须设置有效的语言环境。因为任何尝试设置无效语言环境的操作都会导致设置 :ref:`默认语言环境 <setting-the-default-locale>`。
 
@@ -90,6 +91,16 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 
 .. note:: 自 v4.4.0 起，``IncomingRequest::setValidLocales()`` 已被添加用于设置（和重置）有效的语言环境。如果你想动态更改有效的语言环境，请使用它。
 
+Language 语言环境
+-----------------
+
+在 :php:func:`lang()` 函数中使用的 ``Language`` 类也包含当前的语言环境。这是在实例化时设置为 ``IncommingRequest`` 的语言环境。
+
+如果你想在实例化语言类后更改语言环境，可以使用 ``Language::setLocale()`` 方法。
+
+.. literalinclude:: localization/021.php
+    :lines: 2-
+
 获取当前语言环境
 =============================
 
@@ -101,6 +112,7 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 或者,你可以使用 :doc:`Services 类 </concepts/services>` 来检索当前请求:
 
 .. literalinclude:: localization/006.php
+    :lines: 2-
 
 .. _language-localization:
 
@@ -111,6 +123,15 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 创建语言文件
 =======================
 
+语言字符串存储在 **app/Language** 目录中，每个支持的语言（语言环境）都有一个子目录::
+
+    app/
+        Language/
+            en/
+                App.php
+            fr/
+                App.php
+
 .. note:: 语言文件没有命名空间。
 
 语言文件没有任何特定的命名约定是必需的。文件名应该具有描述它所包含内容的逻辑名称。例如,假设你想创建一个包含错误信息的文件。你可以简单地将其命名为:**Errors.php**。
@@ -119,6 +140,8 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 
 .. literalinclude:: localization/007.php
 
+.. note:: 你不能在语言键的开头和结尾使用点（``.``）。
+
 它也支持嵌套定义:
 
 .. literalinclude:: localization/008.php
@@ -133,12 +156,14 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 例如，要从 **Errors.php** 语言文件加载 ``errorEmailMissing`` 字符串，你可以执行以下操作：
 
 .. literalinclude:: localization/010.php
+    :lines: 2-
 
 对于嵌套定义,你可以执行以下操作:
 
 .. literalinclude:: localization/011.php
+    :lines: 2-
 
-如果请求的语言键在当前语言环境的文件中不存在,字符串将原封不动地返回。在此例中,如果它不存在,将返回 ``Errors.errorEmailMissing`` 或者 ``Errors.nested.error.message``。
+如果当前语言环境的文件中不存在请求的语言键（在 `语言回退`_ 之后），字符串将被原样返回。在这个例子中，如果不存在，它将返回 ``Errors.errorEmailMissing`` 或 ``Errors.nested.error.message``。
 
 替换参数
 --------------------
@@ -152,10 +177,12 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 数组中第一个项目对应于索引的项目的占位符,如果是数字的话:
 
 .. literalinclude:: localization/013.php
+    :lines: 2-
 
 你也可以使用命名键以保持简洁,如果你愿意的话:
 
 .. literalinclude:: localization/014.php
+    :lines: 2-
 
 显然,你不仅可以进行数字替换。根据项目底层库的
 `官方 ICU 文档 <https://unicode-org.github.io/icu-docs/apidoc/released/icu4c/classMessageFormat.html#details>`_ ,
@@ -177,10 +204,12 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 指定语言环境
 -----------------
 
-要指定不同的语言环境用于替换参数,你可以将语言环境作为第三个参数传递给 ``lang()`` 函数。
+要指定不同的语言环境用于替换参数,你可以将语言环境作为第三个参数传递给 :php:func:`lang()` 函数。
 
 .. literalinclude:: localization/016.php
 
+如果你想更改当前的语言环境，请参见 `Language 语言环境`_。
+
 嵌套数组
 -------------
 
@@ -192,23 +221,23 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 =================
 
 如果你为一个给定的语言环境拥有一组消息,例如
-**Language/en/app.php**,你可以为该语言环境添加语言变体,
-每种变体各自一个文件夹,例如 **Language/en-US/app.php**。
+**Language/en/App.php**,你可以为该语言环境添加语言变体,
+每种变体各自一个文件夹,例如 **Language/en-US/App.php**。
 
 你只需要为需要针对该语言环境变体进行本地化的消息提供不同的值。
 任何缺失的消息定义将自动从主要的语言环境中获取。
 
-更好的是,本地化可以一直回退到英语,
+更好的是,本地化可以一直回退到英语(**en**),
 以防还没有机会为你的语言环境翻译框架中添加的新消息。
 
 因此,如果你使用 ``fr-CA`` 语言环境,则本地化消息将首先在
 **Language/fr-CA** 目录中查找,然后在 **Language/fr** 目录中查找,
 最后在 **Language/en** 目录中查找。
 
-消息翻译
+系统消息翻译
 ====================
 
-我们在自己的 `仓库 <https://github.com/codeigniter4/translations>`_ 中有一组“官方”翻译。
+我们在自己的 `仓库 <https://github.com/codeigniter4/translations>`_ 中有一组“官方”系统消息翻译。
 
 你可以下载该仓库,并将其 **Language** 文件夹复制到
 你的 **app** 文件夹中。合并的翻译将被自动使用,因为 ``App`` 命名空间映射到你的 **app** 文件夹。
@@ -221,6 +250,13 @@ CodeIgniter 提供了几个工具来帮助你为不同的语言本地化应用
 
 翻译的消息将自动被使用,因为翻译文件夹得到了正确的映射。
 
+覆盖系统消息翻译
+================
+
+框架提供了 `系统消息翻译`_，你安装的包也可能提供消息翻译。
+
+如果你想覆盖某些语言消息，可以在 **app/Language** 目录下创建语言文件。然后，在文件中仅返回你想要覆盖的数组。
+
 .. _generating-translation-files-via-command:
 
 通过命令生成翻译文件
diff --git a/source/outgoing/localization/020.php b/source/outgoing/localization/020.php
new file mode 100644
index 00000000..3116bd0d
--- /dev/null
+++ b/source/outgoing/localization/020.php
@@ -0,0 +1,4 @@
+<?php
+
+/** @var \CodeIgniter\HTTP\IncomingRequest $request */
+$request->setLocale('ja');
diff --git a/source/outgoing/localization/021.php b/source/outgoing/localization/021.php
new file mode 100644
index 00000000..9dbc8d1f
--- /dev/null
+++ b/source/outgoing/localization/021.php
@@ -0,0 +1,5 @@
+<?php
+
+/** @var \CodeIgniter\Language\Language $lang */
+$lang = service('language');
+$lang->setLocale('ja');