教程 − 加载静态内容

注意: 本教程假定你已经下载和安装了CodeIgniter开发环境。

首先,你需要创建一个可以处理静态内容请求的控制器类。控制器,是一个用来代理完成某项任务的PHP类,它充当基于MVC架构应用程序的“粘合剂”(译者注:控制器用来粘合/协调不同模型和视图。随着教程的深入,你会更深刻的理解这一点)。

举例来说,假设存在某个针对如下URL的请求:

  1. http://example.com/news/latest/10
仔细观察此URL地址,我们可以猜测它所完成的任务:存在某个类名为"news"的控制器,调用此类下的"latest"方法用来提取10条最新新闻,然后解析显示在最终浏览器页面上。在基于MVC架构思想的应用程序中,我们经常会见到如下典型URL格式:
  1. http://example.com/[控制器类名]/[控制器方法名]/[所需参数]
在实际项目中,以上典型格式可能会存在变化趋于复杂。但到目前为止,了解这一典型格式已然足够。

创建一个控制器文件application/controllers/pages.php,并编写如下代码:

  1. <?php
  2. class Pages extends CI_Controller {
  3. public function view($page = 'home')
  4. {
  5. }
  6. }
你已经创建了一个名为"pages"的类, 包含一个名为"view"的方法,并定义了一个名为 _$page_ 的参数。这个pages类继承了CI_Controller类。这就意味着这个新的pages类可以继承CI_Controller (_system/core/Controller.php_) 类里面定义的方法和变量。 **这个控制器会成为你的网站程序每次请求的中心**。在非常技术性的CodeIgniter的讨论中,我们把它称为 _超级对象_。就像任何php类一样,在你自己的控制器中,使用$this来调用它,这样就可以实现用 _$this_ 来加载所有变量、视图和对这个框架进行一般操作。 现在你已经创建了自己的第一个方法,是时候来做几个基础的页面模板了。我们将要创建两个 "视图" (模板页面) ,也就是页面的页头(header)和页脚(footer)。 创建页头文件 _application/views/templates/header.php_ ,代码如下。
  1. <html>
  2. <head>
  3. <title><?php echo $title ?> - CodeIgniter 2 Tutorial</title>
  4. </head>
  5. <body>
  6. <h1>CodeIgniter 2 Tutorial</h1>
页头文件包括在正式加载视图前需要的基本的HTML代码。同时,这里还输出了 _$title_ 变量,一会儿我们会在控制器中对它进行定义。现在我们来创建一个页脚 _application/views/templates/footer.php_ ,代码如下:
  1. <strong>&copy; 2011</strong>
  2. </body>
  3. </html>

为控制器添加逻辑结构 (Adding logic to the controller)

之前你创建了一个控制器并定义了一个方法view()。这个方法里定义了一个参数,它的值是即将加载的页面的名称。静态页面的模板将被放在 application/views/pages/ 文件夹中。

在那个文件夹中需要创建两个文件,分别为 home.phpabout.php。在这两个文件中敲一些任何你喜欢的内容进去并保存。如果你喜欢特别不寻常的内容,可以试试敲“Hello World!”。

为了能加载那些页面,你需要检查一下它们是否存在:

  1. public function view($page = 'home')
  2. {
  3.  
  4. if ( ! file_exists(APPPATH.'/views/pages/'.$page.'.php'))
  5. {
  6. // 页面不存在
  7. show_404();
  8. }
  9.  
  10. $data['title'] = ucfirst($page); // 将title中的第一个字符大写
  11.  
  12. $this->load->view('templates/header', $data);
  13. $this->load->view('pages/'.$page, $data);
  14. $this->load->view('templates/footer', $data);
  15.  
  16. }

此时,如果页面存在,它将被加载,同时,页头和页脚也会显示出来。如果页面不存在,那么就会显示404错误页面。

这个方法中的第一行是检查文件是否存在的,使用的是PHP自带的函数 file_exists()show_404() 是CodeIgniter中的函数,用来调用404错误页面。

在页头模板(header.php)中,我们用 $title 变量来自定义页面标题(<title>)。而这个变量的值,我们现在在这个方法中对它进行了定义。不过,我们并没有将这个值直接赋给变量,而是将它作为一个元素赋给了 $data 数组。

最后一项,按照需要显示的顺序来加载那些视图。 view() 方法中的第二个参数是用来传递值给视图的。数组中的每个值都被定义成与它关键字相同的一个变量,如控制器中 $data['title'] 的值就等同于视图中变量$title。

设置路由(Routing)

这个控制器现在可以工作了,在浏览器中键入后面的地址 [你的网址]index.php/pages/view 就可以看到Home页面。输入 index.php/pages/view/about 也可以看到about页面,也是带页头和页脚的哦。

根据自定义路由的规则,你也可以自己定义任何控制器和方法的URI,这样就可以摆脱下面的既定规则了。

  1. http://example.com/[controller-class]/[controller-method]/[arguments]

我们来试试吧。打开路由文件 application/config/routes.php ,并添加下面两行代码,并删除 $route 数组中的其他代码。

  1. $route['default_controller'] = 'pages/view';
  2. $route['(:any)'] = 'pages/view/$1';

CodeIgniter由上而下读取路由规则然后将请求路由至第一个匹配的规则。每一个规则都是一个正则表达式(左侧)映射到一个由斜线分隔的控制器和方法名(右侧)。当有请求到来时,CodeIgniter寻找第一个匹配的路由规则,然后调用相应的控制器和方法,通常还带着参数。

更多关于路由设置的信息都在 URI 路由 文档 里。

回到上面的代码,第二行是指利用通配符 (:any) 可以使任何请求都能匹配到 $routes 数组,并且通过参数传递给pages类的view()方法。

现在,访问下 index.php/about. 看看是不是已经能正确地显示页面了呢?赞!

翻译贡献者:aolinks, borisauschina, changekale, cnsaturn, csfhc, Hex, irini, kpmving, lionskys, liuzhengyi, ljhljh235, syrdxb, wenxiao795, zzdjk6