CI框架實(shí)現(xiàn)創(chuàng)建自定義類庫(kù)的方法

本文實(shí)例講述了CI框架實(shí)現(xiàn)創(chuàng)建自定義類庫(kù)的方法。分享給大家供大家參考，具體如下：

當(dāng)我們使用 “類庫(kù)” 這個(gè)詞的時(shí)候，通常我們指的是位于 libraries 這個(gè)目錄下的那些類。

接下來(lái)我們將介紹 如何在 application/libraries 目錄下創(chuàng)建你自己的類庫(kù)，和全局的框架類庫(kù)獨(dú)立開來(lái)。

另外，如果你希望在現(xiàn)有的類庫(kù)中添加某些額外功能，CodeIgniter 允許你擴(kuò)展原生的類， 或者你甚至可以在你的 application/libraries 目錄下放置一個(gè)和原生的類庫(kù)同名的文件 完全替代它。

總結(jié)起來(lái)：

• 你可以創(chuàng)建一個(gè)全新的類庫(kù)，
• 你可以擴(kuò)展原生的類庫(kù)，
• 你可以替換掉原生的類庫(kù)。

注：除了數(shù)據(jù)庫(kù)類不能被擴(kuò)展或被你的類替換外，其他的類都可以。

存儲(chǔ)位置

你的類庫(kù)文件應(yīng)該放置在 application/libraries 目錄下，當(dāng)你初始化類時(shí)，CodeIgniter 會(huì)在這個(gè)目錄下尋找這些類。

命名約定

• 文件名首字母必須大寫，例如：Myclass.php
• 類名定義首字母必須大寫，例如：class Myclass
• 類名和文件名必須一致

類文件

類應(yīng)該定義成如下原型:

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

使用你的類

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

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

其中，someclass 為文件名，不包括 .php 文件擴(kuò)展名。文件名可以寫成首字母大寫， 也可以寫成全小寫，CodeIgniter 都可以識(shí)別。

一旦加載，你就可以使用小寫字母名稱來(lái)訪問你的類:

$this->someclass->some_method();

初始化類時(shí)傳入?yún)?shù)

在加載類庫(kù)的時(shí)候，你可以通過第二個(gè)參數(shù)動(dòng)態(tài)的傳遞一個(gè)數(shù)組數(shù)據(jù)，該數(shù)組將被傳到 你的類的構(gòu)造函數(shù)中:

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

如果你使用了該功能，你必須在定義類的構(gòu)造函數(shù)時(shí)加上參數(shù):

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

你也可以將參數(shù)保存在配置文件中來(lái)傳遞，只需簡(jiǎn)單的創(chuàng)建一個(gè)和類文件同名的配置文件， 并保存到你的 application/config/ 目錄下。要注意的是，如果你使用了上面介紹的方法 動(dòng)態(tài)的傳遞參數(shù)，配置文件將不可用。

在你的類庫(kù)中使用 CodeIgniter 資源

在你的類庫(kù)中使用 get_instance() 函數(shù)來(lái)訪問 CodeIgniter 的原生資源，這個(gè)函數(shù)返回 CodeIgniter 超級(jí)對(duì)象。

通常情況下，在你的控制器方法中你會(huì)使用 $this 來(lái)調(diào)用所有可用的 CodeIgniter 方法:

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

但是 $this 只能在你的控制器、模型或視圖中直接使用，如果你想在你自己的類中使用 CodeIgniter 類，你可以像下面這樣做：

首先，將 CodeIgniter 對(duì)象賦值給一個(gè)變量:

$CI = get_instance();

一旦你把 CodeIgniter 對(duì)象賦值給一個(gè)變量之后，你就可以使用這個(gè)變量來(lái) 代替 $this

$CI = get_instance();

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

注：

上面的 get_instance() 函數(shù)通過引用來(lái)傳遞:

$CI = get_instance();

這是非常重要的，引用賦值允許你使用原始的 CodeIgniter 對(duì)象，而不是創(chuàng)建一個(gè)副本。

既然類庫(kù)是一個(gè)類，那么我們最好充分的使用 OOP 原則，所以，為了讓類中的所有方法都能使用 CodeIgniter 超級(jí)對(duì)象，建議將其賦值給一個(gè)屬性:

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');
 }
}

使用你自己的類庫(kù)替換原生類庫(kù)

簡(jiǎn)單的將你的類文件名改為和原生的類庫(kù)文件一致，CodeIgniter 就會(huì)使用它替換掉原生的類庫(kù)。 要使用該功能，你必須將你的類庫(kù)文件和類定義改成和原生的類庫(kù)完全一樣，例如， 要替換掉原生的 Email 類的話，你要新建一個(gè) application/libraries/Email.php 文件， 然后定義定義你的類:

class CI_Email {
}

注意大多數(shù)原生類都以 CI_ 開頭。

要加載你的類庫(kù)，和標(biāo)準(zhǔn)的方法一樣:

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

注：

注意數(shù)據(jù)庫(kù)類不能被你自己的類替換掉。

擴(kuò)展原生類庫(kù)

如果你只是想往現(xiàn)有的類庫(kù)中添加一些功能，例如增加一兩個(gè)方法， 這時(shí)替換整個(gè)類感覺就有點(diǎn)殺雞用牛刀了。在這種情況下，最好的方法是 擴(kuò)展類庫(kù)。擴(kuò)展一個(gè)類和替換一個(gè)類差不多，除了以下幾點(diǎn)：

• 類在定義時(shí)必須繼承自父類。
• 你的新類名和文件名必須以 MY_ 為前綴（這個(gè)可配置，見下文）

例如，要擴(kuò)展原生的 Email 類你需要新建一個(gè)文件命名為 application/libraries/MY_Email.php ， 然后定義你的類:

class MY_Email extends CI_Email {
}

如果你需要在你的類中使用構(gòu)造函數(shù)，確保你調(diào)用了父類的構(gòu)造函數(shù):

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

注：

并不是所有的類庫(kù)構(gòu)造函數(shù)的參數(shù)都是一樣的，在對(duì)類庫(kù)擴(kuò)展之前 先看看它是怎么實(shí)現(xiàn)的。

加載你的擴(kuò)展類

要加載你的擴(kuò)展類，還是使用和通常一樣的語(yǔ)法。不用包含前綴。例如， 要加載上例中你擴(kuò)展的 Email 類，你可以使用:

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

一旦加載，你還是和通常一樣使用類變量來(lái)訪問你擴(kuò)展的類，以 email 類為例， 訪問它的方法如下:

$this->email->some_method();

設(shè)置自定義前綴

要設(shè)置你自己的類的前綴，你可以打開 application/config/config.php 文件， 找到下面這項(xiàng):

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

注：所有原始的 CodeIgniter 類庫(kù)都以 CI_ 開頭，所以請(qǐng)不要使用這個(gè) 作為你的自定義前綴。

更多關(guān)于CodeIgniter相關(guān)內(nèi)容感興趣的讀者可查看本站專題：《codeigniter入門教程》、《CI(CodeIgniter)框架進(jìn)階教程》、《php優(yōu)秀開發(fā)框架總結(jié)》、《ThinkPHP入門教程》、《ThinkPHP常用方法總結(jié)》、《Zend FrameWork框架入門教程》、《php面向?qū)ο蟪绦蛟O(shè)計(jì)入門教程》、《php+mysql數(shù)據(jù)庫(kù)操作入門教程》及《php常見數(shù)據(jù)庫(kù)操作技巧匯總》

希望本文所述對(duì)大家基于CodeIgniter框架的PHP程序設(shè)計(jì)有所幫助。