教程 − 加载静态内容
注意: 本教程假定你已经下载和安装了CodeIgniter开发环境。
首先,你需要创建一个可以处理静态内容请求的控制器类。控制器,是一个用来代理完成某项任务的PHP类,它充当基于MVC架构应用程序的“粘合剂”(译者注:控制器用来粘合/协调不同模型和视图。随着教程的深入,你会更深刻的理解这一点)。
举例来说,假设存在某个针对如下URL的请求:
仔细观察此URL地址,我们可以猜测它所完成的任务:存在某个类名为"news"的控制器,调用此类下的"latest"方法用来提取10条最新新闻,然后解析显示在最终浏览器页面上。在基于MVC架构思想的应用程序中,我们经常会见到如下典型URL格式:
在实际项目中,以上典型格式可能会存在变化趋于复杂。但到目前为止,了解这一典型格式已然足够。
创建一个控制器文件application/controllers/pages.php,并编写如下代码:
你已经创建了一个名为"pages"的类, 包含一个名为"view"的方法,并定义了一个名为 _$page_ 的参数。这个pages类继承了CI_Controller类。这就意味着这个新的pages类可以继承CI_Controller (_system/core/Controller.php_) 类里面定义的方法和变量。 **这个控制器会成为你的网站程序每次请求的中心**。在非常技术性的CodeIgniter的讨论中,我们把它称为 _超级对象_。就像任何php类一样,在你自己的控制器中,使用$this来调用它,这样就可以实现用 _$this_ 来加载所有变量、视图和对这个框架进行一般操作。 现在你已经创建了自己的第一个方法,是时候来做几个基础的页面模板了。我们将要创建两个 "视图" (模板页面) ,也就是页面的页头(header)和页脚(footer)。 创建页头文件 _application/views/templates/header.php_ ,代码如下。
<?php
class Pages extends CI_Controller {
public function view($page = 'home')
{
}
}
页头文件包括在正式加载视图前需要的基本的HTML代码。同时,这里还输出了 _$title_ 变量,一会儿我们会在控制器中对它进行定义。现在我们来创建一个页脚 _application/views/templates/footer.php_ ,代码如下:
<html>
<head>
<title><?php echo $title ?> - CodeIgniter 2 Tutorial</title>
</head>
<body>
<h1>CodeIgniter 2 Tutorial</h1>
<strong>© 2011</strong>
</body>
</html>
为控制器添加逻辑结构 (Adding logic to the controller)
之前你创建了一个控制器并定义了一个方法view()。这个方法里定义了一个参数,它的值是即将加载的页面的名称。静态页面的模板将被放在 application/views/pages/ 文件夹中。
在那个文件夹中需要创建两个文件,分别为 home.php 和 about.php。在这两个文件中敲一些任何你喜欢的内容进去并保存。如果你喜欢特别不寻常的内容,可以试试敲“Hello World!”。
为了能加载那些页面,你需要检查一下它们是否存在:
- public function view($page = 'home')
- {
- if ( ! file_exists(APPPATH.'/views/pages/'.$page.'.php'))
- {
- // 页面不存在
- show_404();
- }
- $data['title'] = ucfirst($page); // 将title中的第一个字符大写
- $this->load->view('templates/header', $data);
- $this->load->view('pages/'.$page, $data);
- $this->load->view('templates/footer', $data);
- }
此时,如果页面存在,它将被加载,同时,页头和页脚也会显示出来。如果页面不存在,那么就会显示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,这样就可以摆脱下面的既定规则了。
我们来试试吧。打开路由文件 application/config/routes.php ,并添加下面两行代码,并删除 $route 数组中的其他代码。
- $route['default_controller'] = 'pages/view';
- $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