CI框架实现创建自定义类库的方法


Posted in PHP onDecember 25, 2018

本文实例讲述了CI框架实现创建自定义类库的方法。分享给大家供大家参考,具体如下:

当我们使用 “类库” 这个词的时候,通常我们指的是位于 libraries 这个目录下的那些类。

接下来我们将介绍 如何在 application/libraries 目录下创建你自己的类库,和全局的框架类库独立开来。

另外,如果你希望在现有的类库中添加某些额外功能,CodeIgniter 允许你扩展原生的类, 或者你甚至可以在你的 application/libraries 目录下放置一个和原生的类库同名的文件 完全替代它。

总结起来:

  • 你可以创建一个全新的类库,
  • 你可以扩展原生的类库,
  • 你可以替换掉原生的类库。

注:除了数据库类不能被扩展或被你的类替换外,其他的类都可以。

存储位置

你的类库文件应该放置在 application/libraries 目录下,当你初始化类时,CodeIgniter 会在这个目录下寻找这些类。

命名约定

  • 文件名首字母必须大写,例如:Myclass.php
  • 类名定义首字母必须大写,例如:class Myclass
  • 类名和文件名必须一致

类文件

类应该定义成如下原型:

<?php
defined('BASEPATH') OR exit('No direct script access allowed');
class Someclass {
 public function some_method()
 {
 }
}

使用你的类

在你的 控制器 的任何方法中使用如下代码初始化你的类:

$this->load->library('someclass');

其中,someclass 为文件名,不包括 .php 文件扩展名。文件名可以写成首字母大写, 也可以写成全小写,CodeIgniter 都可以识别。

一旦加载,你就可以使用小写字母名称来访问你的类:

$this->someclass->some_method();

初始化类时传入参数

在加载类库的时候,你可以通过第二个参数动态的传递一个数组数据,该数组将被传到 你的类的构造函数中:

$params = array('type' => 'large', 'color' => 'red');
$this->load->library('someclass', $params);

如果你使用了该功能,你必须在定义类的构造函数时加上参数:

<?php defined('BASEPATH') OR exit('No direct script access allowed');
class Someclass {
 public function __construct($params)
 {
  // Do something with $params
 }
}

你也可以将参数保存在配置文件中来传递,只需简单的创建一个和类文件同名的配置文件, 并保存到你的 application/config/ 目录下。要注意的是,如果你使用了上面介绍的方法 动态的传递参数,配置文件将不可用。

在你的类库中使用 CodeIgniter 资源

在你的类库中使用 get_instance() 函数来访问 CodeIgniter 的原生资源,这个函数返回 CodeIgniter 超级对象

通常情况下,在你的控制器方法中你会使用 $this 来调用所有可用的 CodeIgniter 方法:

$this->load->helper('url');
$this->load->library('session');
$this->config->item('base_url');

但是 $this 只能在你的控制器、模型或视图中直接使用,如果你想在你自己的类中使用 CodeIgniter 类,你可以像下面这样做:

首先,将 CodeIgniter 对象赋值给一个变量:

$CI =& get_instance();

一旦你把 CodeIgniter 对象赋值给一个变量之后,你就可以使用这个变量来 代替 $this

$CI =& get_instance();

$CI->load->helper('url');
$CI->load->library('session');
$CI->config->item('base_url');

注:

上面的 get_instance() 函数通过引用来传递:

$CI =& get_instance();

这是非常重要的,引用赋值允许你使用原始的 CodeIgniter 对象,而不是创建一个副本。

既然类库是一个类,那么我们最好充分的使用 OOP 原则,所以,为了让类中的所有方法都能使用 CodeIgniter 超级对象,建议将其赋值给一个属性:

class Example_library {
 protected $CI;
 // We'll use a constructor, as you can't directly call a function
 // from a property definition.
 public function __construct()
 {
  // Assign the CodeIgniter super-object
  $this->CI =& get_instance();
 }
 public function foo()
 {
  $this->CI->load->helper('url');
  redirect();
 }
 public function bar()
 {
  echo $this->CI->config->item('base_url');
 }
}

使用你自己的类库替换原生类库

简单的将你的类文件名改为和原生的类库文件一致,CodeIgniter 就会使用它替换掉原生的类库。 要使用该功能,你必须将你的类库文件和类定义改成和原生的类库完全一样,例如, 要替换掉原生的 Email 类的话,你要新建一个 application/libraries/Email.php 文件, 然后定义定义你的类:

class CI_Email {
}

注意大多数原生类都以 CI_ 开头

要加载你的类库,和标准的方法一样:

$this->load->library('email');

注:

注意数据库类不能被你自己的类替换掉。

扩展原生类库

如果你只是想往现有的类库中添加一些功能,例如增加一两个方法, 这时替换整个类感觉就有点杀鸡用牛刀了。在这种情况下,最好的方法是 扩展类库。扩展一个类和替换一个类差不多,除了以下几点:

  • 类在定义时必须继承自父类。
  • 你的新类名和文件名必须以 MY_ 为前缀(这个可配置,见下文)

例如,要扩展原生的 Email 类你需要新建一个文件命名为 application/libraries/MY_Email.php , 然后定义你的类:

class MY_Email extends CI_Email {
}

如果你需要在你的类中使用构造函数,确保你调用了父类的构造函数:

class MY_Email extends CI_Email {
 public function __construct($config = array())
 {
  parent::__construct($config);
 }
}

注:

并不是所有的类库构造函数的参数都是一样的,在对类库扩展之前 先看看它是怎么实现的。

加载你的扩展类

要加载你的扩展类,还是使用和通常一样的语法。不用包含前缀。例如, 要加载上例中你扩展的 Email 类,你可以使用:

$this->load->library('email');

一旦加载,你还是和通常一样使用类变量来访问你扩展的类,以 email 类为例, 访问它的方法如下:

$this->email->some_method();

设置自定义前缀

要设置你自己的类的前缀,你可以打开 application/config/config.php 文件, 找到下面这项:

$config['subclass_prefix'] = 'MY_';

注:所有原始的 CodeIgniter 类库都以 CI_ 开头,所以请不要使用这个 作为你的自定义前缀。

希望本文所述对大家基于CodeIgniter框架的PHP程序设计有所帮助。

PHP 相关文章推荐
IIS+PHP+MySQL+Zend配置 (视频教程)
Dec 13 PHP
PHP 作用域解析运算符(::)
Jul 27 PHP
php中使用explode查找某个字符是否存在的方法
Jul 12 PHP
PHP下利用shell后台运行PHP脚本,并获取该脚本的Process ID的代码
Sep 19 PHP
php 计划任务 检测用户连接状态
Mar 29 PHP
thinkphp3.0 模板中函数的使用
Nov 13 PHP
PHP计算一年多少个星期和每周的开始和结束日期
Jul 01 PHP
linux下安装php的memcached客户端
Aug 03 PHP
php实现根据字符串生成对应数组的方法
Sep 22 PHP
PHP 读取文本文件内容并分页显示
Jan 02 PHP
php微信开发之百度天气预报
Nov 18 PHP
Yii2配置Nginx伪静态的方法
May 05 PHP
PHP中soap用法示例【SoapServer服务端与SoapClient客户端编写】
Dec 25 #PHP
PHP使用SOAP调用API操作示例
Dec 25 #PHP
详解PHP实现支付宝小程序用户授权的工具类
Dec 25 #PHP
PHP正则匹配到2个字符串之间的内容方法
Dec 24 #PHP
PHP基于PDO扩展操作mysql数据库示例
Dec 24 #PHP
PHP封装的page分页类定义与用法完整示例
Dec 24 #PHP
tp5(thinkPHP5)框架连接数据库的方法示例
Dec 24 #PHP
You might like
Zend Studio 无法启动的问题解决方法
2008/12/04 PHP
更改localhost为其他名字的方法
2014/02/10 PHP
使用CodeIgniter的类库做图片上传
2014/06/12 PHP
ThinkPHP安装和设置
2015/07/27 PHP
Laravel 框架基于自带的用户系统实现登录注册及错误处理功能分析
2020/04/14 PHP
JavaScript操作XML实例代码(获取新闻标题并分页,并分页)
2010/05/25 Javascript
使用Js让Html中特殊字符不被转义
2013/11/05 Javascript
Jquery仿IGoogle实现可拖动窗口示例代码
2014/08/22 Javascript
5个JavaScript经典面试题
2014/10/13 Javascript
jQuery调取jSon数据并展示的方法
2015/01/29 Javascript
jQuery 1.9.1源码分析系列(十)事件系统之主动触发事件和模拟冒泡处理
2015/11/24 Javascript
深入理解jQuery之事件移除
2016/06/02 Javascript
json对象转为字符串,当做参数传递时加密解密的实现方法
2016/06/29 Javascript
JavaScript中的splice方法用法详解
2016/07/20 Javascript
总结javascript中的六种迭代器
2016/08/16 Javascript
BootStrap Tooltip插件源码解析
2016/12/27 Javascript
jquery Easyui Datagrid实现批量操作(编辑,删除,添加)
2017/02/20 Javascript
微信小程序-滚动消息通知的实例代码
2017/08/03 Javascript
vue 指定组件缓存实例详解
2018/04/01 Javascript
vue动画之点击按钮往上渐渐显示出来的实例
2018/09/29 Javascript
VUEX采坑之路之获取不到$store的解决方法
2019/11/08 Javascript
Vue+Vuex实现自动登录的知识点详解
2020/03/04 Javascript
[01:01:22]VGJ.S vs OG 2018国际邀请赛淘汰赛BO3 第一场 8.22
2018/08/23 DOTA
Python 调用VC++的动态链接库(DLL)
2008/09/06 Python
Windows下实现Python2和Python3两个版共存的方法
2015/06/12 Python
Python字符串切片操作知识详解
2016/03/28 Python
Python2与python3中 for 循环语句基础与实例分析
2017/11/20 Python
python pyheatmap包绘制热力图
2018/11/09 Python
python 2.7 检测一个网页是否能正常访问的方法
2018/12/26 Python
对Python3 解析html的几种操作方式小结
2019/02/16 Python
Python基于opencv调用摄像头获取个人图片的实现方法
2019/02/21 Python
python爬虫利用selenium实现自动翻页爬取某鱼数据的思路详解
2020/12/22 Python
全球地下的服装和态度:Slam Jam
2018/02/04 全球购物
数以千计的折扣工业产品:ESE Direct
2018/05/20 全球购物
委托书如何写
2014/08/30 职场文书
Python借助with语句实现代码段只执行有限次
2022/03/23 Python