update

hex-ci · hex-ci · commit cc59641123d8 · 2023-10-28T15:25:57.000+08:00
diff --git a/source/changelogs/v4.3.0.rst b/source/changelogs/v4.3.0.rst
@@ -296,7 +296,7 @@ HTML5 兼容性
 
 - 现在可以记录弃用警告而不是抛出异常。详情请参阅 :ref:`logging_deprecation_warnings`。
 - 弃用的记录默认启用。
-- 要*临时*启用弃用抛出,请将环境变量 ``CODEIGNITER_SCREAM_DEPRECATIONS`` 设置为真值。
+- 要 *临时* 启用弃用抛出,请将环境变量 ``CODEIGNITER_SCREAM_DEPRECATIONS`` 设置为真值。
 - ``Config\Logger::$threshold`` 现在默认为特定于环境。对于生产环境,默认阈值仍为 ``4``,但对于其他环境已更改为 ``9``。
 
 .. _v430-multiple-domain-support:
diff --git a/source/changelogs/v4.3.5.rst b/source/changelogs/v4.3.5.rst
@@ -12,7 +12,7 @@
 安全性
 ********
 
-- 修复了*验证占位符中的远程代码执行漏洞*。
+- 修复了 *验证占位符中的远程代码执行漏洞*。
   更多信息请参阅 `安全公告 GHSA-m6m8-6gq8-c9fj <https://github.com/codeigniter4/CodeIgniter4/security/advisories/GHSA-m6m8-6gq8-c9fj>`_。
 - 修复了 ``Session::stop()`` 未能销毁会话的问题。
   详情请参阅 :ref:`Session Library <session-stop>`。
diff --git a/source/concepts/factories.rst b/source/concepts/factories.rst
@@ -42,7 +42,7 @@
 
 以 **模型** 为例。你可以通过使用 Factories 类的魔术静态方法 ``Factories::models()`` 访问特定于模型的工厂。
 
-静态方法名称称为 *component*。
+静态方法名为 *component*。
 
 .. _factories-passing-classname-without-namespace:
 
@@ -132,14 +132,14 @@ model()
 工厂参数
 ******************
 
-``工厂`` 的第二个参数是一个选项值数组(如下所述)。
+``Factories`` 的第二个参数是一个选项值数组(如下所述)。
 这些指令将覆盖为每个组件配置的默认选项。
 
 同时传递的任何更多参数将转发到类构造函数,使你可以即时配置类实例。例如,假设你的应用使用单独的数据库进行身份验证,并且你希望确保尝试访问用户记录的任何尝试都通过该连接:
 
 .. literalinclude:: factories/004.php
 
-现在从 ``工厂`` 加载的 ``UserModel`` 每次实际上都会返回使用备用数据库连接的类实例。
+现在从 ``Factories`` 加载的 ``UserModel`` 每次实际上都会返回使用备用数据库连接的类实例。
 
 .. _factories-options:
 
diff --git a/source/general/common_functions.rst b/source/general/common_functions.rst
@@ -353,7 +353,7 @@ CodeIgniter 提供了一些全局定义的函数和变量,在任何时候都可
 
     .. note:: 此函数要求控制器/方法必须在 **app/Config/routes.php** 中定义路由。
 
-    .. important:: ``route_to()`` 返回一个*路由*路径,而不是站点的完整 URI 路径。如果你的 **baseURL** 包含子文件夹,返回值与链接的 URI 并不相同。在这种情况下,请改用 :php:func:`url_to()`。另请参阅 :ref:`urls-url-structure`。
+    .. important:: ``route_to()`` 返回一个 *路由* 路径,而不是站点的完整 URI 路径。如果你的 **baseURL** 包含子文件夹,返回值与链接的 URI 并不相同。在这种情况下,请改用 :php:func:`url_to()`。另请参阅 :ref:`urls-url-structure`。
 
     根据 controller::method 组合为你生成路由。将根据提供的参数生成路由。
 
diff --git a/source/general/configuration.rst b/source/general/configuration.rst
@@ -154,7 +154,7 @@ CodeIgniter 期望 **.env** 文件与 **app** 目录一起位于项目的根目
 配置类和环境变量
 ***********************************************
 
-当你实例化一个配置类时,任何*命名空间*环境变量都会被考虑合并到配置对象的属性中。
+当你实例化一个配置类时,任何 *命名空间* 环境变量都会被考虑合并到配置对象的属性中。
 
 .. important:: 你无法通过设置环境变量来添加新属性,也不能将标量值改变为数组。请参见 :ref:`env-var-replacements-for-data`。
 
@@ -169,7 +169,7 @@ CodeIgniter 期望 **.env** 文件与 **app** 目录一起位于项目的根目
 
 .. note:: 命名空间前缀和属性名均区分大小写。它们必须完全匹配配置类文件中定义的完整命名空间和属性名称。
 
-使用仅包含配置类名称的小写版本的*短前缀*相同。如果短前缀匹配类名,则 **.env** 中的值将替换配置文件中的值。
+使用仅包含配置类名称的小写版本的 *短前缀* 相同。如果短前缀匹配类名,则 **.env** 中的值将替换配置文件中的值。
 
 ::
 
@@ -181,7 +181,7 @@ CodeIgniter 期望 **.env** 文件与 **app** 目录一起位于项目的根目
     app_forceGlobalSecureRequests = true
     app_CSPEnabled = true
 
-.. note:: 使用*短前缀*时,属性名称仍必须完全匹配类中定义的名称。
+.. note:: 使用 *短前缀* 时,属性名称仍必须完全匹配类中定义的名称。
 
 .. _env-var-replacements-for-data:
 
diff --git a/source/general/logging.rst b/source/general/logging.rst
@@ -56,7 +56,7 @@ emergency   系统无法使用。
 - **ChromeLogger Handler** 如果你在 Chrome 网页浏览器中安装了 `ChromeLogger 扩展 <https://craig.is/writing/chrome-logger>`_,则可以使用此处理程序在 Chrome 的控制台窗口中显示日志信息。
 - **Errorlog Handler** 此处理程序将利用 PHP 的原生 ``error_log()`` 函数并将日志写入其中。目前仅支持 ``error_log()`` 的 ``0`` 和 ``4`` 消息类型。
 
-主配置文件中的 ``$handlers`` 属性配置了处理程序,它简单地是一个处理程序数组及其配置。每个处理程序通过键指定,即完全限定的类名。值将是特定于每个处理程序的各种属性的数组。每个处理程序部分将有一个共同点:``handles``,这是一个日志级别*名称*数组,处理程序将为其记录信息。
+主配置文件中的 ``$handlers`` 属性配置了处理程序,它简单地是一个处理程序数组及其配置。每个处理程序通过键指定,即完全限定的类名。值将是特定于每个处理程序的各种属性的数组。每个处理程序部分将有一个共同点:``handles``,这是一个日志级别 *名称* 数组,处理程序将为其记录信息。
 
 .. literalinclude:: logging/004.php
 
diff --git a/source/general/managing_apps.rst b/source/general/managing_apps.rst
@@ -28,7 +28,7 @@
 重命名或重新定位应用程序目录
 ================================================
 
-如果你想要重命名应用程序目录或者甚至将其移动到服务器上的项目根目录之外的其他位置,请打开主 **app/Config/Paths.php** 文件,并在 ``$appDirectory`` 变量中设置一个*完整的服务器路径*(约第44行):
+如果你想要重命名应用程序目录或者甚至将其移动到服务器上的项目根目录之外的其他位置,请打开主 **app/Config/Paths.php** 文件,并在 ``$appDirectory`` 变量中设置一个 *完整的服务器路径* (约第44行):
 
 .. literalinclude:: managing_apps/001.php
 
diff --git a/source/general/modules.rst b/source/general/modules.rst
@@ -57,7 +57,7 @@ CodeIgniter 支持一种代码模块化形式,以帮助你创建可重用的代
 
 通常,你的模块不仅包含 PHP 类,还包含像程序函数、引导文件、模块常量文件等通常不会像加载类那样加载的文件。一种方法是在使用文件位置的开头 ``require`` 这些文件。
 
-CodeIgniter 提供的另一种方法是像自动加载类一样自动加载这些*非类*文件。我们需要做的就是提供这些文件路径的列表,并将它们包含在 **app/Config/Autoload.php** 文件的 ``$files`` 属性中。
+CodeIgniter 提供的另一种方法是像自动加载类一样自动加载这些 *非类* 文件。我们需要做的就是提供这些文件路径的列表,并将它们包含在 **app/Config/Autoload.php** 文件的 ``$files`` 属性中。
 
 .. literalinclude:: modules/002.php
 
diff --git a/source/helpers/filesystem_helper.rst b/source/helpers/filesystem_helper.rst
@@ -171,7 +171,7 @@
     :returns:    包含指定文件的信息的数组,失败为 false
     :rtype:    array
 
-    根据文件和路径,返回(可选地)*名称*、*路径*、*大小* 和 *修改日期* 信息属性。第二个参数允许你明确声明你想要返回的信息。
+    根据文件和路径,返回(可选地) *名称*、*路径*、*大小* 和 *修改日期* 信息属性。第二个参数允许你明确声明你想要返回的信息。
 
     有效的 ``$returnedValues`` 选项有:``name``、``size``、``date``、``readable``、``writeable``、``executable`` 和 ``fileperms``。
 
diff --git a/source/helpers/form_helper.rst b/source/helpers/form_helper.rst
@@ -268,7 +268,7 @@
 
 .. php:function:: form_fieldset_close([$extra = ''])
 
-    :param    string    $extra: 在关闭标签后要追加的任何内容,*原样*
+    :param    string    $extra: 在关闭标签后要追加的任何内容, *原样*
     :returns:    一个 HTML fieldset 关闭标签
     :rtype:    string
 
@@ -378,7 +378,7 @@
 
 .. php:function:: form_close([$extra = ''])
 
-    :param    string    $extra: 在关闭标签后要追加的任何内容,*原样*
+    :param    string    $extra: 在关闭标签后要追加的任何内容, *原样*
     :returns:    一个 HTML 表单关闭标签
     :rtype:    string
 
diff --git a/source/helpers/text_helper.rst b/source/helpers/text_helper.rst
@@ -29,7 +29,7 @@
 
     根据你指定的类型和长度生成随机字符串。用于创建密码或生成随机哈希值非常有用。
 
-    .. warning:: 对于类型:**basic**、**md5** 和 **sha1**,生成的字符串在加密上不是安全的。因此,这些类型不能用于加密目的或需要不可猜测返回值的目的。从 v4.3.3 开始,这些类型已弃用。
+    .. warning:: 对于类型: **basic**、**md5** 和 **sha1**,生成的字符串在加密上不是安全的。因此,这些类型不能用于加密目的或需要不可猜测返回值的目的。从 v4.3.3 开始,这些类型已弃用。
 
     第一个参数指定字符串的类型,第二个参数指定长度。可用的选择有:
 
@@ -154,7 +154,7 @@
     :returns:    限制字数的字符串
     :rtype:    string
 
-    将字符串截断为指定的*词数*。示例:
+    将字符串截断为指定的 *词数*。示例:
 
     .. literalinclude:: text_helper/013.php
 
@@ -168,7 +168,7 @@
     :returns:    限制字符数的字符串
     :rtype:    string
 
-    将字符串截断为指定的*字符数*。它保持词的完整性,所以字符数量可能略多于或略少于你指定的数量。
+    将字符串截断为指定的 *字符数*。它保持词的完整性,所以字符数量可能略多于或略少于你指定的数量。
 
     示例:
 
@@ -273,7 +273,7 @@
     :returns:    自动换行的字符串
     :rtype:    string
 
-    在保持完整单词的同时,在指定的*字符数*处换行文本。
+    在保持完整单词的同时,在指定的 *字符数* 处换行文本。
 
     示例:
 
diff --git a/source/incoming/routing.rst b/source/incoming/routing.rst
@@ -797,9 +797,9 @@ spark 路由
 
 *Route* 列显示要匹配的路由路径。定义路由的路由以正则表达式表示。
 
-自 v4.3.0 起,*Name* 列显示路由名称。``»`` 表示名称与路由路径相同。
+自 v4.3.0 起, *Name* 列显示路由名称。``»`` 表示名称与路由路径相同。
 
-.. important:: 该系统并非完美。如果使用自定义占位符,*Filters* 可能不正确。如果要检查路由的过滤器,可以使用 :ref:`spark filter:check <spark-filter-check>` 命令。
+.. important:: 该系统并非完美。如果使用自定义占位符, *Filters* 可能不正确。如果要检查路由的过滤器,可以使用 :ref:`spark filter:check <spark-filter-check>` 命令。
 
 自动路由(改进版)
 -----------------------
diff --git a/source/libraries/encryption.rst b/source/libraries/encryption.rst
@@ -2,7 +2,7 @@
 Encryption 服务
 ##################
 
-.. important:: 不要使用这个或任何其他*加密*库来存储密码!密码必须是*哈希过的*,你应该通过 PHP 的 `Password Hashing 扩展 <https://www.php.net/password>`_ 来完成。
+.. important:: 不要使用这个或任何其他 *加密* 库来存储密码!密码必须是 *哈希过的* ,你应该通过 PHP 的 `Password Hashing 扩展 <https://www.php.net/password>`_ 来完成。
 
 Encryption 服务提供对称(密钥)数据的双向加密。正如下面所解释的,该服务将实例化和/或初始化一个加密 **处理程序** 以适应你的参数。
 
diff --git a/source/libraries/sessions.rst b/source/libraries/sessions.rst
@@ -396,9 +396,9 @@ FileHandler 驱动程序(默认)
 
 更具体地说,它不支持 PHP 的 `session.save_path 中使用的目录级别和模式格式 <https://www.php.net/manual/en/session.configuration.php#ini.session.save-path>`_,大多数选项出于安全考虑都是硬编码的。相反,它只支持绝对路径作为 ``public string $savePath``。
 
-另一件重要的事情是,你应该知道,不要使用公开可读或共享的目录来存储 session 文件。请确保*只有你*可以查看选择的 *savePath* 目录的内容。否则,任何能够执行此操作的人都可以偷取当前的任何 session(也称为“会话固定”攻击)。
+另一件重要的事情是,你应该知道,不要使用公开可读或共享的目录来存储 session 文件。请确保 *只有你* 可以查看选择的 *savePath* 目录的内容。否则,任何能够执行此操作的人都可以偷取当前的任何 session(也称为“会话固定”攻击)。
 
-在类 UNIX 操作系统上,这通常通过使用 `chmod` 命令对该目录设置 0700 模式权限来实现,它仅允许目录所有者在其上执行读写操作。但是要小心,因为*运行*脚本的系统用户通常不是你自己,而是类似 'www-data' 的用户,所以只设置这些权限可能会中断你的应用程序。
+在类 UNIX 操作系统上,这通常通过使用 `chmod` 命令对该目录设置 0700 模式权限来实现,它仅允许目录所有者在其上执行读写操作。但是要小心,因为 *运行* 脚本的系统用户通常不是你自己,而是类似 'www-data' 的用户,所以只设置这些权限可能会中断你的应用程序。
 
 相反,你应该执行类似以下操作,这取决于你的环境:
 
diff --git a/source/outgoing/response.rst b/source/outgoing/response.rst
@@ -412,7 +412,7 @@ HTTP 缓存
 
         仅 ``name`` 和 ``value`` 是必需的。要删除 cookie,请将 ``expire`` 置空。
 
-        ``expire`` 以 **秒** 设置,将添加到当前时间。不要包括时间,而只设置从*现在*希望 cookie 有效的秒数。如果 ``expire`` 设置为零,cookie 将只在浏览器打开时有效。
+        ``expire`` 以 **秒** 设置,将添加到当前时间。不要包括时间,而只设置从 *现在* 希望 cookie 有效的秒数。如果 ``expire`` 设置为零,cookie 将只在浏览器打开时有效。
 
         .. note:: 但是如果同时将 ``value`` 设置为空字符串和 ``expire`` 设置为 ``0``,
             cookie 将被删除。
diff --git a/source/tutorial/news_section.rst b/source/tutorial/news_section.rst
@@ -28,7 +28,7 @@ CodeIgniter 安装假定你已经按 :ref:`要求 <requirements-supported-databa
 
 此外,添加一些种子记录。现在,我们只向你展示创建表所需的 SQL 语句,但是你应该意识到,一旦对 CodeIgniter 更熟悉,就可以以编程方式完成此操作;稍后,你可以阅读有关 :doc:`迁移 <../dbmgmt/migration>` 和 :doc:`种子 <../dbmgmt/seeds>` 的信息,以创建更有用的数据库设置。
 
-需要注意的是:在 Web 出版的上下文中,“slug”是指用于 URL 中识别和描述资源的用户和搜索引擎友好的短文本。
+一个有趣的注释：在 Web 发布的上下文中，“slug”是一个用户友好且符合 SEO 的短文本，用于在 URL 中标识和描述资源。
 
 种子记录可能如下::
 
