View的职责范围:
view 干的事, 不多也不少, 就是通过view加载视图, 同时分配变量到视图, 所以, 他所做的工作基本包括:
- 加载视图, 所以需要有个加载视图的方法, 我们定义为
make() - 分配变量, 我们需要有个方法可以承载变量, 定义为
with() - 我们要让他能够以json的格式作为api返回
示例
还是 TestController.php 的 test2 方法
<?php
namespace App\Controller;
use Fizzday\FizzDB\DB;
use Fizzday\FizzView\FizzView as View;
class TestControlelr extends BaseController;
{
public function test()
{
$users = DB::table('users')->where('id', 1)->first();
print_r($users);
}
public function test2()
{
View::make('test.tes2')
->with('name', 'xiaoming')
->withAge(22);
}
}
模板中使用变量
<span>名字: <?=$name;?> </span>
<span>年龄: <?=$age;?> </span>
说明: 这里使用了魔术方法解析 withAge 为 age. 同时指定模板的时候,可以用点语法(test.test2),或者(test/test2),当然可以不指定,自动模板会找对应的目录下的文件
完善类
综合这些, 我们来完善一个简单的View类:
<?php
namespace Fizzday\FizzView;
// 自动分配模板的时候, 需要引入路由
use Fizzday\FizzRoute\Route;
class View
{
// 模板文件路径
public static $viewPath = [];
// 分配的变量数组
public static $data = [];
// 是否返回解析后的文本(发邮件等情况下会使用到), 默认false
public static $return = false;
/**
* 分配模板
* @param sting $viewName 模板名字, 如: admin.index或者admin/index
* @param boolean $type 是否返回为文本
* @return mixed 输出或返回文本
*/
public static function make($viewName = null, $type = false)
{
if (!defined('VIEW_PATH')) die("未定义 VIEW_PATH 常量");
if (!$viewName) { // 自动分配模板
if (!class_exists("Route")) die('没有保存 autoView 数据对应的类 Route ');
// 检查是否存在 $autoView 变量
if (!array_key_exists('autoView', get_class_vars("Route"))) die('获取不到保存自动模板的变量, 检查 Route::$autoView 是否存在');
$autoView = Route::$autoView;
$viewName = str_replace('\\', '.', str_replace('controller', '', strtolower($autoView['class']))) . '.' . $autoView['function'];
}
$viewFilePath = VIEW_PATH . str_replace('.', '/', $viewName) . '.php';
if (is_file($viewFilePath)) static::$viewPath[] = $viewFilePath;
else die("View file does not exist!");
if ($type) static::$return = true;
return new static;
}
/**
* 分配变量
* @param sting $key 变量key
* @param string $value 变量值
* @return obj 返回链式操作对象
*/
public static function with($key, $value = null)
{
if (is_array($key) && !empty($key)) {
foreach ($key as $k => $v) {
static::$data[$k] = $v;
}
} else static::$data[$key] = $value;
return new static;
}
/**
* 捕获未定义的方法
* @param sting $method 变量key和with组合
* @param mixed $parameters 变量值
* @return obj [description]
*/
public function __call($method, $parameters)
{
if (start_with($method, 'with')) static::with(lcfirst(substr_replace($method, '', 0, 4)), $parameters[0]);
else die("Function [$method] does not exist!");
return new static;
}
/**
* 渲染变量到模板
* @return mixed 最终页面
*/
public static function run()
{
// 获取模板文件
$viewPath = static::$viewPath;
$data = static::$data;
$return = static::$return;
if ($viewPath) {
// 分配变量
extract($data); // 抽取数组中的变量
if (ob_get_contents()) ob_end_clean(); //关闭顶层的输出缓冲区内容
ob_start(); // 开始一个新的缓冲区
foreach ($viewPath as $v) {
require $v; //加载解析后的文件
}
$content = ob_get_contents();// 获得缓冲区的内容
if (ob_get_contents()) ob_end_clean(); // 关闭缓冲区
ob_start(); //开始新的缓冲区，给后面的程序用
// 重置变量
static::reset();
// 处理返回
if ($return) return $content; // 返回文本。
else echo $content;
}
}
/**
* 重置模板输出信息
* @return [type] [description]
*/
private static function reset()
{
static::$viewPath = [];
static::$data = [];
static::$return = false;
}
}
这里为了使用方便, 加入了自动模板功能, 也就是使用 make() 方法未指定模板时, 会自动到控制器名字对应的目录下自动去寻找方法名对应的文件. 同时, 在FizzRoute.php中添加了自动模板的支持
到这里, 一个模板功能就加入了框架中, 但让, 这里为了简单, 没有做模板简化定义解析, 用的php原生模板语法, 后边会一点点探究
配置
同样的, 为了更加简单, 以及做好分离, 我们加入可配置选项, 通过一个配置控制是否启用模板, 减少不必要的模板初始化加载消耗
- 更改
~/fizzday/bootstrap/boot.php文件, 前边讲过了, 这是统一驱动文件, 所以, 我们把 view 的驱动也放到这里, 方便统一管理
- 更改
<?php
// 项目的源码根目录
define('BASE_PATH', __DIR__ . '/../');
// 配置目录
define('CONF_PATH', BASE_PATH . 'config/');
// 请求composer入口文件
require BASE_PATH . 'vendor/autoload.php';
// 路由目录
define('ROUTE_PATH', BASE_PATH.config('config.path.route').'/');
// 缓存目录
define('CACHE_PATH', BASE_PATH.config('config.path.cache').'/');
// 取别名, 这样就不需要在 routes/routes.php 中 use FizzRoute 了
class_alias('\\Fizzday\\FizzRoute\\Route', 'Route');
// 引入路由
require ROUTE_PATH . 'route.php';
// 驱动路由
Route::dispatch();
// 模板启用
if (config('config.switch.view') == 'on') {
// 模板目录
define('VIEW_PATH', BASE_PATH.config('config.path.view').'/');
class_alias('\\Fizzday\\FizzView\\View', 'View');
// 驱动 view
View::run();
}
我们可以看到, 尾部加入了 view 的相关驱动, 同时在公共配置文件~/fizzday/config/config.php 配置view的开关
到此, 一个包含mvc结构的框架就完全完成了, 可以做基本的使用了, 同时可以高度自由的DIY, 如果只是学习交流, 看到这里就可以了.
后续的文章会涉及到高级应用和优化, 比如: webapi常用的JWT认证来满足异步通信, 缓存路由,配置,数据库信息等提高执行效率, 增加高可用性, 配置集群机器支持多slave数据库等等等等......
