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 并产生以下结果。

Show View

将数据传递给视图

我们可以使用前面讨论过的视图方法将数据传递给视图。以下是一个简单的示例。

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 后,它将以强调样式显示职位详细信息,如下所示。

View Filter

嵌套视图

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