加载静态内容 · CodeIgniter 3.0.4 中文阅读手册

# 加载静态内容 **Note**: 这篇教程假设你已经下载好 CodeIgniter ，并将其安装到你的开发环境。你要做的第一件事情是新建一个 **控制器** 来处理静态页面，控制器就是一个简单的类，用来完成你的工作，它是你整个 Web 应用程序的 “粘合剂” 。例如，当访问下面这个 URL 时: ~~~ http://example.com/news/latest/10 ~~~ 通过这个 URL 我们就可以推测出来，有一个叫做 "news" 的控制器，被调用的方法为 "latest" ，这个方法的作用应该是查询 10 条新闻条目并显示在页面上。在 MVC 模式里，你会经常看到下面格式的 URL ： ~~~ http://example.com/[controller-class]/[controller-method]/[arguments] ~~~ 在正式环境下 URL 的格式可能会更复杂，但是现在，我们只需要关心这些就够了。新建一个文件 application/controllers/Pages.php ，然后添加如下代码。 ~~~ <?php class Pages extends CI_Controller { public function view($page = 'home') { } } ~~~ 你刚刚创建了一个 Pages 类，有一个方法 view 并可接受一个 $page 参数。 Pages 类继承自 CI_Controller 类，这意味着它可以访问 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() 方法？实在是太棒了！