升级到 4.5.3 (#165)

Author: hex-ci

source/_static/css/citheme.css

@@ -245,6 +245,11 @@ html.writer-html5 .rst-content dl[class]:not(.option-list):not(.field-list):not(
     background-color: #fffff0;
 }
 
+span.std,
+span.pre {
+    text-wrap: nowrap;
+}
+
 /* Messages ----------------------------------------------------------------- */
 
 .rst-content .success {

source/changelogs/index.rst

@@ -12,6 +12,8 @@
 .. toctree::
     :titlesonly:
 
+    v4.5.3
+    v4.5.2
     v4.5.1
     v4.5.0
     v4.4.8

source/changelogs/v4.5.2.rst

@@ -0,0 +1,25 @@
+#############
+版本 4.5.2
+#############
+
+发布日期：2024年6月10日
+
+**CodeIgniter4 的 4.5.2 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+***************
+消息变更
+***************
+
+- 添加了 ``Security.insecureCookie`` 消息。
+
+**********
+修复的错误
+**********
+
+请查看仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取修复错误的完整列表。

source/changelogs/v4.5.3.rst

@@ -0,0 +1,19 @@
+#############
+版本 4.5.3
+#############
+
+发布日期：2024年6月25日
+
+**CodeIgniter4 的 4.5.3 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+**********
+修复的错误
+**********
+
+请查看仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取修复错误的完整列表。

source/cli/cli_request.rst

@@ -29,7 +29,7 @@ getOptions()
 
 .. literalinclude:: cli_request/003.php
 
-getOption($which)
+getOption($key)
 -----------------
 
 返回被视为选项的特定命令行参数的值:

source/concepts/autoloader.rst

@@ -45,7 +45,7 @@ CodeIgniter 提供了一个非常灵活的自动加载器，只需进行很少
 每行的键是命名空间本身。这个不需要尾部反斜杠。
 值是可以找到类的目录位置。
 
-默认情况下，命名空间 ``App`` 位于 **app** 目录中，命名空间 ``Config`` 位于 ``app/Config`` 目录中。
+默认情况下，命名空间 ``App`` 位于 **app** 目录中，命名空间 ``Config`` 位于 **app/Config** 目录中。
 
 如果你在这些位置根据 `PSR-4`_ 创建类文件，自动加载器将自动加载它们。
 
@@ -72,6 +72,8 @@ Config 命名空间
 
 配置文件位于 ``Config`` 命名空间中，而不是你可能预期的 ``App\Config`` 中。这使得核心系统文件即使在应用命名空间发生变化时也能始终找到它们。
 
+.. note:: 自 v4.5.3 appstarter 版本起，``Config\\`` 命名空间已被添加到 **composer.json** 的 ``autoload.psr-4`` 中。
+
 更改应用命名空间
 ----------------------
 

source/concepts/factories.rst

@@ -72,6 +72,8 @@
 .. literalinclude:: factories/013.php
    :lines: 2-
 
+.. _factories-passing-fully-qualified-classname:
+
 传递完全限定类名
 --------------------------------
 
@@ -229,6 +231,8 @@ setOptions 方法
 
 .. versionadded:: 4.4.0
 
+.. important:: 除非你已经仔细阅读了这一节并理解了这个功能是如何工作的，否则不要使用这个功能。否则，你的应用程序将无法正常工作。
+
 为了提高性能，实现了配置缓存。
 
 先决条件
@@ -242,6 +246,8 @@ setOptions 方法
 工作原理
 ============
 
+.. important:: 一旦缓存，配置值在缓存被删除之前永远不会改变，即使配置文件或 **.env** 发生了变化。
+
 - 如果 Factories 中的 Config 实例的状态发生变化，则在关闭之前将所有 Config 实例保存到缓存文件中。
 - 如果有缓存可用，则在 CodeIgniter 初始化之前恢复缓存的 Config 实例。
 

source/concepts/goals.rst

@@ -0,0 +1,15 @@
+##############################
+设计与架构目标
+##############################
+
+CodeIgniter 的目标是在最小化，最轻量级的开发包中得到最大的执行效率、功能和灵活性。
+
+为了达到这个目标，我们在开发过程的每一步都致力于基准测试、重构和简化工作，拒绝加入任何对实现目标没有帮助的东西。
+
+从技术和架构角度看，CodeIgniter 按照下列目标创建：
+
+-  **动态实例化。** 在 CodeIgniter 中，组件的导入和函数的执行都是在被请求的时候才执行，而不是全局的。除核心资源外，系统不需要任何其他资源，因此系统默认是非常轻量级的。HTTP 请求所触发的事件以及你设计的控制器和视图将决定哪些资源是需要加载的。
+-  **低耦合。** 耦合是指一个系统中组件之间的依赖程度。组件之间的依赖程度越低，系统的重用性和灵活性就越好。我们的目标就是打造一个低耦合的系统。
+-  **组件专一性。** 专一性指的是组件对某个目标的专注程度。在 CodeIgniter 中，每一个类和方法都是高度独立的，从而可以最大程度地被复用。
+
+CodeIgniter 是一个动态实例化，高度组件专一性的低耦合系统。它在小巧的基础上力求做到简单、灵活和高性能。

source/concepts/index.rst

@@ -14,3 +14,4 @@ CodeIgniter4 概览
     factories
     http
     security
+    goals

source/concepts/services.rst

@@ -16,16 +16,16 @@ CodeIgniter 4 中的 **服务** 提供了创建和共享新类实例的功能。
 
 CodeIgniter 的所有核心类都以“服务”提供。这仅仅意味着,不是硬编码一个类名进行加载,而是在一个非常简单的配置文件中定义要调用的类。这个文件充当工厂的角色,用来创建所需类的新实例。
 
-为什么使用服务?
+为什么使用服务？
 =================
 
-一个快速的示例可能会使事情更清楚,所以想象一下,你需要获取 Timer 类的一个实例。最简单的方法就是简单地创建该类的一个新实例:
+一个快速的例子可能会让事情更清晰，所以想象一下你需要引入一个 Timer 类的实例。最简单的方法可能就是直接创建这个类的一个新的实例：
 
 .. literalinclude:: services/001.php
 
-这工作得很好。直到你决定要使用另一个定时器类来替换它。也许这个定时器类具有默认定时器不提供的一些高级报告功能。为了做到这一点,你现在需要找到应用程序中使用了定时器类的所有位置。由于你可能已经将它们保留在那里以便持续运行性能日志,所以这可能是一个非常耗时且容易出错的处理方法。这就是服务派上用场的地方。
+这工作得很好。直到你决定用一个不同的计时器类来替代它。也许这个类有一些默认计时器不提供的高级报告功能。为了做到这一点，现在你必须找到你应用程序中使用计时器类的所有位置。由于你可能已经将它们保留下来，以持续运行应用程序的性能日志，这可能是一个耗时且容易出错的处理方式。这就是服务派上用场的地方。
 
-与其自己创建实例,不如让一个中心类为我们创建类的实例。这个类非常简单。它只包含每个我们希望用作服务的类的方法。该方法通常返回该类的一个共享实例,并将它可能具有的任何依赖项传递给它。然后,我们将用调用此新类的代码替换定时器创建代码:
+我们不是自己创建实例，而是让一个中心类为我们创建类的实例。这个类保持非常简单。它只包含我们想要作为服务使用的每个类的方法。该方法通常返回该类的 **共享实例**，并将任何它可能具有的依赖项传递给它。然后，我们将替换我们的计时器创建代码，使用调用这个全局函数或服务类的代码：
 
 .. literalinclude:: services/002.php
 
@@ -40,7 +40,7 @@ CodeIgniter 的所有核心类都以“服务”提供。这仅仅意味着,不
 
 .. literalinclude:: services/013.php
 
-``$typography`` 是一个 Typography 类的实例,如果你再次调用 ``\Config\Services::typography()``,你将会得到完全相同的实例。
+``$timer`` 是一个 Timer 类的实例，如果你再次调用 ``service('timer')``，你将会得到完全相同的实例。
 
 服务通常返回类的共享实例。下面的代码在首次调用时创建一个 ``CURLRequest`` 实例。第二次调用返回完全相同的实例。
 
@@ -51,7 +51,7 @@ CodeIgniter 的所有核心类都以“服务”提供。这仅仅意味着,不
 获取新实例
 ======================
 
-如果你想获取 Typography 类的新实例,需要向参数 ``$getShared`` 传递 ``false``:
+如果你想获取 Timer 类的新实例,需要向参数 ``$getShared`` 传递 ``false``:
 
 .. literalinclude:: services/014.php
 
@@ -67,6 +67,8 @@ service()
 
 .. literalinclude:: services/003.php
 
+.. note:: 自 v4.5.0 起，当你没有向服务传递参数时，推荐使用全局函数 ``service()``，因为性能有所提升。
+
 如果创建方法需要其他参数,可以在服务名称后传入:
 
 .. literalinclude:: services/004.php