FuelPHP - 视图
视图是 MVC 应用程序的表示层。它将应用程序逻辑与表示逻辑分开。当控制器需要生成 HTML、CSS 或任何其他内容时,它会将任务转发给视图引擎。
FuelPHP 提供了一个简单而灵活的类 View,它具有视图引擎的所有必要功能。视图类支持视图文件的渲染。视图文件是一个嵌入了 PHP 指令的 HTML 页面。可以使用 View 类作为 PHP 数组设置视图文件的变量,并使用数组的键在视图文件中引用这些变量。让我们检查一下 View 类的一些重要方法。
forge
用途 − 创建一个新的 View 对象
参数 −以下是参数
$file − 视图文件相对于视图文件夹的路径,fuel/app/views
$data − 值数组
$filter − 设置自动编码,默认为主配置文件中的设置
返回 − 视图实例
例如,
$view = View::forge ('path/to/view', array( 'title' => "Show employee, 'employees' => $employees, ));
auto_filter
用途 − 设置是否对数据进行编码
参数 − 以下是参数
$filter − true / false
返回 − 当前视图对象
例如,
$view->auto_filter(); $view = $view->auto_filter(false);
set_filename
用途 −允许设置或更改视图文件。
参数 − 以下是参数 -
$file − 相对于视图文件夹的视图文件路径,fuel/app/views
返回 − 当前视图对象
例如,
$view = new View(); $view>set_filename('path/to/view');
set
用途 − 设置一个或多个变量的值
参数 −以下是参数
$key − 变量名称或值数组
$value − 值 / null
$filter − 编码设置,true / false
返回 − 当前视图对象
例如,
$view = new View(); $view->set(array('name' => 'Jon'));
set_global
set_global 与 set 类似,不同之处在于它适用于所有视图,并且所有视图都可以访问变量。这是一个静态方法。
View::set_global('name', 'Jon', false);
set_safe
用途 − 设置一个或多个变量的值,并启用安全编码。
参数 − 以下是参数 −
$key − 变量名称或值数组
$value −值 / null
返回 − 当前视图对象
例如,
$view = new View(); $view->set_safe(array('name' => 'Jon'), null);
获取
用途 − 获取一个或多个变量的值
参数 − 以下是参数
$key − 变量名称
$default −如果未找到键,则返回默认值
返回 − 输入键的值
例如,
$view = new View(); $name = $view>get('name'); // name = 'Jon'
render
用途 − 通过将视图文件与本地和全局变量合并,将其呈现为字符串
参数 − 以下是参数 −
$file −视图文件名
返回 − 渲染的视图文件作为字符串
例如,
$html = View::forge()->render('/path/to/view');
创建视图
为了理解视图,让我们修改控制器 Controller_Employee 的操作方法 action_show。
employee.php
<?php class Controller_Employee extends Controller { public function action_show() { return View::forge('employee/show'); } }
现在在 views 目录中创建一个文件夹 employee,位于 fuel/app/views。然后,在 employee 文件夹中创建一个文件 show.php 并添加以下代码。
show.php
<h3> 我的第一个视图 </h3>
现在,请求 url http://localhost:8080/employee/show 并产生以下结果。
将数据传递给视图
我们可以使用前面讨论过的视图方法将数据传递给视图。以下是一个简单的示例。
employee.php
class Controller_Employee extends Controller { public function action_show() { $data = array(); //存储进入视图的变量 $data['name'] = ‘Jon’; $data[‘job’] = ‘Designer’; //将视图分配给浏览器输出 return View::forge('employee/show', $data); } }
现在,在 view 文件中添加更改。
show.php
<html> <body> Hello, <?php echo $name; ?>. Your job is, <?php echo $job; ?>. </body> </html>
请求 URL 后,它将显示名称和作业,如下所示 −
视图过滤器
视图使用输出编码来传递您想要的任何内容。如果您想传递未过滤的数据,我们可以使用 set 方法。
employee.php
class Controller_Employee extends Controller { public function action_show() { $view = \View::forge('employee/show'); $view->set('name', 'Jon', true); $view->set('job', '<em>Designer</em>', false); return $view; } }
请求 URL 后,它将以强调样式显示职位详细信息,如下所示。
嵌套视图
FuelPHP 支持嵌套视图。在嵌套视图中,一个视图可以包含一个或多个视图。要在另一个视图中设置视图,我们可以使用 render 方法,如下所示。
employee.php
class Controller_Employee extends Controller { public function action_nestedview() { //assign variables $data = array(); $data['title'] = 'Home'; $data['name'] = 'Jon'; $data['job'] = 'Designer'; $views = array(); $views['head'] = View::forge('head', $data)->render(); $views['content'] = View::forge('employee/show', $data)->render(); return View::forge('layout', $views, false)->render(); } }
fuel/app/views/layout.php
<html> <head> <?php echo $head; ?> </head> <body> <?php echo $content; ?> </body> </html>
fuel/app/views/head.php
<title> <?php echo $title; ?> </title>
fuel/app/views/employee/show.php
Hello, <?php echo $name; ?>. Your job is, <?php echo $job; ?>.
请求 URL http://localhost:8080/employee/nestedview 并检查源视图后,它会给出以下代码。
<html> <head> <title>Home</title> </head> <body> Hello, Jon. Your job is, Designer. </body> </html>
模板控制器
FuelPHP 提供了一个控制器,Controller_Template,它具有内置布局概念。布局概念是使用 Controller 的 before() 和 after() 方法实现的。要使用模板控制器,我们需要使用 Controller_Template 而不是 Controller 来扩展控制器。使用 after() / before() 方法时,我们需要调用 parent::before 和 parent::after,否则模板会中断。
<?php class Controller_Test extends Controller_Template { public function before() { parent::before(); // do stuff } public function after($response) { $response = parent::after($response); // do stuff return $response; } }
template.php
这是 Fuel 中的默认模板文件。模板文件用于调用 JS、CSS、HTML 和调用视图部分。它位于 fuel/app/views/。模板用于将您的视图包装在带有页眉、页脚、侧边栏等的布局中。我们可以使用操作方法中的 $template 变量更改默认模板,如下所示。
fuel/app/classes/controller/test.php
<?php class Controller_Test extends Controller_Template { public $template = 'template_test'; public function action_index() { $this->template->title = 'Example Page'; $this->template->content = View::forge('test/index'); } }
fuel/app/views/template_test.php
<!DOCTYPE html> <html> <head> <meta charset = "utf-8"> <title><?php echo $title; ?></title> <?php echo Asset::css('bootstrap.css'); ?> </head> <body> <div> <?php echo $content; ?> </div> </body> </html>
fuel/app/views/test/index.php
<h3>My Test page</h3>
现在,请求 URL http://localhost:8080/test 并产生以下结果。
结果
<!DOCTYPE html> <html> <head> <meta charset = "utf-8"> <title>Example Page</title> <link type = "text/css" rel = "stylesheet" href = "http://localhost:8080/assets/css/bootstrap.css?1464964766" /> </head> <body> <div> <h3>My Test page</h3> </div> </body> </html>
生成查看页面
您可以使用 Fuel 的 Oil 控制台生成查看页面。以下是基本语法。
oil g controller <controller-name> <page1> <page2> ..
要生成带有主页和登录页面的管理控制器,请使用以下命令。
oil g controller admin home login
结果
Creating view: /path/to/app/fuel/app/views/admin/home.php Creating view: /path/to/app/fuel/app/views/admin/login.php Creating controller: /path/to/app/fuel/app/classes/controller/admin.php