[CodeIgniter4]讲解-加载静态页

讲解

本教程旨在向您介绍CodeIgniter框架和MVC体系结构的基本原理。它将向您展示如何以逐步的方式构造基本的CodeIgniter应用程序。

在本教程中，您将创建一个基本的新闻应用程序。您将从编写可加载静态页面的代码开始。接下来，您将创建一个新闻部分，该部分将从数据库中读取新闻项。最后，您将添加一个表单以在数据库中创建新闻项。

本教程将主要关注：

  • 模型-视图-控制器基础知识
  • 路由基础
  • 表格验证
  • 使用“查询生成器”执行基本数据库查询

整个教程分为几页，每页仅解释CodeIgniter框架功能的一小部分。您将浏览以下页面：

  • 简介，此页面为您提供了预期的概述。
  • 静态页面，它将教您控制器，视图和路由的基础知识。
  • 新闻部分，您将在这里开始使用模型，并将进行一些基本的数据库操作。
  • 创建新闻项，这将引入更高级的数据库操作和表单验证。
  • 结论，这将为您提供进一步阅读和其他资源的一些指示。

享受您对CodeIgniter框架的探索。

加载静态页

Note: 本教程假设你已经下载好 CodeIgniter，并将其 安装 到你的开发环境。

首先你需要新建一个 控制器 来处理静态页。控制器就是用来帮助你完成工作的一个简单的类，它是你整个 Web 应用程序的"粘合剂"。

CI3 需要$this->load->view 现在CI4 view('welcome_message');即可

例如，当访问下面这个 URL 时:

根据此 URL 我们可以推测出有一个名称为 "news" 的控制器，被调用的方法为 "latest"，"latest" 方法的作用应该是查询10条新闻条目并展示在页面上。 在MVC模式里，你会经常看到下面格式的 URL:

在正式环境下 URL 的格式可能会更复杂，但现在，我们只需要知道这些就够了。

新建一个文件 application/Controllers/Pages.php，然后添加如下代码：

<?php
class Pages extends CodeIgniter\Controller {

        public function view($page = 'home')
        {
    }
}

你刚创建了一个 Pages 类，有一个方法 view 并可接受一个 $page 的参数。Pages 类继承自 CodeIgniter\Controller 类，这意味着它可以访问 CodeIgniter\Controller 类 (system/Controller.php) 中定义的方法和变量。

控制器将是你 Web 应用程序中处理请求的核心。和其他的 PHP 类一样，可以在你的控制器中使用 $this 来访问它。

现在，你已经创建了你的第一个方法，是时候创建一些基本的页面模板了。我们将新建两个 "views" (页面模板) 分别作为我们的页头和页脚。

新建页头文件 application/Views/Templates/Header.php 并添加以下代码：

<!doctype html>
<html>
<head>
        <title>CodeIgniter Tutorial</title>
</head>
<body>

        <h1><?= $title; ?></h1>

页头包含了一些基本的 HTML 代码，用于展示页面主视图之前的内容。同时，它还打印出了 $title 变量，这个我们之后讲控制器的时候再细说。 现在，再新建个页脚文件 application/Views/Templates/Footer.php，然后添加以下代码：

                <em>&copy; 2016</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!
                throw new \CodeIgniter\PageNotFoundException($page);
        }

        $data['title'] = ucfirst($page); // Capitalize the first letter

        echo view('Templates/Header', $data);
        echo view('Pages/'.$page, $data);
        echo view('Templates/Footer', $data);
}

当请求的页面存在时，将给用户加载并展示出一个包含页头页脚的页面。如果不存在，会显示 "404 Page not found" 的错误页面。

此事例方法中，第一行用以检查界面是否存在，file_exists() 是原生的 PHP 函数，用于检查某个文件是否存在。PageNotFoundException 是 CodeIgniter 的内置函数，用来展示默认的错误页面。

在页头模板文件中，$title 变量代表页面的自定义标题，它是在方法中被赋值的，但并不是直接赋值给 title 变量，而是赋值给 $data 数组中的 title 元素。

最后要做的就是按顺序加载所需的视图，view() 方法中的参数代表要展示的视图文件名称。$data 数组中的每一个元素将被赋值给一个变量，这个变量的名字就是数组的键值。所以控制器中 $data['title'] 的值，就等于视图中 $title 的值。

路由

控制器已经开始工作了！在你的浏览器中输入 [your-site-url]index.php/pages/view 来查看你的页面。当你访问 index.php/pages/view/about 时你将看到包含页头和页脚的 about 页面。

使用自定义的路由规则，你可以将任意的 URL 映射到任意的控制器和方法上，从而打破默认的规则： http://example.com/[controller-class]/[controller-method]/[arguments]

让我们来试试。打开路由文件 application/Config/Routes.php 然后添加如下两行代码，并删除掉其它对 $route 数组赋值的代码。

$routes->setDefaultController('Pages/view');
$routes->add('(:any)', 'Pages::view/$1');

CodeIgniter 读取路由的规则为从上到下，并将请求映射到第一个匹配的规则。每个规则都是一个正则表达式（左侧）映射到一个控制器和方法（右侧）。当获取到请求时，CodeIgniter 首先查找能匹配到的第一条规则，然后调用相应的可能存在参数的控制器和方法。

你可以在关于 URL路由的文档 中找到更多信息。

路由事例的第二条规则 $routes 数组中使用了通配符 (:any) 来匹配所有的请求，然后将参数传递给 Pages 类的 view() 方法。

为请求默认的控制器，你必须确定当前路由未被定义或重新编写过。默认的路由文件 does 下存在一个处理网站根目录的路由 (/) 规则.删除以下的路由来确保 Pages 控制器可以访问到我们的 home 页面：

$routes->add('/', 'Home::index');

现在访问 index.php/about。路由规则是不是正确的将你带到了控制器中的 view() 方法？太酷了！

posted @ 2020-02-28 16:04  landv  阅读(722)  评论(0)  编辑  收藏  举报