所有的类库文件存放在system/libraries 文件夹。大多数情况下你需要预先在controller中初始化后才能使用它们:
$this->load->library('class name');
class name是你想要使用的类名。例如,要载入“表单验证类”,你可以这样做:
$this->load->library('form_validation');
建立你的类库文件
你的类库文件必须保存在 application/libraries 文件夹,CodeIgniter将在这个文件夹中寻找并初始化它们。
命名约定
文件名首字母大写。例如: Myclass.php
类声明首字母大写。例如: class Myclass
类的名字和文件名应相同。
所有的类应有基础原型
<?php if (!defined('BASEPATH')) exit('No direct script access allowed'); class Someclass { public function some_function() { } } /* End of file Someclass.php */
$this->load->library('someclass');
当 someclass 是文件名时,不用加上".php"扩展名.这里名字不分大小写.
一旦你自定义的类加载完毕,你可以通过以下方式调用类,注意使用 小写 的名字:
$this->someclass->some_function(); // 对象的实例名永远都是小写的
$params = array('type' => 'large', 'color' => 'red'); $this->load->library('Someclass', $params);
<?php if (!defined('BASEPATH')) exit('No direct script access allowed'); class Someclass { public function __construct($params) { // Do something with $params } } ?>
要在你自定义的类库中访问CodeIgniter的原始资源,你必须使用 get_instance() 函数。一般来说在你的控制器函数中你可以通过 $this 调用任何可用的CodeIgniter函数:
$this->load->helper('url'); $this->load->library('session'); $this->config->item('base_url');
当你在自定义类中想使用CodeIgniter原始类时,你可以这样做:
首先,定义CodeIgniter对象赋给一个变量:
$CI =& get_instance();
一旦定义某个对象为一个变量,你就可以使用那个变量名取代 $this:
$CI =& get_instance(); $CI->load->helper('url'); $CI->load->library('session'); $CI->config->item('base_url');
替换原始类
简单的将你自己的类命名为与原始类一样就能使CodeIgniter使用这个新类.要使用这个特性,文件名与类声明必须与原始类完全一致。例如,要替换原始的 Email 类库。你必须创建一个文件application/libraries/Email.php, 并按如下方式声明类:
class CI_Email
{
}
扩展现有类
如果你需要在现有类库中加入一两个新的功能,那就完全不必要替换整个类库文件.你只需简单地扩展(继承)现有的类,扩展一个类就像在类中增加一些例外:
扩展的类必须申明由父类扩展而来。
新扩展的类所在的文件必须以 MY_ 为前缀(这个选项是可配置的)。
例如,要扩展原始类Email类你要建立文件application/libraries/MY_Email.php,并按如下方式在文件中声明:
class MY_Email extends CI_Email { }
要载入扩展子类,你应该使用标准字符名,请不要使用前缀,例如,要载入上文说过的email扩展子类,你应该这样写:
$this->load->library('email');