升级到 v4.5.7 (#168)

* 升级到 v4.5.7

* update

Author: hex-ci

source/changelogs/index.rst

@@ -12,6 +12,8 @@
 .. toctree::
     :titlesonly:
 
+    v4.5.7
+    v4.5.6
     v4.5.5
     v4.5.4
     v4.5.3

source/changelogs/v4.5.6.rst

@@ -0,0 +1,33 @@
+#############
+版本 4.5.6
+#############
+
+发布日期：2024 年 12 月 28 日
+
+**CodeIgniter4 的 4.5.6 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+************
+已修复的 Bug
+************
+
+- **RequestTrait:** 修复了 ``fetchGlobal()`` 方法在处理以列表形式存储的数据时，无法通过数字键处理数据的 bug。
+- **Session 类库:** 会话初始化的调试消息现在使用正确的日志类型 "debug" 而不是 "info"。
+- **验证:** 修复了 ``getValidated()`` 方法在使用多个星号的验证规则时未返回有效数据的 bug。
+- **数据库:** 修复了 ``like()`` 方法在处理带重音字符时的大小写不敏感选项。
+- **解析器:** 修复了导致相同键名被第一个定义的键名替换的 bug。
+- **DownloadResponse:** 修复了无法设置自定义缓存头的 bug。现在也可以使用 ``setCache()`` 方法。
+- **DownloadResponse:** 修复了涉及发送自定义 "Expires-Disposition" 头的 bug。
+- **路由:** 修复了当 `Routing::$translateURIDashes` 设置为 `true` 并且使用闭包定义路由时，`str_replace()` 中的 TypeError。
+- **验证:** 修复了复杂语言字符串未正确处理的问题。
+- **CURLRequest:** 添加了对使用非 1.1 版本的 HTTP 处理代理响应的支持。
+- **数据库:** 修复了 ``Postgre\Connection::reconnect()`` 方法在连接尚未建立时抛出错误的 bug。
+- **模型:** 修复了 ``Model::getIdValue()`` 方法在使用主键的数据映射时，无法正确识别 ``Entity`` 对象中主键的 bug。
+- **数据库:** 修复了预处理语句中的一个错误，以正确处理二进制数据。
+
+查看仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取完整的已修复 bug 列表。

source/changelogs/v4.5.7.rst

@@ -0,0 +1,22 @@
+#############
+版本 4.5.7
+#############
+
+发布日期：2024 年 12 月 31 日
+
+**CodeIgniter4 的 4.5.7 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+************
+已修复的 Bug
+************
+
+- **Common:** 修复了 ``helper()`` 方法在有效的命名空间 helper 上可能抛出 `FileNotFoundException` 的 bug。
+- **Forge:** 修复了 `SQLite3` 的 Forge 在调用 ``dropColumn()`` 时总是返回 `false` 的问题。
+
+查看仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取完整的已修复 bug 列表。

source/concepts/factories.rst

@@ -280,14 +280,14 @@ setOptions 方法
 
     public bool $configCacheEnabled = true;
 
-自 v4.5.0 起，你可以使用 ``spark optimize`` 命令来启用此功能。
+或者你可以使用 ``spark optimize`` 命令来启用此功能。
 
 .. note::
     此属性无法通过
     :ref:`环境变量 <configuration-classes-and-environment-variables>` 重写。
 
 .. note::
-    在 v4.5.0 之前，请在 **public/index.php** 中取消以下代码的注释::
+    在 v4.4.x 中，请在 **public/index.php** 中取消以下代码的注释::
 
         --- a/public/index.php
         +++ b/public/index.php

source/conf.py

@@ -26,7 +26,7 @@
 version = '4.5'
 
 # The full version, including alpha/beta/rc tags.
-release = '4.5.5'
+release = '4.5.7'
 
 # -- General configuration ---------------------------------------------------
 

source/database/queries.rst

@@ -189,6 +189,8 @@ $db->error()
 
 .. literalinclude:: queries/018.php
 
+.. note:: 目前，唯一实际使用选项数组的数据库是 SQLSRV。
+
 执行查询
 ===================
 

source/database/queries/016.php

@@ -1,9 +1,7 @@
 <?php
 
-$pQuery = $db->prepare(static function ($db) {
-    return $db->table('user')->insert([
-        'name'    => 'x',
-        'email'   => 'y',
-        'country' => 'US',
-    ]);
-});
+$pQuery = $db->prepare(static fn ($db) => $db->table('user')->insert([
+    'name'    => 'x',
+    'email'   => 'y',
+    'country' => 'US',
+]));

source/database/queries/019.php

@@ -1,13 +1,11 @@
 <?php
 
 // Prepare the Query
-$pQuery = $db->prepare(static function ($db) {
-    return $db->table('user')->insert([
-        'name'    => 'x',
-        'email'   => 'y',
-        'country' => 'US',
-    ]);
-});
+$pQuery = $db->prepare(static fn ($db) => $db->table('user')->insert([
+    'name'    => 'x',
+    'email'   => 'y',
+    'country' => 'US',
+]));
 
 // Collect the Data
 $name    = 'John Doe';

source/dbmgmt/migration.rst

@@ -14,14 +14,22 @@
 迁移文件命名
 ********************
 
-每个迁移会按照创建时的数字顺序正向或反向运行,具体取决于采取的方法。每个迁移使用创建时的时间戳命名,格式为 **YYYY-MM-DD-HHIISS** (例如 **2012-10-31-100537**)。这有助于在团队环境下避免编号冲突。
+迁移文件名由时间戳前缀、下划线（``_``）和描述性名称（类名）组成。
 
-为你的迁移文件添加迁移编号前缀,后跟下划线和对迁移的描述性名称。年、月、日可以用破折号、下划线或不加分隔符的方式分割。例如:
+* 2024-09-08-013653_AddBlogTable.php
+
+每个迁移都使用创建迁移时的时间戳（**2024-09-08-013653**）进行编号，格式为 **YYYY-MM-DD-HHIISS**。
+
+迁移的描述性名称（**AddBlogTable**）是 PHP 中的类名，因此你必须为其命名一个有效的类名。
+
+前缀中的年、月、日和时间的分隔符可以是短横线（``-``）、下划线（``_``）或者不使用任何分隔符。例如：
 
 * 2012-10-31-100538_AlterBlogTrackViews.php
 * 2012_10_31_100539_AlterBlogAddTranslations.php
 * 20121031100537_AddBlog.php
 
+每个迁移根据所采取的方法按数字顺序向前或向后运行。这有助于在团队协作环境中避免编号冲突。
+
 ******************
 创建迁移
 ******************
@@ -32,7 +40,7 @@
 
 数据库连接和数据库 Forge 类都可以通过 ``$this->db`` 和 ``$this->forge`` 获取。
 
-或者,你可以使用命令行调用来生成骨架迁移文件。更多细节请参阅 :ref:`command-line-tools` 中的 **make:migration**。
+或者，你可以使用命令行调用来生成一个骨架迁移文件。更多详情请参阅 :ref:`command-line-tools` 中的 `make:migration`_。
 
 .. note:: 由于迁移类是一个 PHP 类,每个迁移文件中的类名必须是唯一的。
 

source/general/ajax.rst

@@ -56,7 +56,7 @@ React
 htmx
 ====
 
-你可以使用 ajax-header 扩展。
+你可以使用 `ajax-header <https://github.com/bigskysoftware/htmx-extensions/blob/main/src/ajax-header/README.md>`_ 扩展。
 
 .. code-block:: html