Codeigniter

最近准备接手改进一个别人用Codeigniter写的项目，虽然以前也有用过CI，可是是彻底按着本身的意思写的，没按CI的一些套路。用在公众的项目，最好仍是按框架规范来，因此仍是总结一下，省得之后别人再接手的时候贻笑大方。

1. 首先是 MVC

若是你还不知道 MVC ，应该尽快的学习，你会很快的体会到在 Model 中数据访问，在 Controller 中进行业务逻辑，在 Views 中编写 HTML 代码的价值。若是你以前没有使用过这种模式写过程序，你也许会皱起额头，不过你应该给本身尝试这样作的机会。

一条实践准则是把更少的东西放进 Controller ，记住 DRY 准则：不要重复造轮子。当在超过一个地方编写相同的代码时，应该根据它的类型来尝试编写一个 library， helper，或 model。好比数据库链接类，用得很频繁，就把它作成 model（系统已提供）。

一旦领悟了 MVC 的精髓，这将会成为一种习惯，你会从 MVC 简洁的代码中受益良多。

一个原则就是：复杂的操做都交给Model。Controller更像个建筑师。 Model是苦工。 View 是粉刷工。Controller 只须要把东西丢进Model里就能够了，不须要在乎数据是否异常，而后返回一个标志位以及相应的数据。这样MVC 的 架构就体现出来了。

Model其实就像一个电器如：微波炉同样，使用方法越简单越让人喜欢，(把食物放进去 －按启动 －ok，饭熟了。)接口少的好处是，Model升级代码优化的时候，对外界的耦合度不高。即便你内部写得很烂，接口也很干净，用起来也简单。

2. Application 和 System 路径

最好是把 system 和 application 文件夹放在 webroot 之外的地方，若是 index.php 放在 FTP 服务器的 /public_html/ 路径下，应该尝试把 System 放在根目录下 /system ，这样的话，只能经过 index.php 访问你的PHP文件。

不要忘记在index.php文件中修改 $system_folder 和 $application_folder 的值，$system_folder 的值应该是相对于 index.php 文件，而 $application_folder 的值是相对于 system 目录。

3. 错误报告和调试

经常犯的一个错误是忘记关闭 PHP 错误和数据库错误报告，这样作是有风险的。在任何一个公开的站点，error_reporting 应该设置为0 ，最多只能设置为 E_ERROR，数据库设置 db_debug 应该设置为 false，基于其余安全考虑，设置不显示出错信息 ini_set('display_errors', 'Off');

在你编码和调试时，应该把 error_reporting 设置为 E_ALL ，而且在把应用程序发布前解决每个注意和警告。

一种简易的方法是在 application/config/database.php 文件设置 db_debug 的值为一个常量 MP_DB_DEBUG，当网站在运行中，以下设置：

ini_set('display_errors', 'Off');
error_reporting(0);
define('MP_DB_DEBUG', false);  

 

在编码和调试中设置为：

ini_set('display_errors', 'On');
error_reporting(E_ALL);
define('MP_DB_DEBUG', true);  

4. 安全问题很重要

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

1. 过滤不良数据.
2. 验证数据以确保符合正确的类型, 长度, 大小等. (有时这一步骤也可取代第一步骤)
3. 在提交数据到你的数据库以前将其转换.

关于SQL注入，XSS，以及 CSRF ，你应该先了解它们，再决定是否采用方法来防止它们。能够参考CI手册上的安全指南 以及 输入和安全类。也许最重要的原则是在把数据提交到数据库或文件系统以前检查全部用户的输入。

• SQL注入。使用 CI 自带的 Active Record 能够解决这个问题。
• XSS (跨站脚本)。经过设置 $config['global_xss_filtering'] = TRUE; 开启自动过滤POST和COOKIE中的跨站脚本攻击，但须要消耗一些资源。也能够在每次处理POST和COOKIE的时候单独使用，把第二个参数设为TRUE，如 $this->input->post('some_data', TRUE); 表单验证类也提供了 XSS 过滤选项，如 $this->form_validation->set_rules('username', 'Username', 'trim|required|xss_clean');
• CSRF (跨站请求伪造)。CI 2.0 将内置 CSRF 检查，在 Google 上搜索 "CSRF tokens" 学习更多关于在保护表单提交和 URL 连接的知识，在 Ajax 应用方面能够搜索 "double cookie submission" 或 "双提交 cookie"。
• SPAM (垃圾留言和恶意注册)。经过保护你的邮件表单，评论表单，以及其余各类免费用户提交的数据来防止垃圾信息，一个简单的方法是只容许一个IP/User客户端在一分钟以内只能提交一次，一个比较好的方式是使用 Captcha ，CI2中内置了一个CAPTCHA的辅助函数。

5. 数据库 和 ORM

CodeIgniter 有一个自带的库 Active Record 可以帮助你在不使用 SQL 语句的状况下写查询语句。这在你不太精通 SQL 语句或不知道怎样防止SQL注入的状况下是一个很好的方法。

当你须要更强大的工具时，你能够考虑使用 Object Relational Mapper ，就是鼎鼎大名的 ORM 了，遗憾的是，CodeIgniter 没有自带 ORM 库，不过也有一些其余很好的选择。

最流行的或许是 DataMapper OverZealous Edition (DMZ)，还可使用 Doctrine (这里有一个教程)，另外一个选择 RapidDataMapper 是做者本身的做品。

6. 代码实践

编写简洁的代码，而且理解你的代码，不要只是复制粘贴别人的代码，而且不断提升编码能力。手册上的开发规范是一个能学习怎样更好编写代码的地方。

1. DRY。不要老是重复造轮子，把能重用的代码放在它应该在的地方，好比libraries, helpers 或者是 models，而不是controllers，一个经验准则：当你复制代码的时候，也许你已经第二次把它放在了错误的地方。

2. Caching (缓存)。缓存是一个提升性能的很好的方式，尤为是减小数据库的访问。能够参考网页缓存和数据库缓存，或者在论坛上搜索其余的可选方案，好比 MP_Cache 是做者本身的做品。

3. HTTP headers (HTTP头部)。在客户端你可以经过单独发送HTTP头部使浏览器缓存页面来提升性能，当你使用 AJAX 的时候你也须要了解它来禁止浏览器缓存。

一个禁止缓存的例子：

$this->output->set_header("Last-Modified: " . gmdate("D, d M Y H:i:s") . " GMT");
$this->output->set_header("Cache-Control: no-store, no-cache, must-revalidate");
$this->output->set_header("Cache-Control: post-check=0, pre-check=0", false);
$this->output->set_header("Pragma: no-cache");  

 

一个长时间保持缓存的例子(好比 css, javascript)：

$this->output->set_header('Cache-Control: private, pre-check=0, post-check=0, max-age=2592000');
$this->output->set_header('Expires: ' . gmstrftime("%a, %d %b %Y %H:%M:%S GMT", time() + 2592000));
$this->output->set_header('Last-Modified: ' . gmstrftime("%a, %d %b %Y %H:%M:%S GMT", time() - 20));  

7. 模板渲染没必要每次都调用 header 与 footer

在 MY_Controller 头部和 __construct 函数中添加如下内容，用于设定默认的模版信息，其中 SITE_NAME 须要本身在 application/config/constants.php 里面本身定义：

class MY_Controller extends CI_Controller {

    protected $_data;    // 模版传值数组
    protected $_tplext;  // 默认模版后缀
    protected $_header;  // 默认头部模版
    protected $_footer;  // 默认底部模版


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

        $this->_data['title'] = SITE_NAME;
        $this->_tplext = '.php';
        $this->_header = 'templates/header';
        $this->_footer = 'templates/footer';

        // 开发模式下开启性能分析
        if (ENVIRONMENT === 'development') {
            $this->output->enable_profiler(TRUE);
        }
    }

}

8. 没必要全部的类都继承 CI_Controller

新增的控制器再也不继承 CI_Controller，而改继承 MY_Controller：

class Index extends MY_Controller {

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


    /**
     * 前台首页
     */
    public function index () {
        $this->_data['title'] = '首页';  // 不指定则使用默认标题 SITE_NAME
        $this->_view('index/index');
    }

}

末了，再补充两个：

9. CodeIgniter的文件结构

cache用以存储缓存文件，codeigniter文件夹包含了CI的基类CI_Base，为了兼容php4和php5，CI_Base有两个版本，其中php4版本的CI_Base继承于CI_Loader。libraries里存放了大部分经常使用的类库，最主要的三个类：Model，View和Cotronller，本身写的任何mvc都要继承于已有的mvc类；helpers里是一些函数（方法）集合，用以辅助其余模块的方便工做。language是一个语言包，用以支持多语言。

application文件夹用以存储您的应用程序，CI已经在内部为您增长了一些子文件，包括models、views、controllers、config、errors、hooks和libraries。其中前三个文件夹是用以建立模型、视图和控制器的。您的大部分工做都应该是建立属于本身的MVC，并可在config里加入配置文件，libraries里加入一些对象和方法，用来辅助您的模型和控制器工做。而hooks也是对CI_Hooks的扩展，具体内容见下面的章节。

10. CodeIgniter的工做过程

当有一个http请求时，如http：//www.google.com/blog/，首先进入CI的引导文件index.php。接下来咱们看看index.php里作了哪些事情。

index首先设置了应用程序的文件夹名称为application，系统的文件夹名称为system，而后作了一系列严格的判断并转换为unix风格的服务器绝对文件路径，具体说来定义了两个比较重要的常量，APPPATH，应用程序的文件夹路径，根据分析可知，该路径能够和system同级：htdocs/application/，也能够放到system文件夹里面，做为其子文件夹：htdocs/system/application/，但推荐采用第二种方式，这样显得比较整齐；BASEPATH，网站文档的基本文件路径，写出来大概是htdoc/system/；到最后，index引导文件引入了codeigniter/codeigniter.php里。接下来咱们看看codeigniter里作了什么事情。

codeigniter.php一上来就引入了三个文件：Common.php，Compat.php和config/constants.php，其中Common里包含了一些函数，用于载入类库的load_class，记录日志的log_message，和引入错误页面的show_404是几个重要的函数；Compat主要解决了php4和php5中的函数不兼容问题，而constants则定义了一些读写文件权限的常量。

紧接着codeigniter载入了第一个类库，Benchmark，这个类库最简单的一个应用就是计算网页从开始到编译结束所花掉的时间，因此您在编译开始的地方打上一个标记，渲染结束后再打上一个标记，就能够算出其中花费的时间了。

接着载入了第二个类库，Hooks，这个类库和Benchmark同样都是在system\libraries下，这个类库的做用是在程序开始编译以前给您提供一个执行其余事情的机会，Hooks会您执行其余任务提供了大约8个机会，具体参见用户指南。在这里，它导入了第一个钩子。

而后分别载入了Config，URI，Router，Output等类库，接着，检查是否有cache_override的钩子，这个钩子能够容许您调度本身的函数来替代Output类的_display_cache方法，若是没有，直接调用Output的_display_cache，检查是否有缓存内容，若是有，则直接输出缓存，退出；若是没有，则接着往下执行。

此后，继续载入Input，Language，注意此前载入的类库都是一个引用；而后又一个重要的载入，那就是CI_Base对象的载入，首先会判断php的版本，若是是php4版本的，则会首先载入Loader，而后载入Base4，由于Base4中CI_Base继承于CI_Loader,而Base5中，CI_Base与CI_Loader没有继承关系。

下一步，也是真正关键的一步了，这一步开始载入了一个Controller类，这个是个实例，而不是引用；而后经过Router来解析http地址，得到控制器和方法的名字，接着看application\controllers里是否存在这样的控制器和方法，若是没有，则报错；若是有，则开始判断。

小结

先总结这么多，之后有再补充。