CodeIgniter加载Library无返回，改用Model正常的原因及正确加载方式

数据老陈

2026-5-14

为什么CodeIgniter中加载Library无效但Model有效？如何正确用Library获取数据？

一、问题根源：Library和Model的加载规则&类结构差异

你遇到的问题核心在于CodeIgniter对Library和Model的命名规范、加载参数逻辑、类定义要求完全不同，而你之前的Library加载方式踩了几个关键坑：

加载参数的含义完全不同
- 对于Model：$CI->load->model('folder/MenuList','menu');里的第二个参数'menu'是实例别名，加载后可以直接用$CI->menu访问这个Model实例。
- 对于Library：$CI->load->library('MenuList','menu');里的第二个参数'menu'是传递给Library类构造函数的参数，而非别名！默认情况下，Library加载后的实例名是小写的类名（也就是$CI->menulist），你之前用$CI->menu调用方法，自然找不到对应实例，所以没有返回结果。
类结构的要求不同
- Model必须继承CI_Model，CodeIgniter会自动为Model初始化数据库连接等核心资源，你的MenuList是按照Model的规范编写的（比如继承了CI_Model、依赖Model的自动资源加载），所以加载Model能正常工作。
- Library不需要继承任何基类（CodeIgniter 3中），它是通用类库，需要手动获取CI实例才能使用框架资源（比如数据库），如果你的MenuList没有按照Library的逻辑调整，即使加载路径正确也可能无法运行。

二、正确加载Library获取数据的步骤

要让Library正常工作，需要调整两个部分：Library文件的类定义和加载调用的代码。

1. 编写符合规范的Library文件

把MenuList类放到application/libraries/MenuList.php（如果是子目录，比如application/libraries/folder/MenuList.php，加载路径要对应），类定义示例如下：

<?php
class MenuList {
    // 保存CI实例，方便调用框架资源
    private $CI;

    // 构造函数：可选，如果需要用到CI的功能（比如数据库），在这里获取实例
    public function __construct() {
        $this->CI =& get_instance();
        // 如果需要数据库连接，手动加载（全局没开启的话）
        // $this->CI->load->database();
    }

    // 菜单查询方法，逻辑可以和之前Model里的保持一致
    public function selectMenu($role) {
        // 示例：从数据库查询对应角色的菜单
        $query = $this->CI->db->get_where('menus', ['role' => $role]);
        return $query->result_array(); // 或者你需要的返回格式
    }
}

2. 正确加载并调用Library

有两种加载方式，可根据你的习惯选择：

方式一：使用默认实例名（小写类名）

<?php
$CI =& get_instance();
// 加载Library，不需要构造参数的话第二个参数可以传NULL或省略
$CI->load->library('MenuList');
// 用小写类名调用方法
$menu = $CI->menulist->selectMenu('admin');
print_r($menu);

方式二：指定自定义别名（和使用Model时的习惯一致）

如果想继续用$CI->menu作为实例名，需要用Library加载的第三个参数指定别名：

<?php
$CI =& get_instance();
// 第三个参数是别名，第二个参数是构造函数参数（不需要就传NULL）
$CI->load->library('MenuList', NULL, 'menu');
// 用别名调用方法
$menu = $CI->menu->selectMenu('admin');
print_r($menu);

三、关键注意点总结

命名规范：Library的文件名和类名必须首字母大写（比如MenuList.php对应class MenuList），否则框架无法正确识别加载。
参数区别：Library的第二个参数是构造参数，别名在第三个；Model的第二个参数直接是别名。
资源获取：Library需要手动通过get_instance()获取CI实例，才能使用数据库、加载其他资源等框架功能，而Model会自动继承这些能力。

内容的提问来源于stack exchange，提问作者guradio