CodeIgniter4 教程：构建静态页面控制器-优快云博客

CodeIgniter4 教程：构建静态页面控制器

CodeIgniter4 Open Source PHP Framework (originally from EllisLab) 项目地址: https://gitcode.com/gh_mirrors/co/CodeIgniter4

前言

在Web开发中，静态页面（如"关于我们"、"联系方式"等）是每个网站的基本组成部分。本文将详细介绍如何在CodeIgniter4框架中优雅地实现静态页面的管理和展示。

路由配置

路由是Web应用的入口，它决定了URL如何映射到控制器和方法。在CodeIgniter4中，路由配置位于app/Config/Routes.php文件中。

默认情况下，CodeIgniter4已经配置了一个基本路由：

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

这意味着当访问网站根目录时，将调用Home控制器的index方法。

为了处理静态页面，我们需要添加以下路由规则：

$routes->get('pages', 'Pages::index');
$routes->get('(:segment)', 'Pages::view/$1');

这些规则的解释：

第一条规则匹配/pages路径，调用Pages控制器的index方法
第二条规则使用(:segment)占位符捕获任意URI段，传递给Pages控制器的view方法

路由匹配是从上到下进行的，第一个匹配的规则将被执行。

创建控制器

控制器是MVC架构中的核心组件，负责处理业务逻辑。我们创建一个Pages控制器：

<?php namespace App\Controllers;

use CodeIgniter\Exceptions\PageNotFoundException;

class Pages extends BaseController
{
    public function index()
    {
        return view('welcome_message');
    }

    public function view($page = 'home')
    {
        if (! is_file(APPPATH . 'Views/pages/' . $page . '.php')) {
            throw new PageNotFoundException($page);
        }

        $data['title'] = ucfirst($page);

        return view('templates/header', $data)
            . view('pages/' . $page)
            . view('templates/footer');
    }
}

关键点说明：

控制器继承BaseController，后者又继承CodeIgniter\Controller
view方法接受一个参数$page，默认值为'home'
使用is_file()检查请求的页面是否存在
如果页面不存在，抛出PageNotFoundException（404错误）
使用ucfirst()函数将页面名称首字母大写作为标题
通过拼接多个视图来构建完整页面

视图组织

良好的视图组织能提高代码可维护性。我们采用以下结构：

公共模板：
- templates/header.php - 页面头部
- templates/footer.php - 页面底部
静态页面：
- pages/home.php - 首页内容
- pages/about.php - 关于页面内容

头部模板示例

<!doctype html>
<html>
<head>
    <title>CodeIgniter Tutorial</title>
</head>
<body>
    <h1><?= esc($title) ?></h1>

注意使用了esc()函数对输出进行转义，防止XSS攻击。

底部模板示例

    <em>&copy; 2022</em>
</body>
</html>

静态页面示例

home.php内容示例：

<p>欢迎访问我们的首页！</p>

about.php内容示例：

<p>这里是关于我们的信息。</p>

开发注意事项

文件系统大小写敏感：
- 开发环境（如Windows/macOS）可能不区分大小写，但生产环境（Linux服务器）区分
- 必须确保文件名大小写与实际引用一致
视图加载顺序：
- 控制器中视图的加载顺序决定了页面渲染顺序
- 通常顺序是：header → 内容 → footer
错误处理：
- 使用PageNotFoundException处理不存在的页面请求
- 自动返回404状态码和错误页面

测试应用

启动开发服务器：

php spark serve

访问以下URL测试效果：

| URL | 预期结果 | |----------------------|---------------------------------| | / | 默认欢迎页面 | | /pages | Pages控制器的index方法 | | /home | 显示home.php内容 | | /about | 显示about.php内容 | | /不存在的页面 | 显示404错误页面 |