升级到 v4.6.1 (#170)

Author: hex-ci

.kilocodemodes

@@ -0,0 +1,52 @@
+customModes:
+  - slug: ci-translator
+    name: CI 文档翻译
+    description: CI 文档翻译
+    roleDefinition: |-
+      # 角色
+
+      你是一位资深计算机技术文档翻译专家，尤其精通英文 PHP 框架 CodeIgniter 用户手册到简体中文的精准翻译。你以严谨细致的专业精神著称，追求译文在语言和格式上均完美匹配原文，最终交付最高质量的技术文档。
+
+      ## 专业技能
+
+      ### 技能 1：卓越的英中技术翻译能力
+
+      - 英文人称代词 “you”、“your” 务必对应翻译为中文 “你”、“你的”，保持技术文档的直接性和专业性，禁用敬语 “您”。
+      - 熟练应用中英文排版规范，中文与英文、中文与数字间自觉添加半角空格，除需保持原文的内容以外，标点符号使用全角标点符号，优化文档可读性。
+      - 具备出色的上下文理解力，从全文把握技术概念和语境，确保译文在术语和逻辑上高度准确且一致。
+      - 保持原文段落结构。
+      - 杜绝任何原文内容遗漏。
+
+      ### 技能 2：精确还原 ReStructuredText 源文件格式
+
+      - 对格式高度敏感，精确识别并完整保留 ReStructuredText 格式，严禁任何形式的修改或调整。
+      - 精通 ReStructuredText 标记语言，熟练运用其规范进行翻译，确保文档结构与原文完全一致。
+        - **务必** 原样保留 ReStructuredText 指令，如 “.. note::”、“.. warning::”、“.. important::”、“.. literalinclude::”、“.. contents::”、“.. versionadded::”，包括原始大小写和拼写，**禁止翻译或改动**。
+        - **特别注意** 保留段落结尾的双冒号 (::) 和句首连续空格，它们是 ReStructuredText 语法组成部分，并非错误。
+      - 不得增删任何格式符号或指令。
+      - 保留原文换行。
+
+      ### 技能 3：精准处理技术术语与代码
+
+      - 严格遵守既定术语规范。 存在明确中文约定的术语直接采用；无约定术语，依据行业惯例和上下文专业判断翻译，不可生搬硬造。
+      - 代码与文本内容界限清晰。 代码块、代码示例、类名、函数名、变量名等代码元素 **一律不可翻译**，必须完整保留英文原文。
+      - 提及 CodeIgniter 框架 Session 类库时，**始终使用英文原文 “Session”**，确保术语统一性和专业性。
+      - helper 原则上翻译成辅助函数
+
+      ### 技能 4：精湛的译文审校与优化能力
+
+      - 从中文技术文档读者角度审视译文，充分考虑中文阅读习惯和理解方式，确保语句流畅自然、逻辑清晰易懂，避免任何生硬、晦涩或机器翻译痕迹。
+      - 在绝对忠于原文和不丢失格式等内容的前提下，允许并鼓励采用更符合中文表达习惯的方式进行翻译，提升文档学习效率和用户体验，最终有效传递技术知识。
+
+      ## 严格约束
+
+      - 坚守最高翻译质量标准，严格执行所有上述规范。
+      - 鉴于文档技术深度，你 **必须** 扎实掌握计算机科学领域及 PHP 框架 CodeIgniter 的基础知识和深入理解，熟悉核心概念、技术原理和常用术语，这是保证译文质量的根本前提。
+      - 不能编造原文不存在的内容，也不能丢失任何知识点。
+    groups:
+      - read
+      - edit
+      - browser
+      - command
+      - mcp
+    source: project

source/changelogs/index.rst

@@ -12,6 +12,7 @@
 .. toctree::
     :titlesonly:
 
+    v4.6.1
     v4.6.0
     v4.5.8
     v4.5.7

source/changelogs/v4.6.1.rst

@@ -0,0 +1,42 @@
+#############
+版本 4.6.1
+#############
+
+发布日期: 2025 年 5 月 2 日
+
+**CodeIgniter4 的 4.6.1 版本发布**
+
+.. contents::
+    :local:
+    :depth: 3
+
+********
+变更内容
+********
+- **Mimes**: 在 ``Config\Mimes`` 类中为 ``stl`` 扩展名添加了 ``model/stl`` 和 ``application/octet-stream`` MIME 类型。
+
+************
+废弃功能
+************
+
+- **Cache:** ``FileHandler::writeFile()`` 方法已被废弃。请使用 ``write_file()`` 代替。
+- **Cache:** ``FileHandler::deleteFiles()`` 方法已被废弃。请使用 ``delete_files()`` 代替。
+- **Cache:** ``FileHandler::getDirFileInfo()`` 方法已被废弃。请使用 ``get_dir_file_info()`` 代替。
+- **Cache:** ``FileHandler::getFileInfo()`` 方法已被废弃。请使用 ``get_file_info()`` 代替。
+
+**********
+错误修复
+**********
+
+- **CURLRequest:** 修复了在目标服务器进行多次重定向时，CURL 响应体中出现多个头部部分的问题。
+- **Cors:** 修复了 Cors 过滤器中的一个错误，该错误导致当另一个过滤器在 ``before`` 过滤器中返回响应对象时，未添加适当的头部。
+- **Database:** 修复了 ``Postgre`` 和 ``SQLite3`` 处理程序中的一个错误，其中复合唯一键在 ``upsert`` 类型查询中未被完全考虑。
+- **Database:** 修复了 ``OCI8`` 和 ``SQLSRV`` 驱动程序中的一个错误，其中 ``getVersion()`` 在数据库连接尚未建立时返回空字符串。
+- **Logger:** 修复了在记录消息时，``{line}`` 变量无法在不指定 ``{file}`` 变量的情况下使用的错误。
+- **Session:** 修复了当向 ``Session::setTempdata()`` 提供数组数据时，``Session::markAsTempdata()`` 会给出错误 TTL 的错误。
+- **Toolbar:** 修复了将 ``maxHistory`` 设置为 ``0`` 会在调试工具栏中产生 JavaScript 错误的问题。
+- **Toolbar:** 修复了将 ``maxHistory`` 设置为 ``0`` 会阻止日志文件被正确清除的问题。
+
+请查看仓库的
+`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
+以获取完整的错误修复列表。

source/conf.py

@@ -26,7 +26,7 @@
 version = '4.6'
 
 # The full version, including alpha/beta/rc tags.
-release = '4.6.0'
+release = '4.6.1'
 
 # -- General configuration ---------------------------------------------------
 

source/database/query_builder.rst

@@ -813,6 +813,8 @@ $builder->upsert()
 
 .. literalinclude:: query_builder/112.php
 
+.. note:: 对于非 MySQL 的数据库，如果一个表包含多个键（主键或唯一键），在处理约束时默认会优先使用主键。如果你希望使用其他唯一键而非主键，请使用 ``onConstraint()`` 方法。
+
 第一个参数是值的关联数组。
 
 以下是使用对象的示例：

source/database/results.rst

@@ -250,9 +250,9 @@ dataSeek()
 
         用法:参见 `获取 stdClass 的数组`_ 。
 
-    .. php:method:: getCustomResultObject($class_name)
+    .. php:method:: getCustomResultObject($className)
 
-        :param    string    $class_name: 结果集的类名
+        :param    string    $className: 结果集的类名
         :returns:    包含提取行的数组
         :rtype:    array
 

source/dbmgmt/forge.rst

@@ -442,10 +442,10 @@ $forge->modifyColumn()
 
         创建新表。用法:参见 `创建表格`_。
 
-    .. php:method:: dropColumn($table, $column_name)
+    .. php:method:: dropColumn($table, $columnNames)
 
         :param    string    $table: 表名
-        :param    mixed    $column_names: 逗号分隔的字符串或列名称数组
+        :param    mixed    $columnNames: 逗号分隔的字符串或列名称数组
         :returns:    成功则为 true,失败则为 false
         :rtype:    bool
 
@@ -511,10 +511,10 @@ $forge->modifyColumn()
 
         修改表列。用法:参见 `修改表中的字段`_。
 
-    .. php:method:: renameTable($table_name, $new_table_name)
+    .. php:method:: renameTable($tableName, $newTableName)
 
-        :param    string    $table: 表的当前名称
-        :param    string    $new_table_name: 表的新名称
+        :param    string    $tableName: 表的当前名称
+        :param    string    $newTableName: 表的新名称
         :returns:   成功则为查询对象,失败则为 false
         :rtype:    mixed
 

source/general/common_functions.rst

@@ -265,9 +265,9 @@ CodeIgniter 提供了一些全局定义的函数和变量,在任何时候都可
 
     .. note:: 当你将 ``Config\App:$forceGlobalSecureRequests`` 设置为 true 时，也会使用此函数。
 
-.. php:function:: function_usable($function_name)
+.. php:function:: function_usable($functionName)
 
-    :param string $function_name: 要检查的函数
+    :param string $functionName: 要检查的函数
     :returns: 如果函数存在且可安全调用则为 true,否则为 false
     :rtype: bool
 

source/incoming/routing.rst

@@ -429,6 +429,10 @@ HTTP 方法路由
 
 这样做还有一个额外的好处，就是让视图更具可读性。
 
+.. note:: 默认情况下，所有定义的路由都有与其路径匹配的名称，其中占位符被相应的正则表达式替换。例如，如果你定义一个路由如 ``$routes->get('edit/(:num)', 'PostController::edit/$1');``，你可以使用 ``route_to('edit/([0-9]+)', 12)`` 生成相应的 URL。
+
+.. warning:: 根据 :ref:`routing-priority`，如果首先定义了一个未命名的路由 (例如 ``$routes->get('edit', 'PostController::edit');``），然后定义了另一个命名路由，其名称与第一个路由的路径相同 (例如 ``$routes->get('edit/(:num)', 'PostController::edit/$1', ['as' => 'edit']);``），第二个路由将不会被注册，因为它的名称会与第一个路由的自动分配名称冲突。
+
 分组路由
 ***************
 
@@ -849,3 +853,12 @@ CodeIgniter 4 提供了一种简单的方法来使用 ``Router`` 类访问当前
 
 .. note:: ``getFilters()`` 方法仅返回为特定路由定义的过滤器。
      它不包括全局过滤器或在 **app/Config/Filters.php** 文件中指定的过滤器。
+
+获取当前路由的匹配路由选项
+===================================================
+
+当我们定义路由时，它们可能具有可选参数：``filter``、``namespace``、``hostname``、``subdomain``、``offset``、``priority``、``as``。所有这些参数都已在上面详细描述过。
+另外，如果我们使用 ``addRedirect()``，我们还可以期待 ``redirect`` 键。
+要访问这些参数的值，我们可以调用 ``Router::getMatchedRouteOptions()``。以下是返回数组的示例：
+
+.. literalinclude:: routing/074.php

source/incoming/routing/074.php

@@ -0,0 +1,23 @@
+<?php
+
+// Get the router instance.
+/** @var \CodeIgniter\Router\Router $router */
+$router  = service('router');
+$options = $router->getMatchedRouteOptions();
+
+echo 'Route name: ' . $options['as'];
+
+print_r($options);
+
+// Route name: api:auth
+//
+// Array
+// (
+//     [filter] => api-auth
+//     [namespace] => App\API\v1
+//     [hostname] => example.com
+//     [subdomain] => api
+//     [offset] => 1
+//     [priority] => 1
+//     [as] => api:auth
+// )