企业官网建设流程全解析

CodeIgniter 3.1.4 升级至 3.1.5 完整指南：操作步骤、变更解析与源码佐证

【免费下载链接】CodeIgniterOpen Source PHP Framework (originally from EllisLab)项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter

本文面向运行 CodeIgniter 3.1.4（及更早 3.1.x）的应用，系统讲解升级到 3.1.5 的标准流程、该版本引入的安全修复与功能变更，并对照当前仓库源码逐一验证其实现细节。读完本文，你将掌握可复现的升级步骤、可验证的变更清单，以及升级前后需要重点回归测试的模块。

升级前的准备工作：先让站点下线

根据 upgrade_315.rst 的官方指引，执行升级操作之前，第一步永远是让站点下线：用一份静态的 index.php 替换应用入口文件，避免升级过程中出现中间态代码被执行，造成用户访问异常或数据写入错乱。

这一做法在 CodeIgniter 的每个版本升级文档中都是强制前置步骤（可参见 upgrading.rst 中列出的全部升级笔记，以及相邻版本 upgrade_316.rst、upgrade_320.rst 的开头说明）。实操上，你可以准备一个只输出 "Maintenance" 提示的静态 HTML 页，在升级期间替换掉index.php，升级并验证完成后恢复原文件。

Step 1：替换 system/ 目录下的全部文件

升级的核心操作只有一步：将仓库（或官方发行包）中 3.1.5 的system/目录整体覆盖到你的项目。

# 假设你的项目根目录为 /path/to/app，将新版 system/ 覆盖过去 cp -R /path/to/codeigniter-3.1.5/system/* /path/to/app/system/

官方文档特别强调：如果这些目录中存在你自行开发或二次修改过的文件，请务必先做副本备份。在 CodeIgniter 3.x 中，system/下除了框架核心类，还有system/core/、system/database/、system/libraries/、system/helpers/、system/language/等会被开发者扩展的子目录，例如你自定义过system/core/Input.php或某个 helper，覆盖前要先把改动 diff 出来，再决定合并策略。

需要注意的边界：本次升级不需要改动application/目录（除非你同时迁移配置），因为 3.1.4 → 3.1.5 没有引入必须新增或重命名的配置项。若你从更早的版本（如 3.0.x）升级，则需另读 upgrade_310.rst 等对应版本笔记。

3.1.5 版本到底改了什么：基于 changelog 与源码的核对

upgrade_315.rst本身是精简的升级指引，3.1.5 的具体变更内容记录在 changelog.rst（Version 3.1.5一节，Release Date: Jun 19, 2017）。升级后建议对照以下清单做回归测试。

安全修复：valid_email 规则的绕过问题

3.1.5 最重要的一项修正是Form Validation 库的valid_email规则在启用idn_to_ascii()时可被绕过。查看当前仓库 Form_validation.php 的实现：

public function valid_email($str) { if (function_exists('idn_to_ascii') && preg_match('#\A([^@]+)@(.+)\z#', $str, $matches)) { $domain = defined('INTL_IDNA_VARIANT_UTS46') ? idn_to_ascii($matches[2], 0, INTL_IDNA_VARIANT_UTS46) : idn_to_ascii($matches[2]); if ($domain !== FALSE) { $str = $matches[1].'@'.$domain; } } return (bool) filter_var($str, FILTER_VALIDATE_EMAIL); }

可以看到，修复后的逻辑先通过正则拆出邮箱域名部分，再使用idn_to_ascii()（若可用）将国际化域名（IDN，如例え.jp）转成 ASCII 形式，最后才交给filter_var($str, FILTER_VALIDATE_EMAIL)做最终校验。因此：

• 如果你的服务器启用了 intl 扩展（idn_to_ascii()存在），3.1.5 之前的版本可能因未对 IDN 域名做转换而导致非法邮箱通过校验，升级后该问题被修复；
• 升级后建议对"邮箱格式校验"相关业务（注册、找回密码、订阅表单等）做一轮回归，确认合法邮箱（含国际化域名邮箱）仍能通过、非法邮箱仍被拒绝。

功能变更：form_label() 支持字符串形式 HTML 属性

3.1.5 还更新了 Form Helper 的form_label()函数，使其接受字符串形式的 HTML 属性。当前实现见 form_helper.php：

function form_label($label_text = '', $id = '', $attributes = array()) { $label = '<label'; if ($id !== '') { $label .= ' for="'.$id.'"'; } $label .= _attributes_to_string($attributes); return $label.'>'.$label_text.'</label>'; }

_attributes_to_string()是 Form Helper 内部的公共属性拼接函数，它同时兼容数组与字符串两种输入。也就是说，升级后你既可以这样调用：

// 数组形式（原有写法，兼容） echo form_label('用户名', 'username', array('class' => 'form-label')); // 字符串形式（3.1.5 新增支持的写法） echo form_label('用户名', 'username', 'class="form-label"');

这属于向后兼容的增强，正常情况下不会破坏既有代码，但若你的应用曾传入不合法的第三参数，升级后可留意输出 HTML 是否正常。

3.1.5 的 Bug 修复清单

根据 changelog.rst，3.1.5 还修复了以下问题，升级后应针对对应模块做重点回归：

其中 #5131 与 #5155 是业务影响面最广的两项：私有方法路由回归直接关系控制器访问控制，count_all_results()的计数准确性则影响分页、统计类功能。如果你的应用使用了 Oracle（oci8）数据库，还需要验证modify_column()相关迁移脚本。

升级后的验证与回归建议

1. 版本号确认：升级后可在入口文件或框架核心确认版本。当前仓库 CodeIgniter.php 中CI_VERSION常量为'3.2.0-dev'（即 3.2 开发线），3.1.5 正式版的对应常量为'3.1.5'。也可在应用代码中执行echo CI_VERSION;快速验证。
2. 功能回归优先级：表单校验（尤其valid_email）→ 分页与统计（count_all_results()）→ 邮件发送（7-bit 编码检测）→ 控制器私有方法 404 行为 → Oracle 相关建表/改表脚本。
3. 后续升级路线：3.1.5 之后可继续按官方顺序升级至 3.1.6（APC 缓存驱动弃用，见 upgrade_316.rst）、3.1.7 等，再进入 3.2.x（涉及CI_Model::__construct()移除、数据库连接异常化、Email 校验默认开启、doctype()默认值改为 html5 等十余项不兼容变更，详见 upgrade_320.rst）。逐版本阅读对应升级笔记是最稳妥的路径，完整的升级笔记索引在 upgrading.rst。

小结

CodeIgniter 3.1.4 → 3.1.5 是一次典型的补丁级升级：官方升级文档本身极为精简——离线站点、整体替换system/目录、备份自定义文件即可完成升级；但版本背后包含 1 项安全修复（valid_email的 IDN 绕过）、1 项功能增强（form_label()支持字符串属性）和 6 项 Bug 修复。升级动作虽小，回归测试的覆盖面却应以上述清单为准，这样才能在最小改动下获得最完整的安全与稳定性收益。

【免费下载链接】CodeIgniterOpen Source PHP Framework (originally from EllisLab)项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter