CI 学习笔记、记录

时间 2019-11-18

标签学习笔记记录繁體版

原文原文链接

【ci框架】ci框架目录结构分析

分类：【CodeIgniter深刻研究】2013-05-09 00:24 7420人阅读评论(5) 收藏举报javascript

[php] view plain copyphp

myshop
|-----system 框架程序目录
|-----core 框架的核心程序
|-----CodeIgniter.php 引导性文件
|-----Common.php 加载基类库的公共函数
|-----Controller.php 基控制器类文件：CI_Controller
|-----Model.php 基模型类文件：CI_Model
|-----Config.php 配置类文件：CI_Config
|-----Input.php 输入类文件：CI_Input
|-----Output.php 输出类文件：CI_Output
|-----URL.php URL类文件：CI_URl
|-----Router.php 路由类文件：CI_Router
|-----Loader.php 加载类文件：CI_Loader
|-----helpers 辅助函数
|-----url_helper.php url相关的辅助函数，如：建立url的辅助函数
|-----captcha_helper.php建立图形验证码的辅助函数
|-----libraries 通用类库
|-----Pagination.php 通用分页类库
|-----Upload.php 通用文件上传类库
|-----Image_lib.php 通用图像处理类库
|-----Session.php 通用session类库
|-----language 语言包
|-----database 数据库操做相关的程序
|-----DB_active_rec.php 快捷操做类文件(ActiveRecord)
|-----fonts 字库
|-----application 项目目录
|-----core 项目的核心程序
|-----helpers 项目的辅助函数
|-----libraries 通用类库
|-----language 语言包
|-----config 项目相关的配置
|-----config.php 项目相关的配置文件
|-----database.php 数据库相关的配置文件
|-----autoload.php 设置自动加载类库的配置文件
|-----constants.php 常量配置文件
|-----routes.php 路由配置文件
|-----controllers 控制器目录
|-----welcome.php 控制器文件，继承CI_Controller
|-----models 模型目录
|-----welcome_model.php 模型文件，继承CI_Model
|-----views 视图目录
|-----welcome.php 视图模板文件，默认后缀名为.php
|-----cache 存放数据或模板的缓存文件
|-----errors 错误提示模板
|-----hooks 钩子，在不修改系统核心文件的基础上扩展系统功能
|-----third_party 第三方库
|-----logs 日志
|-----index.php 入口文件

base_url();根目录地址
site_url();网址html

表单验证类使用java

public function index()
{
$this->load->helper(array('form', 'url'));mysql

$this->load->library('form_validation');//1.载入表单验证类程序员

$this->form_validation->set_rules('username', 'Username', 'required');//设置验证规则
$this->form_validation->set_rules('password', 'Password', 'required',
array('required' => 'You must provide a %s.')
);
$this->form_validation->set_rules('passconf', 'Password Confirmation', 'required');
$this->form_validation->set_rules('email', 'Email', 'required');web

if ($this->form_validation->run() == FALSE)
{
$this->load->view('myform');
}
else
{
$this->load->view('formsuccess');
}
}
}正则表达式

举例来讲，若是你的 URI 是这样的：sql

example.com/index.php/products/shoes/sandals/123

URI 的第3和第4部分会被传递给你的方法（“sandals” 和 “123”）：数据库

<?php
class Products extends CI_Controller {

public function shoes($sandals, $id)
{
echo $sandals;
echo $id;
}
}
?>

上面的方法调用时必须给两个相应的参数，要否则会出错。固然你也能够像下面这样写，就不用在调用的时候给参数了！

<?php
class Products extends CI_Controller {

public function shoes($sandals='Test', $id=1)
{
echo $sandals;
echo $id;
}
}

定义默认控制器
当你的网站没有设置 URI 或者直接从根目录访问的时候，CodeIgniter 会加载默认控制器。打开 application/config/routes.php 文件来设置默认控制器：

$route['default_controller'] = 'Blog'

处理输出
CodeIgniter 拥有一个输出类用来确保你修改的数据会自动被传递给浏览器。关于这个的更多信息能够在视图和输出类里找到。有些时候，你可能想要本身发布修改一些最终的数据或是本身把它传递给浏览器。CodeIgniter 容许你给你的控制器增长一个名为 _output() 的方法来接收最终的数据。

注意：若是你的控制器包含一个 _output() 方法，那么它将老是被调用，而不是直接输出最终的数据。这个方法相似于OO里的析构函数，无论你调用任何方法这个方法老是会被执行。

例如：

public function _output($output)
{
echo $output;
}

请注意，你的 _output() 将接收最终的数据。 Benchmark和内存的使用率数据将被渲染，缓存文件会被写入（若是已启用缓存），而且 HTTP 头也将被发送（若是您使用该功能），而后交给 _output() 函数。

为了让你的控制器输出缓存正确, 它的 _output() 函数能够这样来写:

if ($this->output->cache_expiration > 0)
{
$this->output->_write_cache($output);
}
若是您正在使用页面执行时间和内存使用统计的功能，这可能不彻底准确，由于他们不会考虑到你所作的任何进一步的动做。请在输出类参用可用的方法，来控制输出以使其在任何最终进程完成以前执行。

私有方法
在某些状况下，你可能想要隐藏一些方法使之没法对外查阅。将方法私有化很简单，只要在方法名字前面加一个下划线（“_”）作前缀就没法经过 URL 访问到了。例如，若是你有一个像这样的方法：

private function _utility()
{
// some code
}

那么，经过下面这样的 URL 进行访问是没法访问到的：

example.com/index.php/blog/_utility/

如何将控制器放入子文件夹中
若是你在创建一个大型的应用程序，你会发现 CodeIgniter 能够很方便的将控制器放到一些子文件夹中。

只要在 application/controllers 目录下建立文件夹并放入你的控制器就能够了。

注意：若是你要使用某个子文件夹下的功能，就要保证 URI 的第一个片断是用于描述这个文件夹的。例如说你有一个控制器在这里：

application/controllers/products/shoes.php

调用这个控制器的时候你的 URI 要这么写：

example.com/index.php/products/shoes/show/123

你的每一个子文件夹中须要包含一个默认的控制器，这样若是 URI 中只有子文件夹而没有具体功能的时候它将被调用。只要将你做为默认的控制器名称在 application/config/routes.php 文件中指定就能够了。

CodeIgniter 也容许你使用 URI 路由功能来从新定向 URI。

构造函数
若是要在你的任意控制器中使用构造函数的话，那么必须在里面加入下面这行代码：

parent::__construct();

这行代码的必要性在于，你此处的构造函数会覆盖掉这个父控制器类中的构造函数，因此咱们要手动调用它。

<?php
class Blog extends CI_Controller {

public function __construct()
{
parent::__construct();
}
}
?>

若是你须要设定某些默认的值或是在实例化类的时候运行一个默认的程序，那么构造函数在这方面就很是有用了。
构造函数并不能返回值，可是能够用来设置一些默认的功能。

视图
简而言之，一个视图就是一个网页，或是网页的部分，如头部，底部，侧边栏等等。事实上，若是你须要这种层次类型，视图能够很灵活的嵌入到其余视图中。

视图从不直接调用，必须被一个控制器来调用。记住，在一个 MVC 框架中，控制器扮演着交通警察的角色，那么，他有责任去取回某一特定的视图。若是你尚未阅读过控制器页面的话，你应该事先阅读控制器页面。

载入视图 $this->load->view('name');
子文件夹里面的视图
$this->load->view('folder_name/file_name');

zai载入多个视图
若是有多个调用，那么他们将会被合并到一块儿。例如，你可能但愿有一个标题视图、一个菜单视图、一个内容视图、和一个页脚视图。他们看起来应该是这样：

$data['page_title'] = 'Your title';
$this->load->view('header'，$data);
$this->load->view('menu');
$this->load->view('content');
$this->load->view('footer');
咱们一次性载入多个视图的时候，你只需在第一个视图传入数据就能够了(header视图显示title,content视图显示message)，好比：

建立循环
$todo_list 是传过来的数据
<ul>
<?php foreach ($todo_list as $item):?>

<?php endforeach;?>
</ul>

获取视图内容
view函数第三个可选参数能够改变函数的行为，让数据做为字符串返回而不是发送到浏览器。若是想用其它方式对数据进一步处理，这样作颇有用。若是将view第三个参数设置为true（布尔）则函数返回数据。view函数缺省行为是 false,　将数据发送到浏览器。若是想返回数据，记得将它赋到一个变量中：

$string = $this->load->view('myfile', '', true);

view方法中的第三个参数表示不输出视图，而只是将结果返回给一个变量。

active record

模型
文件名应该是模型类名的小写版。好比，若是你的类是:

class User_model extends CI_Model {

function __construct()
{
parent::__construct();
}
}

类的文件名应该是：

application/models/user_model.php

载入模型
模型能够在控制器中被引用。就像这样:

$this->load->model('Model_name');

若是模型文件在子文件夹下，引用的时候要带上相对路径名。例如：若是你有一个模型 application/models/blog/queries.php。下面的代码能够引用它:

$this->load->model('blog/queries');

模型一旦被载入，你就能经过下面的方法使用它:

$this->load->model('Model_name');

$this->Model_name->function();

在默认的状况下模型名称就直接被引入做为对象名，就如上面所示。固然，若是你愿意，能够起个更好记的对象名！那么，能够在加载模型函数中指定第二个参数来设定，例如：

$this->load->model('Model_name', 'fubar');

$this->fubar->function();

自动载入模型实现的方法是打开 application/config/autoload.php 文件，而后在自动装载数组中添加上这个模型。

连接数据库
您能够把第三个参数设置为TRUE来使模型装载函数自动链接数据库，链接配置能够在您的数据库配置文件中能够定义:
$this->load->model('Model_name', '', TRUE);

您能够手动设定第三个参数来载入您的自定义数据库配置:
$config['hostname'] = "localhost";
$config['username'] = "myusername";
$config['password'] = "mypassword";
$config['database'] = "mydatabase";
$config['dbdriver'] = "mysql";
$config['dbprefix'] = "";
$config['pconnect'] = FALSE;
$config['db_debug'] = TRUE;

$this->load->model('Model_name', '', $config);

辅助函数
URL Helpers 能够帮助咱们建立连接，Form Helpers 能够帮助咱们建立表单，Text Helpers 提供一系列的格式化输出方式，Cookie Helpers 能帮助咱们设置和读取COOKIE， File Helpers 能帮助咱们处理文件，等等。

CodeIgniter 默认是没有载入辅助函数文件的，因此若是你想用辅助函数，就必须先载入它。一旦被载入，辅助函数将全局可用(globally available)，你能够在 controller 和 views 中使用它们。

就近原则
辅助函数文件通常保存在 system/helpers 或 application/helpers 文件夹中。CodeIgniter 将会先在 application/helpers 寻找对应的辅助函数文件，若是目录不存在或者目录下没有对应的辅助函数文件，CI 才会载入 system/helpers 下的辅助函数文件。

载入辅助函数是很是简单的:

单个载入
$this->load->helper('name');
多个载入

$this->load->helper( array('helper1', 'helper2', 'helper3') );

自动载入
经过打开 application/config/autoload.php ，并往自动载入数组(autoload array)中增长辅助函数来实现。

name 是辅助函数文件的名字(不带.php后缀和"helper" 部分)。辅助函数载入函数并不返回值，因此不要尝试将它付给一个变量

使用：：
使用辅助函数
一旦你载入了想要用到辅助函数文件，你就能够用标准的函数调用方法来使用里面的函数。

例如，要使用anchor() 函数来创建一个连接，在视图(View)文件里面你能够这样作:

<?php echo anchor('blog/comments', 'Click Here');?>

扩展辅助函数
"扩展" Helpers
你若是想 "扩展"一个原有的 Helpers,，能够在你的 application/helpers/ 目录下建立一个新的helper，新的helper的名字是在被“扩展”的Helper的名字开头多加一个 MY_ (这是能够配置的. 见下.).

若是你想作的只是在原有的helper中添加一些新的功能，好比，添加一两个新的方法，或者是修改一个方法；就不值得重写本身的helper。在这种状况下，最好是“扩展”已有的helper。“扩展”一词用在这里不是很恰当，由于Helper的方法是程序化(procedural) 和离散(discrete)的，在传统的语言环境中没法被“扩展”，不过在CodeIgniter中，你能够添加或修改helper的方法。

例如，扩展一个本地已有的 Array Helper 你应该创建一个文件： application/helpers/MY_array_helper.php, 并添加或重写（override）其中的一些方法:

// any_in_array() is not in the Array Helper, so it defines a new function
function any_in_array($needle, $haystack)
{
$needle = (is_array($needle)) ? $needle : array($needle);

foreach ($needle as $item)
{
if (in_array($item, $haystack))
{
return TRUE;
}
}

return FALSE;
}

// random_element() is included in Array Helper, so it overrides the native function
function random_element($array)
{
shuffle($array);
return array_pop($array);
}

设定你本身的前缀（Prefix）
用于"扩展" helper 而加上前缀的文件一样也是对库和核心类的扩展.为了设置你自定义的前缀,请打开 application/config/config.php 文件,而后找到以下的条目:

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

请注意：因为全部CodeIgniter自带的库都被冠以 CI_ 这样的前缀命名,因此请不要使用CI_来自定义前缀.

使用 CodeIgniter 类库
全部的类库文件存放在system/libraries 文件夹。大多数状况下你须要预先在controller中初始化后才能使用它们:

$this->load->library('class name');

多个类库能够经过传递包含类库的数组一次加载。

$this->load->library(array('email', 'table'));

例如$this->load->library('form_validation');

创建你的类库文件
你的类库文件必须保存在 application/libraries 文件夹,CodeIgniter将在这个文件夹中寻找并初始化它们.

命名约定
文件名首字母大写. 例如: Myclass.php
类声明首字母大写. 例如: class Myclass
类的名字和文件名应符合.
类文件
全部的类应有基础原型(注意,这里咱们以 Someclass 这个名字为例):

<?php if (!defined('BASEPATH')) exit('No direct script access allowed');

class Someclass {

public function some_function()
{
}
}

/* End of file Someclass.php */

使用你本身的类
在全部的Controller 函数中,你能够用如下的标准方式初始化你的类:

$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');
//etc.
$this, 只直接做用在你本身的控制器,模型和视图中.当你在自定义类中想使用CodeIgniter原始类时,你能够这样作:

首先,定义CodeIgniter对象赋给一个变量:

$CI =& get_instance();

一旦定义某个对象为一个变量,你就可使用那个变量名取代 $this:

$CI =& get_instance();

$CI->load->helper('url');
$CI->load->library('session');
$CI->config->item('base_url');
//etc.
注意: 你将注意到get_instance()这个函数经过被引用的方式被传递:

$CI =& get_instance();

这十分重要. 经过引用的方式赋给变量将使用原始的 CodeIgniter 对象，而不是建立一个副本。

扩展的类必须申明由母类扩展而来.
新扩展的类所在的文件必须以 MY_ 为前缀(这个选项是可配置的,下面有说明).
例如，要扩展原始类 Email 类你要创建文件 application/libraries/MY_Email.php, 并按以下方式在文件中声明:

class MY_Email extends CI_Email {

}

注意:若是你须要在类中使用构造函数,你必须在构造函数中显式继承母类构造函数:

class MY_Email extends CI_Email {

public function __construct()
{
parent::__construct();
}
}

载入你的子类
要载入扩展子类，你应该使用标准字符名. 请不要使用前缀. 例如,要载入上文说过的email扩展子类，你应该这样写:

$this->load->library('email');
\
扩展子类一旦被载入，就能像通常的类同样使用它们. Email类中的全部函数就能被调用:

$this->email->some_function();

使用 CodeIgniter 适配器
适配器的源文件存放在system/libraries 目录下, 在本身的文件夹同样有和父类名字相同的类库可使用同时在这个文件夹中，有一个子文件夹叫作 drivers在其中包含了全部的子类

要使用一个适配器，你须要在一个控制器里用以下的初始化函数初始它：

$this->load->driver('class name');
这里的class name 是你想加载的适配器的名字。好比说你想加载一个叫作"Some Parent"的适配器，你能够这样：

$this->load->driver('some_parent');

控制器类中的方法能够用以下的方式来调用:

$this->some_parent->some_method();

这些做为子类的适配器能直接经过父类调用，而不用初始化。

$this->some_parent->child_one->some_method();
$this->some_parent->child_two->another_method();

建立适配器
适配器目录和文件结构
适配器目录和文件结构布局的例子：

/application/libraries/Driver_name
Driver_name.php
drivers
Driver_name_subclass_1.php
Driver_name_subclass_2.php
Driver_name_subclass_3.php
这个 Driver_name 目录必须使用 ucfirst() 函数处理。

);

钩子 - 扩展框架的核心
CodeIgniter 的钩子功能使得您能够在不修改系统核心文件的基础上来改变或增长系统的核心运行功能。当 CodeIgniter 运行后，它会产生出一个特殊的进程，这个进程在项目流程页面中有说明。固然，您能够自定义一些动做来替代程序运行过程当中的某些阶段。例如，您能够在控制器刚刚载入前或刚刚载入后来运行特定的脚本，或者在其余时刻来触发您的脚本。

启用钩子
钩子功能能够在全局范围内打开或关闭，您能够在 application/config/config.php 文件中设定:

$config['enable_hooks'] = TRUE;

定义钩子
钩子是在 application/config/hooks.php 文件中定义的。每一个钩子能够用如下格式的数组来定义:

$hook['pre_controller'] = array(
'class' => 'MyClass',
'function' => 'Myfunction',
'filename' => 'Myclass.php',
'filepath' => 'hooks',
'params' => array('beer', 'wine', 'snacks')
);

说明：
数组的索引与你使用的指定挂钩点名字相关.上面的例子中挂钩点是pre_controller. 挂钩点参数列表以下所示. 如下各项将定义在你的相关钩子数组里：

class 你但愿调用的类名.若是你更喜欢使用过程函数代替类的话,此项保留为空.
function 你但愿调用的函数名.
filename 包含有你的类/函数的文件名.
filepath 包含你的脚本的目录名. 注意: 你的脚本放在 application 文件夹下的目录里, 这样 filepath就以那个文件夹(application)为基准. 例如, 若是你的脚本放在application/hooks下, 你能够把hooks 做为你的filepath. 若是你的脚本放在application/hooks/utilities下你能够把 hooks/utilities做为filepath. 注意后面没有"/".若是不放在根目录下能够根据相对路径的配置，来完成调用。这样就能够完成，多个应用共享一个钩子。
params 你但愿传递给脚本的任何参数. 此项是可选的.
同一挂钩点的屡次引用
若是你想在同一个挂钩点引用多个脚本,最简单的方式就是把你的数组定义成二维的,像这样:

$hook['pre_controller'][] = array(
'class' => 'MyClass',
'function' => 'Myfunction',
'filename' => 'Myclass.php',
'filepath' => 'hooks',
'params' => array('beer', 'wine', 'snacks')
);

$hook['pre_controller'][] = array(
'class' => 'MyOtherClass',
'function' => 'MyOtherfunction',
'filename' => 'Myotherclass.php',
'filepath' => 'hooks',
'params' => array('red', 'yellow', 'blue')
);

注意在每一个数组索引后面的中括号:

$hook['pre_controller'][]

这容许你的多个脚本拥有相同的挂钩点。你定义数组的顺序将是程序执行的顺序.

挂勾点
如下是一组可用的挂钩点.

pre_system
系统执行的早期调用.仅仅在benchmark 和 hooks 类加载完毕的时候. 没有执行路由或者其它的过程.
pre_controller
在调用你的任何控制器以前调用.此时所用的基础类,路由选择和安全性检查都已完成.
post_controller_constructor
在你的控制器实例化以后,任何方法调用以前调用.
post_controller
在你的控制器彻底运行以后调用.
display_override
覆盖_display()函数, 用来在系统执行末尾向web浏览器发送最终页面.这容许你用本身的方法来显示.注意，你须要经过 $this->CI =& get_instance() 引用 CI 超级对象，而后这样的最终数据能够经过调用 $this->CI->output->get_output() 来得到。
cache_override
可让你调用本身的函数来取代output类中的_display_cache() 函数.这可让你使用本身的缓存显示方法
post_system
在最终着色页面发送到浏览器以后,浏览器接收完最终数据的系统执行末尾调用

自动装载资源
“libraries”文件夹中的核心类
“helper”文件夹中的辅助函数
“config”文件夹中自定义配置文件
“system/language”文件夹中的语言包
“models”文件夹中的模型
要自动装载资源，打开 application/config/autoload.php 文件，而后将你想要自动装载的项目添加到 autoload 数组中，你会发现该文件中对应于上面每一个项目类型指示。

公共函数
注：本条为本人添加。公共函数位于 system/core/Common.php 文件中，你们能够在这里定义本身的公共函数。--IT不倒翁

CodeIgniter 使用了一些全局定义的函数来完成操做，在任何状况下你都可以使用这些函数。使用他们不须要载入任何类库或辅助函数。

eg:
show_error('message'), show_404('page'), log_message('level', 'message')

set_status_header(code, 'text');
容许你手动设置服务器状态头(header)。例如:

set_status_header(401);

// 将header设置为: Unauthorized

html_escape($mixed)
利用此功能能够方便的使用htmlspecialchars()函数。它接受字符串和数组。有助于防止跨站脚本攻击（XSS）。

URI 路由
example.com/class/function/id/

设定你本身的路由规则
路由规则定义在application/config/routes.php 文件中. 在此文件中，你能够看到一个名为 $route的数组，它可让你定义你本身的路由规则。定义能够用两种方式：通配符(wildcards) 或者正则表达式(Regular Expressions)

通配符
一个典型的通配符路由看起来是这样的：

$route['product/(:num)'] = "catalog/product_lookup";

在一个路由中,数组的键包含着被匹配的URI,而数组的值包含着路由将被重定向的目的地.在上面的例子中,若是单词“product”出如今URL的第一个部分中，并且数字(:num)出如今URI的第二个部分中,"catalog"类和"product_lookup"方法将被替代使用(即将被重定向).

你能够匹配文字的值或者使用如下两种通配符类型:

:num 将匹配一个只包含有数字的segment(段).
:any 将匹配一个包含任何字符的segment.

注意: 路由将会按照定义的顺序来运行.高层的路由老是优先于低层的路由.
$route['journals'] = "blogs";

若是URL的第一个分段（类名）是关键字"journals"，那么将会重定向到"blogs"类中处理.

$route['blog/joe'] = "blogs/users/34";

若是URL的前两个分段是"blog"和"joe"，那么将会重定向到"blogs"类的"users"方法中处理.而且将ID"34"设为参数.

$route['product/(:any)'] = "catalog/product_lookup";

当"product"做为URL中第一个分段时, 不管第二分段是什么都将被重定向到"catalog"类的"product_lookup"方法.

$route['product/(:num)'] = "catalog/product_lookup_by_id/$1";

当“product”做为 URL 中第一个分段时，若是第二分段是数字，则将被重定向到“catalog”类，并传递所匹配的内容到“product_lookup_by_id”方法中。

一个典型的正则表达式看起来像下面的样子:

$route['products/([a-z]+)/(\d+)'] = "$1/id_$2";

上例中, 相似于 products/shirts/123 的URI 将换成调用 shirts 控制器类的 id_123 方法.

系统保留的路由
系统会保留两个路由：

第一个为系统默认的路由：

$route['default_controller'] = 'welcome';

这个路由代表了当URI中不包含要访问的类和控制器信息的（即只访问根目录的状况，如http://localhost/ci）将要加载哪一个控制器。上例中,系统将加载 "welcome" 这个类（控制器）。你应该保证设置一个默认路由，否则你的首页将会显示 404 错误。

第二个为404页面的路由：

$route['404_override'] = '';

这个路由标识了若是请求的控制器没法访问的时候将加载哪一个控制器。它至关于覆盖了默认的404错误页面（即提供了本身定义404页面的功能）。但它不会影响show_404()这个方法，这个方法依然会加载默认的位于application/errors/error_404.php的error_404.php页面。

错误处理
show_error('消息' [, int $status_code = 500 ] [, string $heading = 'An Error Was Encountered'])
这个函数将会使用如下错误模版来显示错误消息:

application/errors/error_general.php

可选参数 $status_code 决定在显示错误的同时将会发送哪一种 HTTP 状态代码。

可选参数 $heading 决定错误模版h1标签内容。

show_404('页面' [, 'log_error'])
这个函数将会使用如下错误模版来显示 404 错误信息:

application/errors/error_404.php

传递给该函数的字符串表明的是找不到的文件路径。注意CodeIgniter会在找不到目标控制器状况下，自动显示404消息。

CodeIgniter自动记录任何 show_404() 函数调用。设置第二个可选的参数为FALSE将跳过记录

log_message('级别', '消息')
这个函数可让你将消息写入记录文件中。你必须在第一个参数中选择三个“级别“中的任何一个, 指明它是那一类消息(调试 debug, 错误 error, 信息info)。第二个参数是消息自己。例如:

if ($some_var == "")
{
log_message('error', 'Some variable did not contain a value.');
}
else
{
log_message('debug', 'Some variable was correctly set');
}

log_message('info', 'The purpose of some variable is to provide some value.');

有三种不一样类型的消息:

错误类型的消息。这种是真正的错误消息. 例如PHP错误或者用户错误。
调试类型的消息。这种是用来帮助调试的消息。例如，若是当一个类被初始化时，你能够将这个初始化纪录下来，而后用于调试。
信息类型的消息。这种是最低优先级别的消息，它只是简单的提供了关于运行的一些信息。 CodeIgniter 不会自动产生任何信息类型的消息，可是你可能会在你的程序里使用它

意: 确保"logs" 文件夹是可写的,才能准确地将消息写入记录文件中。此外, 你必须设置application/config/config.php文件中的"threshold"设定，经过设置“threshold“，你能够只记录错误类型的消息，而不用记录其余两种。若是你将“threshold“设为0，记录就会被禁止。

网页缓存

CI支持每一个页面单独缓存，并且能够设置缓存更新时间。当一个网页第一次被加载的时候，缓存文件将被保存到application/cache文件夹。下次访问的时候，系统就会直接读取缓存文件，而后返回给用户的浏览器。若是缓存文件过时，它将被删除并从新生成。

启动缓存
启用缓存功能，只须要将下面的代码放入你的任何一个控制器(controller)的方法(function)内：

$this->output->cache(n);
若是你再也不想使用缓存，仅需将上面的代码从你的controller里面删除便可

调试你的应用程序

激活分析器
$this->output->enable_profiler(TRUE);
分析器激活后将产生一个报告并插入您的页面底部

使用如下方法禁用该分析器:

$this->output->enable_profiler(FALSE);

启用和禁用分析数据中的字段
分析数据中的每一个字段可经过设置相应的控制变量TRUE or FALSE来启用和禁用. 其中的一个方法是：你能够在application/config/profiler.php 配置文件里设置整个程序的全局默认值.

$config['config'] = FALSE;
$config['queries'] = FALSE;

另外一种方法是：你能够在控制器中经过调用set_profiler_sections() 来覆盖全局设置和默认设置，详细可见： Output class:

$sections = array(
'config' => TRUE,
'queries' => TRUE
);

$this->output->set_profiler_sections($sections);

管理你的应用程序
若是你要对 application 进行重命名，你须要打开 index.php 文件，对变量 $application_folder 进行更改:

$application_folder = "application";

更改你的应用程序的文件夹路径
你能够将 application文件夹从system 文件夹中挪放到服务器的其余的位置。可是你还要更改 index.php 文件里将$application_folder变量设置为服务器的全路径。

$application_folder = "/Path/to/your/application";

在一个 CodeIgniter 下运行多个应用程序
若是你想要多个应用程序共享同一个 CodeIgniter，你要将 application 下全部的文件夹放在不一样的应用程序的文件夹内。

例如，你要创建两个应用程序 "foo" 和 "bar",你的应用程序文件夹的结构可能会像下面的这样:

applications/foo/
applications/foo/config/
applications/foo/controllers/
applications/foo/errors/
applications/foo/libraries/
applications/foo/models/
applications/foo/views/
applications/bar/
applications/bar/config/
applications/bar/controllers/
applications/bar/errors/
applications/bar/libraries/
applications/bar/models/
applications/bar/views/

要选择使用某个应用程序，你须要打开主 index.php 文件，而且设置 $application_folder 变量为目标路径。例如，经过以下设置，就能够选择使用 "foo" 应用程序:

$application_folder = "applications/foo";

视图文件的 PHP 替代语法
若是你不使用 CodeIgniter 的模板引擎，则你能够在视图文件中使用原始 PHP 代码。要使 PHP 代码达到最精简并使其更容易辨认，所以建议你使用 PHP 替代语法控制结构及短标记的 echo 语句。建议你使用 PHP 的语法为你的控制结构和简短的输出标签。若是你还不熟悉这个语法，下面你将学会如何从代码中消灭大括号和“echo”语句。

替代 Echo
正常的 echo 和 print 输出通常是这样的形式：

<?php echo $variable; ?>

使用替代语法，你能改为这样的形式：

<?=$variable?>

替代控制结构
控制结构，像 if，for，foreach，和 while 也能够写成简化的形式。这里是一个用 foreach 的例子：

<ul>

<?php foreach ($todo as $item): ?>

<?php endforeach; ?>

</ul>

注意，这里没有大括号。相反，结束大括号被替换成了 endforeach。上面列出的每个控制结构也有类似的关闭语法：endif，endfor，endforeach，和 endwhile

而且在每一个结构之后注意不要使用分号(除了最后一个)，用冒号。这是很重要的！

这有另外一个例子，使用 if/elseif/else。注意冒号：

<?php if ($username == 'sally'): ?>

<h3>Hi Sally</h3>

<?php elseif ($username == 'joe'): ?>

<?php else: ?>

<h3>Hi unknown user</h3>

<?php endif; ?>

安全
本页描述了一些关于 Web 安全的“最佳实践”，并详细说明了 CodeIgniter 的内部安全特性。

URI 安全
CodeIgniter 严格限制 URI 中所能包含的字符，以此帮助你设计的程序减小被恶意数据入侵的可能。URI 通常只包含下列内容：

字母和数字（Alpha-numeric text）
波浪符（Tilde）： ~
句号（Period）： .
冒号（Colon）： :
下划线（Underscore）： _
破折号（Dash）： -
Register_globals
系统初始化期间全部的全局变量都被 unset，除了那些在 $_GET、$_POST 和 $_COOKIE 数组中的数据。实际上 unsetting 实例程序的做用与register_globals = off 相同。

error_reporting
在生产环境中，每每有必要经过设置内部的error_reporting值为0来禁用PHP错误报告。这能够防止可能含有敏感信息的原始PHP错误报告输出。

在 index.php 设置CodeIgniter的 ENVIRONMENT 常量为 'production' 将会关闭这些错误(报告)。在开发模式下，推荐设为 'development'。更多关于各环境间区别的信息能够在处理多环境一章找到。

magic_quotes_runtime
在系统初始化期间 magic_quotes_runtime 指令被关闭以便在数据库检索数据时没必要去掉反斜线。

最佳实践
在接收任何数据到你的程序以前，无论是表单提交的 POST 数据、COOKIE 数据、URI 数据、XML-RPC 数据、仍是 SERVER 数组中的数据，咱们都推荐你实践下面的三个步骤：

过滤不良数据.
验证数据以确保符合正确的类型, 长度, 大小等. (有时这一步骤也可取代第一步骤)
在提交数据到你的数据库以前将其转换.
CodeIgniter 提供了下列函数以辅助这个过程:

XSS 过滤
CodeIgniter带有一个跨站脚本过滤器. 这个过滤器会查找那些用一般手段嵌入到你数据中恶意的Javascript,或其它一些试图欺骗cookie类型的或者作其它恶意事情的代码. XSS Filter的详细描述在这里.

验证数据
CodeIgniter 有一个表单验证类用来帮助验证、过滤和预处理数据。

插入数据库以前转义全部数据
不要插入未转义的信息到你的数据库中。要了解更多信息请参阅查询章节。

开发规范：*****************************

文件格式
文件应该使用 Unicode (UTF-8) 编码保存。同时不要使用字节序标记(BOM) 。

尾标签
全部的php文件应该省略这个php闭合标签，并插入一段注释来标明这是文件的底部并定位这个文件在这个应用的相对路径。这样有利于你肯定这个文件已经结束而不是被删节的。

不当的: <?php echo "Here's my code!"; ?> 适当的: <?php echo "Here's my code!"; /* End of file myfile.php */ /* Location: ./system/modules/mymodule/myfile.php */

类和方法（函数）的命名规则
类名的首字母应该大写。若是名称由多个词组成，词之间要用下划线分隔，不要使用骆驼命名法。类中全部其余方法的名称应该彻底小写而且名称能明确指明这个函数的用途，最好用动词开头。尽可能避免过长和冗余的名称
不当的: class superclass class SuperClass 适当的: class Super_class

方法：
不当的: function fileproperties() // 方法名没有清晰的描述以及下划线分割单词 function fileProperties() // 方法名没有清晰的描述以及使用了驼峰法命名 function getfileproperties() // 还能够!可是忘记了下划线分割单词 function getFileProperties() // 使用了驼峰法命名 function get_the_file_properties_from_the_file() // 方法名太冗长适当的: function get_file_properties() // 清晰的方法名描述，下划线分割单词，所有使用小写字母

变量命名
变量名应该只包含小写字母，用下划线分隔，而且能适当地指明变量的用途和内容

注释
一般，代码应该被详细地注释。这不只仅有助于给缺少经验的程序员描述代码的流程和意图，并且有助于给你提供丰富的内容以让你在几个月后再看本身的代码时仍能很好的理解。注释没有强制规定的格式，可是咱们建议如下的形式。

文档块(DocBlock) 式的注释要写在类和方法的声明前，这样它们就能被集成开发环境(IDE)捕获：

/** * Super Class * * @package Package Name * @subpackage Subpackage * @category Category * @author Author Name * @link http://example.com */ class Super_class {

/** * Encodes string for use in XML * * @access public * @param string * @return string */ function xml_encode($str)

使用行注释时，在大的注释块和代码间留一个空行。

// break up the string by newlines $parts = explode("\n", $str); // A longer comment that needs to give greater detail on what is // occurring and why can use multiple single-line comments. Try to // keep the width reasonable, around 70 characters is the easiest to // read. Don't hesitate to link to permanent external resources // that may provide greater detail: // // http://example.com/information_about_something/in_particular/ $parts = $this->foo($parts);

常量
常量命名除了要所有用大写外，其余的规则都和变量相同

TRUE, FALSE, 和 NULL 关键字应该老是彻底大写的。

|| 有时让人底气不足，不容易辨识，由于在某些输出设备上它不够清晰(可能看起来像数字11). && 要优先于 AND ,不过二者均可以被接受, 使用 ! 时要在其先后都加一个空格。

不当的: if ($foo || $bar) if ($foo AND $bar) // 能够，但有时不被经常使用的语法程序高亮推荐(高亮标识) if (!$foo) if (! is_array($foo)) 恰当的: if ($foo OR $bar) if ($foo && $bar) // 推荐 if ( ! $foo) if ( ! is_array($foo))

在返回和检查你本身的变量时也要遵循这种严格的方法，必要时使用=== 和 !== 。
不当的: // 若是 'foo' 位于此字符串的起始处，strpos将返回 0, // 此处条件判断的结果为TRUE if (strpos($str, 'foo') == FALSE) 恰当的: if (strpos($str, 'foo') === FALSE)
不当的: function build_string($str = "") { if ($str == "") // uh-oh! 若是传递的参数是FALSE或者整数0那会怎么样? { } } 恰当的: function build_string($str = "") { if ($str === "") { } }

在已提交的附加组件所在的地方不能有调试代码，它们被注释掉的状况除外，例如，建立附加组件时不能调用 var_dump(), print_r(), die(), 以及 exit() ，除非它们已经被注释掉了。

// print_r($foo);

当你的类或文件名是一个常见词语时，或者是极可能与另外一个PHP脚本同名时，使用一个惟一的前缀来避免冲突。你必须始终明白这一点：你的最终用户可能会运行其它第三方的附加组件或者PHP脚本。选择一个可以惟一标识开发者或公司的前缀。

数据库表名
你的附加组件所用到的任何表都必须使用 'exp_' 这个前缀，而后是一个可以惟一标识开发者或公司的前缀，最后才是一个简短的描述性的表名。你不须要担忧用户安装时所使用的数据库前缀，由于CodeIgniter的数据库类将根据实际状况自动地对 'exp_' 进行转换。

不当的: email_addresses // 缺乏这两个前缀 pre_email_addresses // 缺乏 exp_ 前缀 exp_email_addresses // 缺乏惟一前缀恰当的: exp_pre_email_addresses

一个文件一个类

在代码中使用tab代替空格。这虽然看起来像是小事，可是使用tab代替空格有利于那些阅读你的代码的开发者在他们各自所使用的应用程序中自定义缩进方式。此外还有一个好处是，使用这种方式保存的文件稍微紧凑一点。

文件必须使用Unix换行符保存。这对于那些在Windows下的开发者来讲更为重要，但不管如何，确保你的文本编辑器已经设置为使用Unix换行符来保存文件。

使用 Allman 风格缩进。除了类声明之外，括号老是独占一行，且缩进与“属于”它的控制语句同级。

方括号及圆括号内的空格符
一般状况下，不要在方括号"[]"和圆括号"()"内增长任何空格符。惟一的例外就是为了提升可读性和区别开它们与函数，在接受参数的PHP语法控制结构所使用的括号里，须要增长空格符(declare, do-while, elseif, for, foreach, if, switch, while)。

不恰当的: $arr[ $foo ] = 'foo'; 正确的: $arr[$foo] = 'foo'; // 数组键值的方括号内没有空格不恰当的: function foo ( $bar ) { } 正确的: function foo($bar) // 函数声明的圆括号内没有空格 { } 不恰当的: foreach( $query->result() as $row ) // PHP语法控制结构以后有空格，但不是在圆括号内正确的: foreach ($query->result() as $row)

私有方法和变量
Methods and variables that are only accessed internally by your class, such as utility and helper functions that your public methods use for code abstraction, should be prefixed with an underscore.

若是方法和变量只在类的内部使用，应当使用下划线做为前缀。

每行一条语句

字符串
一直使用单引号除非你须要解析变量，若是须要解析变量请使用大括号， to prevent greedy token parsing. 若是字符串包含单引号的话你可使用双引号，这样就不用转义了。

MySQL 的关键字一直大写： SELECT, INSERT, UPDATE, WHERE, AS, JOIN, ON, IN等等

函数的默认参数
可能的话，请提供函数的默认参数，这样能够阻止诸如错误的调用的 PHP 错误，同时能够获取公用的返回值，节约不少行代码。例：

function foo($bar = '', $baz = FALSE)

准备数据
在验证函数的基础上，你可使用不一样的方法准备好你的数据，例如，你能够创建这样的规则：

任何只有一个参数的 PHP 原生函数均可以被用做一个规则，好比 ``htmlspecialchars``， ``trim`` 等等。

上面的例子中，咱们“修剪”内容，转换密码区域为 MD5 编码，经过“XSS_CLEAN”函数检测用户名，移除危险的数据。

默认的PHP函数能为一个规则使用一个参数，像 htmlspecialchars, trim, MD5, 等等.

数组的关键字其实是表单域的名字，对应的值是你想要在错误信息中显示的全名。

如今你控制器中的index函数看起来应该像这样：

function index()
{
$this->load->helper(array('form', 'url'));

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

$rules['username'] = "required";
$rules['password'] = "required";
$rules['passconf'] = "required";
$rules['email'] = "required";

$this->validation->set_rules($rules);

$fields['username'] = 'Username';
$fields['password'] = 'Password';
$fields['passconf'] = 'Password Confirmation';
$fields['email'] = 'Email Address';

$this->validation->set_fields($fields);

if ($this->validation->run() == FALSE)
{
$this->load->view('myform');
}
else
{
$this->load->view('formsuccess');
}
}

如今打开你的视图文件myform.php，根据每一个表单域的名字更新它们的值。

<?=$this->validation->error_string; ?>

<?php echo form_open('form'); ?>

<h5>Username</h5>
<input type="text" name="username" value="<?php echo $this->validation->username;?>" size="50" />

<h5>Password</h5>
<input type="text" name="password" value="<?php echo $this->validation->password;?>" size="50" />

<h5>Password Confirm</h5>
<input type="text" name="passconf" value="<?php echo $this->validation->passconf;?>" size="50" />

<h5>Email Address</h5>
<input type="text" name="email" value="<?php echo $this->validation->email;?>" size="50" />

</form>

</body>
</html>

如今从新加载你的页面，提交表单并触发一个错误。你的表单将会被从新填充并且错误信息也会包含更多相关的表单域的名字。

单独显示错误
若是你想要在每一个表单域旁显示错误，而不是显示一个错误列表，你能够像这样修改你的表单：

<h5>Username</h5>

<?php echo $this->validation->username_error; ?>
<input type="text" name="username" value="<?php echo $this->validation->username;?>" size="50" />

<h5>Password</h5>
<?php echo $this->validation->password_error; ?>
<input type="text" name="password" value="<?php echo $this->validation->password;?>" size="50" />

<h5>Password Confirm</h5>
<?php echo $this->validation->passconf_error; ?>
<input type="text" name="passconf" value="<?php echo $this->validation->passconf;?>" size="50" />

<h5>Email Address</h5>
<?php echo $this->validation->email_error; ?>
<input type="text" name="email" value="<?php echo $this->validation->email;?>" size="50" />
若是没有错误，不会显示任何东西。若是有错误发生，消息将会使用你设置的分割标记显示(<p> 标记是默认值)。

Note: 要这样显示错误信息，你必须以前使用$this->validation->set_fields 函数描述。错误将会被转换成表单域名加"_error"后缀的变量。例如，你的用户名错误的值能够这样访问：
$this->validation->username_error.

处理选择菜单，单选按钮，和复选框
若是你使用了选择菜单，单选按钮，和复选框，你会想在出错时保持原先的选择。验证类有三个函数帮助你完成这些：

set_select()
容许你显示和提交时状态一致的菜单项。第一个参数是选择菜单的名字，第二个参数必须包含每一个选项的值。例如：

<select name="myselect">
<option value="one" <?php echo $this->validation->set_select('myselect', 'one'); ?> >One</option>
<option value="two" <?php echo $this->validation->set_select('myselect', 'two'); ?> >Two</option>
<option value="three" <?php echo $this->validation->set_select('myselect', 'three'); ?> >Three</option>
</select>
set_checkbox()
容许你显示和提交时状态一致的复选框。第一个参数是复选框的名字，第二个参数必须包含它的值，例如：

<input type="checkbox" name="mycheck" value="1" <?php echo $this->validation->set_checkbox('mycheck', '1'); ?> />

set_radio()
容许你显示和提交时状态一致的单选按钮。第一个参数是单选按钮的名字，第二个参数必须包含它的值：例如：

<input type="radio" name="myradio" value="1" <?php echo $this->validation->set_radio('myradio', '1'); ?> />

下表列出了全部可用的原生规则：

规则参数描述例子
required No 若是表单元素为空，返回 FALSE
matches Yes 若是表单元素值与参数中对应的表单字段的值不相等，返回 FALSE matches[form_item]
regex_match Yes 若是表单元素不匹配正则表达式，返回 FALSE regex_match[/regex/]
differs Yes 若是表单元素值与参数中对应的表单字段的值相等，返回 FALSE differs[form_item]
is_unique Yes 若是表单元素值在指定的表和字段中并不惟一，返回 FALSE 注意：这个规则须要启用查询构造器 is_unique[table.field]
min_length Yes 若是表单元素值的长度小于参数值，返回 FALSE min_length[3]
max_length Yes 若是表单元素值的长度大于参数值，返回 FALSE max_length[12]
exact_length Yes 若是表单元素值的长度不等于参数值，返回 FALSE exact_length[8]
greater_than Yes 若是表单元素值小于或等于参数值或非数字，返回 FALSE greater_than[8]
greater_than_equal_to Yes 若是表单元素值小于参数值或非数字，返回 FALSE greater_than_equal_to[8]
less_than Yes 若是表单元素值大于或等于参数值或非数字，返回 FALSE less_than[8]
less_than_equal_to Yes 若是表单元素值大于参数值或非数字，返回 FALSE less_than_equal_to[8]
in_list Yes 若是表单元素值不在规定的列表中，返回 FALSE in_list[red,blue,green]
alpha No 若是表单元素值包含除字母之外的其余字符，返回 FALSE
alpha_numeric No 若是表单元素值包含除字母和数字之外的其余字符，返回 FALSE
alpha_numeric_spaces No 若是表单元素值包含除字母、数字和空格之外的其余字符，返回 FALSE 应该在 trim 以后使用，避免首尾的空格
alpha_dash No 若是表单元素值包含除字母/数字/下划线/破折号之外的其余字符，返回 FALSE
numeric No 若是表单元素值包含除数字之外的字符，返回 FALSE
integer No 若是表单元素包含除整数之外的字符，返回 FALSE
decimal No 若是表单元素包含非十进制数字时，返回 FALSE
is_natural No 若是表单元素值包含了非天然数的其余数值（不包括零），返回 FALSE 天然数形如：0、一、二、3 .... 等等。
is_natural_no_zero No 若是表单元素值包含了非天然数的其余数值（包括零），返回 FALSE 非零的天然数：一、二、3 .... 等等。
valid_url No 若是表单元素值包含不合法的 URL，返回 FALSE
valid_email No 若是表单元素值包含不合法的 email 地址，返回 FALSE
valid_emails No 若是表单元素值包含不合法的 email 地址（地址之间用逗号分割），返回 FALSE
valid_ip No 若是表单元素值不是一个合法的 IP 地址，返回 FALSE 经过可选参数 “ipv4” 或 “ipv6” 来指定 IP 地址格式。
valid_base64 No 若是表单元素值包含除了 base64 编码字符以外的其余字符，返回 FALSE
注解

这些规则也能够做为独立的函数被调用，例如:

$this->form_validation->required($string);
注解

你也可使用任何一个接受两个参数的原生 PHP 函数（其中至少有一个参数是必须的，用于传递域值）
预处理参考
下表列出了全部可用的预处理方法：

名称参数描述
prep_for_form No 将特殊字符的转换，以即可以在表单域中显示 HTML 数据，而不会破坏它
prep_url No 当 URL 丢失 “http://” 时，添加 “http://“
strip_image_tags No 移除 HTML 中的 image 标签，只保留 URL
encode_php_tags No 将 PHP 标签转成实体
注解

你也可使用任何一个接受一个参数的原生 PHP 函数。例如： trim() 、 htmlspecialchars() 、 urldecode() 等

　CI“超级对象”的问题
当Rick刚开始开发CI时，为了让CI在PHP4和PHP5下行为一致，他必须在Base4文件中使用比较“丑陋”的代码，无论丑不丑，咱们不用关心，只要CI可以在PHP4环境下工做得和PHP5同样好就好了。

还有两个问题值得在这里提一下：

你能够尝试开发一个全新的对象并让它参与工做。
你必须当心地为你的网站设计架构，由于你不能在一个控制器里调用另外一个控制器里的方法。
让咱们一个一个地来分析这两个问题。你记得我提到的T恤衫的那件事吗？在调用一个成员函数时我一直收到“Call to a member function on a non-object”的出错信息，这个出错信息产生的缘由通常是由于你调用了一个类方法，可是忘了装载这个类。换句话说，你写了下列语句：

复制代码到剪贴板PHP 代码$this->Model_name->function();可是忘记在它以前调用：

复制代码到剪贴板PHP 代码$this->load->model('Model_name');还有一些其它状况，好比，你在类的一个方法中装载了模型，而后你尝试在另外一个方法里调用模型的方法，虽然在同一个对象中，这样作也不行。因此最好的方法是在类的构造函数中装载模型，而后能够在这个类的全部方法中使用。

问题也可能更严重。若是写你本身的类，举例来讲，你可能想要使用这个类存取数据库，或在你的config文件中读取信息，换句话说，让这个类存取CI超级对象的某些部分。（如何装载你本身的类和类库会在第13章中讨论。）归纳起来，除非你的新类是一个控制器，一个模型或视图，它不能在CI超级对象中被构造。所以你不能在你的新类中写这样的代码：

复制代码到剪贴板PHP 代码$this->config->item('base_url');这不会工做的，由于对你的新类来讲，$this-> 意味着它自己，而不是CI超级对象。取而代之地，你必须经过调用Instance类用另外一个变量名（一般是 $obj）把你的新类载入CI超级对象：

复制代码到剪贴板PHP 代码$obj =& get_instance();如今你能像调用CI超级对象同样地调用它：

复制代码到剪贴板PHP 代码$obj->config->item('base_url');而且此次它能工做了。

所以，当你编写你的新类时，记得它有它本身的标识符。让咱们使用一个较简短的例子来把这个问题讲得更清楚一点。

你想要写一个library类，用向你的服务器发出页面请求的URL查找它的地理位置。这个library类有点像netGeo类，你能够在下列网址找到它：

http://www.phpclasses.org/browse/package/514.html

这个类使用一个switch函数，根据URL的地域分派不一样的网页，好比来自英国和美国的URL请求，你就返回一个英语网页，德国和奥地利的URL请求就返回一个德语网页等等。如今，完整的URL会分红两个部分：基本URL（www.mysite.com/index.php）和附加的URL部分（mypage/germanversion）。

你须要从CI的config文件中取得基本URL部分。后半段网址经过你的新类的构造函数中的switch语句生成，若是这个客户在德国，调用德国的页面函数，依次类推。当这个工做在构造函数中作完之后，你须要把结果放到一个类属性中，因此能够在同一个类的其它函数中使用，这意味着：

基本URL从CI config文件中取得，这个只能经过CI超级对象的引用得到，换句话说，你能够用 $obj->config->item('base_url'); 得到
URL的后半部分由你的新类的构造函数生成，并写到一个类属性中：$base。这个属性与CI超级对象无关，它属于你的新类，被引用为 $this->base。
装载时会用到两个关键词：$this-> 和 $obj->，在同一段代码中被引用，举例来讲：

复制代码到剪贴板PHP 代码class my_new_class{
var $base;
My_new_class()
{
$obj =& get_instance();
// geolocation code here, returning a value through a switch statement
//this value is assigned to $local_url
$this->base = $obj->config->item('base_url');
$this->base .= $local_url;
}若是你不清楚这些概念，“Call to a member function on a non-object”就会频繁的出现。上例中，若是你试着调用 $obj->base或 $this->config->item() 时，这个出错信息就出现了。

CI 有三个函数、 show_error() 、 show_404() 和 log_message(),控制错误如何在你的系统上被显示。 (不一样寻常地，这些函数是全局性的: 你不须要装载就能使用他们,用就好了!)。事实上， show_error() 和 show_404() 一般默认产生; 前一个在屏幕顶端的一个整洁的小 HTML 格式的框子中显示你的错误; 后一个在你企图请求一个不存在的网页时显示一个'404'页。

第三个函数,log_message(), 更有趣。你可能想要开发你本身的错误日志，缘由有多种多样的，其中一个是也许由于你不能访问在你的ISP的Apache上的日志文件。首先, 你须要设定权限确保 /system/logs目录是可读写的。而后你在config文件中设定logging的级别:

复制代码到剪贴板PHP 代码/*
|--------------------------------------------------------------------------
| Error Logging Threshold
|------------------------------------------------------------------------
|
| If you have enabled error logging, you can set an error threshold to
| determine what gets logged. Threshold options are:
|
| 0 = Disables logging
| 0 = Error logging TURNED OFF
| 1 = Error Messages (including PHP errors)
| 2 = Debug Messages
| 3 = Informational Messages
| 4 = All Messages
|
| For a live site you'll usually only enable Errors (1) to be logged
| otherwise your log files will fill up very fast.
|
*/
$config['log_threshold'] = 4;这样会开启日志。

若是你修改 index.php 关闭错误信息显示并不会使错误日志不工做。所以你能看到信息，但你的用户看不到。

当你开启日志后， CI 天天产生新的记录文件, 并把信息写入这个文件。可是当心, 这些记录文件能快速地变得很大。

在实际使用过程当中，你可能须要开发在某件事发生时显示特定出错信息的错误处理代码。

。。。。。。。。。。。。。。。。。。测试运行时间等等

profiler 类很是精彩，你在你的类的一个函数中插入一行代码（它在构造函数中工做，所以放在那里才有意义.) 这行代码是:

复制代码到剪贴板PHP 代码$this->output->enable_profiler(TRUE);若是你改变主意了, 你能够修改它:

复制代码到剪贴板PHP 代码$this->output->enable_profiler(FALSE);插入这行代码获得的回报，就是你能在你的屏幕上获得一个完整的报告。显示CI超级对象和你的控制器的时间花销以及$_POST数组和数据库查询等等所用的时间。在开发阶段，这个特别有用。

若是你加上你本身的基准测试，它也会显示这些。你必须使用特别的名字命名你的基准测试-他们必须包括在"_start"和"_end"中，每一组的命名都要不同：

复制代码到剪贴板PHP 代码$this->benchmark->mark('fred_start');而且, 还有：

复制代码到剪贴板PHP 代码$this->benchmark->mark('fred_end');