使用composer构建自己的php框架(fizzday)

【Fizzday05】构建MVC之视图View

2017-07-31  本文已影响12512人  fizzday

View的职责范围:

view 干的事, 不多也不少, 就是通过view加载视图, 同时分配变量到视图, 所以, 他所做的工作基本包括:

  1. 加载视图, 所以需要有个加载视图的方法, 我们定义为 make()
  2. 分配变量, 我们需要有个方法可以承载变量, 定义为 with()
  3. 我们要让他能够以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原生模板语法, 后边会一点点探究

配置

同样的, 为了更加简单, 以及做好分离, 我们加入可配置选项, 通过一个配置控制是否启用模板, 减少不必要的模板初始化加载消耗

<?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数据库等等等等......

框架github地址
个人主页

上一篇下一篇

猜你喜欢

热点阅读