视图

视图只是一个网页或页面片段,例如头部、尾部、侧边栏等。事实上,如果需要这种层次结构,可以将视图灵活地嵌入其他视图(嵌入其他视图等)。

视图从不直接调用,它们必须由控制器或 视图路由 加载。

请记住,在 MVC 框架中,控制器充当交通警察角色,因此它负责获取特定视图。如果你还没有阅读 控制器 页面,在继续之前应该阅读它。

使用你在控制器页面中创建的示例控制器,让我们为它添加一个视图。

创建视图

使用你的文本编辑器,创建一个名为 blog_view.php 的文件,并将此内容放入其中:

<html>
    <head>
        <title>我的博客</title>
    </head>
    <body>
        <h1>欢迎访问我的博客!</h1>
    </body>
</html>

然后将该文件保存到你的 app/Views 目录中。

显示视图

要加载和显示特定的视图文件,你需要在控制器中使用以下代码:

return view('name');

其中 name 是你的视图文件的名称。

重要

如果省略了文件扩展名,则视图预期以 .php 扩展名结尾。

现在,在 app/Controllers 目录中创建一个名为 Blog.php 的文件,并将此内容放入其中:

<?php

namespace App\Controllers;

class Blog extends BaseController
{
    public function index()
    {
        return view('blog_view');
    }
}

打开位于 app/Config/Routes.php 的路由文件,并查找“路由定义”。 添加以下代码:

use App\Controllers\Blog;

$routes->get('blog', [Blog::class, 'index']);

如果你访问你的网站,应该可以看到你的新视图。URL 类似于这样:

example.com/index.php/blog/

加载多个视图

如果控制器内有多个 view() 调用,CodeIgniter 将智能地处理它们。如果发生多次调用,它们将被追加在一起。例如,你可能希望有一个头部视图、菜单视图、内容视图和页脚视图。可能如下所示:

<?php

namespace App\Controllers;

use CodeIgniter\Controller;

class Page extends Controller
{
    public function index()
    {
        $data = [
            'page_title' => 'Your title',
        ];

        return view('header')
            . view('menu')
            . view('content', $data)
            . view('footer');
    }
}

在上面的示例中,我们使用了“动态添加的数据”,稍后你会看到。

在子目录中存储视图

如果你更喜欢那种组织方式,也可以将视图文件存储在子目录中。 在这种情况下,在加载视图时需要包括目录名称。例如:

return view('directory_name/file_name');

命名空间视图

你可以在命名空间下的 View 目录中存储视图,并加载那个视图,就像它带有命名空间一样。 尽管 PHP 不支持从命名空间加载非类文件,但 CodeIgniter 提供了这个功能,以便以模块化的方式打包视图以进行轻松重用或分发。

如果你在 自动加载器 中有一个映射了 PSR-4 命名空间 Example\Blogexample/blog 目录,你可以像命名空间一样检索视图文件。

按照此示例,你可以通过在视图名称前加上命名空间来加载 example/blog/Views 中的 blog_view.php 文件:

<?php

return view('Example\Blog\Views\blog_view');

缓存视图

你可以通过在第三个参数中传递 cache 选项和缓存视图的秒数来缓存 view() 函数的视图:

// Cache the view for 60 seconds
return view('file_name', $data, ['cache' => 60]);

默认情况下,视图将使用视图文件本身的相同名称进行缓存。你可以通过传递 cache_name 和希望使用的缓存 ID 来自定义此名称:

// Cache the view for 60 seconds
return view('file_name', $data, ['cache' => 60, 'cache_name' => 'my_cached_view']);

向视图添加动态数据

通过 view() 函数的第二个参数中的数组,控制器的数据传递给视图。这里有个例子:

$data = [
    'title'   => 'My title',
    'heading' => 'My Heading',
    'message' => 'My Message',
];

return view('blog_view', $data);

让我们在控制器文件中试一试。打开它并添加这段代码:

<?php

namespace App\Controllers;

class Blog extends BaseController
{
    public function index()
    {
        $data['title']   = 'My Real Title';
        $data['heading'] = 'My Real Heading';

        return view('blog_view', $data);
    }
}

现在打开你的视图文件,并将文本更改为与数据数组中的数组键对应的参数:

<html>
<head>
    <title><?= esc($title) ?></title>
</head>
<body>
    <h1><?= esc($heading) ?></h1>

    <h2>My Todo List</h2>

    <ul>
    <?php foreach ($todo_list as $item): ?>

        <li><?= esc($item) ?></li>

    <?php endforeach ?>
    </ul>

</body>
</html>

然后在你一直使用的 URL 加载页面,你应该可以看到变量被替换了。

saveData 选项

传入的数据在对 view() 的后续调用中保留。如果在单个请求中多次调用该函数,则不必为每个 view() 传递所需的数据。

但这可能无法防止任何数据“渗透”到其他视图中,从而潜在地造成问题。如果你更喜欢在一次调用后清除数据,可以将 saveData 选项传递到第三个参数中的 $option 数组中。

$data = [
    'title'   => 'My title',
    'heading' => 'My Heading',
    'message' => 'My Message',
];

return view('blog_view', $data, ['saveData' => false]);

另外,如果你希望 view() 函数的默认功能是在调用之间清除数据,可以在 app/Config/Views.php 中将 $saveData 设置为 false

创建循环

你传递给视图文件的数组不限于简单变量。你可以传递多维数组,它可以循环以生成多行。例如,如果从数据库中拉取数据,它通常以多维数组的形式出现。

这是一个简单的例子。将此内容添加到你的控制器中:

<?php

namespace App\Controllers;

class Blog extends BaseController
{
    public function index()
    {
        $data = [
            'todo_list' => ['Clean House', 'Call Mom', 'Run Errands'],
            'title'     => 'My Real Title',
            'heading'   => 'My Real Heading',
        ];

        return view('blog_view', $data);
    }
}

现在打开你的视图文件并创建一个循环:

<html>
<head>
    <title><?= esc($title) ?></title>
</head>
<body>
    <h1><?= esc($heading) ?></h1>

    <h2>My Todo List</h2>

    <ul>
    <?php foreach ($todo_list as $item): ?>

        <li><?= esc($item) ?></li>

    <?php endforeach ?>
    </ul>

</body>
</html>