加载静态内容
Note: 这篇教程假设你已经下载好 CodeIgniter ,并将其 安装到你的开发环境。
你要做的第一件事情是新建一个 控制器 来处理静态页面,控制器就是一个简单的类,用来完成你的工作,它是你整个 Web 应用程序的 “粘合剂” 。
例如,当访问下面这个 URL 时:
通过这个 URL 我们就可以推测出来,有一个叫做 "news" 的控制器,被调用的方法为 "latest" ,这个方法的作用应该是查询 10 条新闻条目并显示在页面上。在 MVC 模式里,你会经常看到下面格式的 URL :
在正式环境下 URL 的格式可能会更复杂,但是现在,我们只需要关心这些就够了。
新建一个文件 application/controllers/Pages.php ,然后添加如下代码。
- <?php
- class Pages extends CI_Controller {
- public function view($page = 'home')
- {
- }
- }
你刚刚创建了一个 Pages 类,有一个方法 view 并可接受一个 $page 参数。Pages 类继承自 CIController 类,这意味着它可以访问 CI_Controller类( _system/core/Controller.php )中定义的方法和变量。
控制器将会成为你的 Web 应用程序中的处理请求的核心,在关于 CodeIgniter的技术讨论中,这有时候被称作 超级对象 。和其他的 PHP 类一样,可以在你的控制器中使用 $this 来访问它,通过 $this 你就可以加载类库、视图、以及针对框架的一般性操作。
现在,你已经创建了你的第一个方法,是时候创建一些基本的页面模板了,我们将新建两个视图(页面模板)分别作为我们的页脚和页头。
新建页头文件 application/views/templates/header.php 并添加以下代码:
- <html>
- <head>
- <title>CodeIgniter Tutorial</title>
- </head>
- <body>
- <h1><?php echo $title; ?></h1>
页头包含了一些基本的 HTML 代码,用于显示页面的主视图之前的内容。另外,它还打印出了 $title 变量,这个我们后面讲控制器的时候再讲。现在,再新建个页脚文件 application/views/templates/footer.php ,然后添加以下代码:
- <em>© 2015</em>
- </body>
- </html>
在控制器中添加逻辑
你刚刚新建了一个控制器,里面有一个 view() 方法,这个方法接受一个参数用于指定要加载的页面,静态页面模板位于 application/views/pages/ 目录。
在该目录中,再新建两个文件 home.php 和 about.php ,在每个文件里随便写点东西然后保存它们。如果你没什么好写的,就写 "Hello World!" 吧。
为了加载这些页面,你需要先检查下请求的页面是否存在:
- public function view($page = 'home')
- {
- if ( ! file_exists(APPPATH.'views/pages/'.$page.'.php'))
- {
- // Whoops, we don't have a page for that!
- show_404();
- }
- $data['title'] = ucfirst($page); // Capitalize the first letter
- $this->load->view('templates/header', $data);
- $this->load->view('pages/'.$page, $data);
- $this->load->view('templates/footer', $data);
- }
当请求的页面存在,将包括页面和页脚一起被加载并显示给用户,如果不存在,会显示一个 "404 Page not found" 错误。
第一行检查页面是否存在,file_exists() 是个原生的 PHP 函数,用于检查某个文件是否存在,show_404() 是个 CodeIgniter 内置的函数,用来显示一个默认的错误页面。
在页头文件中,$title 变量用来自定义页面的标题,它是在这个方法中赋值的,但是注意的是并不是直接赋值给 title 变量,而是赋值给一个 $data 数组的title 元素。
最后要做的是按顺序加载所需的视图,view() 方法的第二个参数用于向视图传递参数,$data 数组中的每一项将被赋值给一个变量,这个变量的名字就是数组的键值。所以控制器中 $data['title'] 的值,就等于视图中的 $title 的值。
路由
控制器现在开始工作了!在你的浏览器中输入 [your-site-url]index.php/pages/view来查看你的页面。当你访问 index.php/pages/view/about 时你将看到 about 页面,包括页头和页脚。
使用自定义的路由规则,你可以将任意的 URI 映射到任意的控制器和方法上,从而打破默认的规则:
http://example.com/[controller-class]/[controller-method]/[arguments]
让我们来试试。打开文件 application/config/routes.php 然后添加如下两行代码,并删除掉其他对 $route 数组赋值的代码。
- $route['default_controller'] = 'pages/view';
- $route['(:any)'] = 'pages/view/$1';
CodeIgniter 从上到下读取路由规则并将请求映射到第一个匹配的规则,每一个规则都是一个正则表达式(左侧)映射到 一个控制器和方法(右侧)。当有请求到来时,CodeIgniter首先查找能匹配的第一条规则,然后调用相应的控制器和方法,可能还带有参数。
你可以在关于 URI 路由的文档 中找到更多信息。
这里,第二条规则中 $routes 数组使用了通配符 (:any) 可以匹配所有的请求,然后将参数传递给 Pages 类的 view() 方法。
现在访问 index.php/about 。路由规则是不是正确的将你带到了控制器中的 view() 方法?实在是太棒了!