CodeIgniter文档以“配置简单，全部用PHP脚本写”为起点，直击初学者痛点，通过直白示例、详尽参数说明和结构约束（如控制器继承CI_Controller）降低门槛；但REST开发、多库事务、事件机制等薄弱处暴露框架能力边界，且关键细节（如XSS默认不过滤、SQL调试需手动开启）常被省略，实为框架设计决策的隐性信号。
想快速上手一个PHP框架却卡在看不懂文档上？CodeIgniter的文档不是“有就行”，而是直接影响你能否绕过陷阱、避开重复造轮子、甚至决定项目能不能按时上线——它的文档质量与框架本身的优缺点深度咬合，不是并列关系，而是因果链条。
为什么CodeIgniter文档能降低初学者门槛
打开CodeIgniter官方中文文档首页，第一眼看到的是“配置简单，全部用PHP脚本写”——这句话不是宣传语，是真实操作路径的起点。它直接对应框架“无硬性编码规则”的设计哲学，意味着你不需要先搞懂Composer自动加载、服务容器绑定、契约接口这些概念就能写出第一个控制器。
文档里所有示例都默认使用APPPATH.'controllers/'路径下的类文件，且控制器必须继承CI_Controller；【不按这个结构命名或继承，路由直接404，且错误提示极简，只显示“Unable to load the requested file”】。这种“约定优于配置”的写法被文档用最直白的代码块反复强化，比如“Hello World”示例里连index.php入口文件的ENVIRONMENT常量设置都截图标注。
所有辅助函数（如form_open()、anchor()）都配了参数说明表和调用前后HTML对比，连引号要不要加、数组键名是否区分大小写都标得清清楚楚。这和Laravel文档里动辄跳转到“Service Container”或“Macroable Trait”的嵌套式指引形成鲜明反差。
文档薄弱处恰恰暴露框架能力边界
方法一：查“RESTful API开发”，官方文档只在3.x版本末尾新增了一页《REST Server Library》，但没讲清如何配合路由规则处理PUT/PATCH请求体解析，也没提CSRF token在AJAX PUT请求中怎么携带。
方法二：搜“多数据库连接切换”，文档只给出database.php配置多组$active_group，但没说明事务跨库时如何手动控制commit/rollback，更没提读写分离场景下如何动态指定主从连接。
方法三：找“事件监听机制”，文档压根没有“Event”关键词索引——因为CodeIgniter 3.x原生不支持事件系统，所有钩子（Hook）只能在固定节点（pre_system、post_controller等）触发，无法像Laravel那样自由注册监听器。你翻遍整站搜索，只会得到一句：“可使用第三方库如ci-events实现”。
文档里的“省略”其实是关键决策信号
第一步：打开《数据库类》章节，通篇没提Query Builder生成的SQL如何调试。你得自己在config/database.php里把'save_queries' => TRUE打开，再用$this->db->last_query()手动打印——文档不教，但框架留了口子。
第二步：翻到《安全指南》，发现“XSS过滤”只讲set_cookie()自动转义，却对$_POST数据是否默认过滤只字未提。实际运行时你会发现：CodeIgniter默认【不对$_POST原始数据做任何过滤】，必须显式调用$xss_clean或配置global_xss_filter = TRUE（该配置已在3.1.11后废弃）。这个沉默的默认值，让很多开发者在表单提交环节直接栽进安全漏洞。
第三步：进入《类库扩展》页，文档教你如何写MY_前缀的自定义类，但没警告你：若在system/libraries/目录下直接修改核心类（比如Email.php），升级框架时会被覆盖。真正可靠的扩展路径只有application/libraries/MY_Email.php——这个路径约束，文档用小字号写在段落末尾，却决定了你后续维护成本。
