TP6源碼解析,ThinkPHP6模板編譯流程詳解

public function index(View $view)
{
    //定義一個data變量，是個關聯數組
    $data = [
        'data'=>'我是變量data',
        'msg'=>'我是變量msg'
    ];
    //直接調用View實例中的fetch方法進行渲染。並把data傳入進去
    return    $view->fetch('index',$data);
    //第二種方式
   $strings = "{$data}-{$msg}";
   return   $view->assign($data)->display($strings,$data);
}

public function fetch(string $template = '', array $vars = []): string
{
    //調用類中的getContent方法，並將模板文件、渲染的數據
    //封裝成匿名函數傳入到getContent方法中
    return $this->getContent(function () use ($vars, $template) {
        $this->engine()->fetch($template, array_merge($this->data, $vars));
    });
}

//這個方法，主要就是把傳入過來的匿名函數給運行一下
//通過ob_系列函數捕捉到緩衝區的輸出
//然後將捕捉到的緩衝區內容返回
protected function getContent($callback): string
{
    //開啟緩存
    ob_start();
    //取消緩存輸出到頁面上
    ob_implicit_flush(0);
    //開始渲染
    try {
        //執行閉包
        $callback();
    } catch (\Exception $e) {
        //如果閉包函數執行失敗則清空緩存
        ob_end_clean();
        //然後彈出異常
        throw $e;
    }
    //獲取並清空緩存
    $content = ob_get_clean();
    //如果filter有閉包。一般為替換當前頁面的什麼東西。執行一下
    if ($this->filter) {
        $content = call_user_func_array($this->filter, [$content]);
    }
    //最後直接返回
    return $content;
}

//大概就是獲取視圖驅動，然後傳入模板和數據，渲染模板
 $this->engine()->fetch($template, array_merge($this->data, $vars));

//這個就不多解釋什麼了，主要就是獲取視圖驅動的實例
public function engine(string $type = null)
{
    return $this->driver($type);
}

public function fetch(string $template, array $vars = []): void
    //判斷是否有數據如果有則合併this->data
    if ($vars) {
        $this->data = array_merge($this->data, $vars);
    }
    //判斷有沒有緩存，如果有。則直接輸出緩存
    if (!empty($this->config['cache_id']) && $this->config['display_cache'] && $this->cache) {
        // 讀取渲染緩存
        if ($this->cache->has($this->config['cache_id'])) {
            echo $this->cache->get($this->config['cache_id']);
            return;
        }
    }
    //解析傳入過來的模板名
    $template = $this->parseTemplateFile($template);
    if ($template) {
        //這裡生成一下緩存路徑+模板
        $cacheFile = $this->config['cache_path'] . $this->config['cache_prefix'] . md5($this->config['layout_on'] . $this->config['layout_name'] . $template) . '.' . ltrim($this->config['cache_suffix'], '.');
        //判斷緩存文件是否還有效，或者存在
        if (!$this->checkCache($cacheFile)) {
            // 緩存無效 重新模板編譯
            //如果不存在，讀取模板。並調用compiler重新編譯
            $content = file_get_contents($template);
            $this->compiler($content, $cacheFile);
        }
        //開啟頁面緩存
        ob_start();
        //禁止直接輸出
        ob_implicit_flush(0);
        // 讀取編譯存儲
        $this->storage->read($cacheFile, $this->data);
        // 獲取並清空緩存
        $content = ob_get_clean();
        if (!empty($this->config['cache_id']) && $this->config['display_cache'] && $this->cache) {
            // 緩存頁面輸出
            $this->cache->set($this->config['cache_id'], $content, $this->config['cache_time']);
        }
        //輸出編譯後的內容
        echo $content;
    }
}

private function compiler(string &$content, string $cacheFile): void
{
    // 判斷是否啟用布局
    if ($this->config['layout_on']) {
        if (false !== strpos($content, '{__NOLAYOUT__}')) {
            // 可以單獨定義不使用布局
            $content = str_replace('{__NOLAYOUT__}', '', $content);
        } else {
            // 讀取布局模板
            $layoutFile = $this->parseTemplateFile($this->config['layout_name']);
            if ($layoutFile) {
                // 替換布局的主體內容
                $content = str_replace($this->config['layout_item'], $content, file_get_contents($layoutFile));
            }
        }
    } else {
        $content = str_replace('{__NOLAYOUT__}', '', $content);
    }
    //這裡是替換模板內的tp語法例如 {$data} = echo $data
    //{if (1==1))} ==  <?php if (1==1): ?>
    //{/endif}   == <?php endif;?>
    $this->parse($content);
    if ($this->config['strip_space']) {
        /* 去除html空格與換行 */
        $find    = ['~>\s+<~', '~>(\s+\n|\r)~'];
        $replace = ['><', '>'];
        $content = preg_replace($find, $replace, $content);
    }
    // 優化生成的php代碼
    $content = preg_replace('/\?>\s*<\?php\s(?!echo\b|\bend)/s', '', $content);
    // 模板過濾輸出
    $replace = $this->config['tpl_replace_string'];
    $content = str_replace(array_keys($replace), array_values($replace), $content);
    // 添加安全代碼及模板引用記錄
    $content = '<?php /*' . serialize($this->includeFile) . '*/ ?>' . "\n" . $content;
    //寫入緩存
    $this->storage->write($cacheFile, $content);
    $this->includeFile = [];
}

 // 讀取編譯存儲
 $this->storage->read($cacheFile, $this->data);

public function read(string $cacheFile, array $vars = []): void
{
    $this->cacheFile = $cacheFile;
    if (!empty($vars) && is_array($vars)) {
        //通過extract方法，將數據寫到符號表內
        extract($vars, EXTR_OVERWRITE);
    }
    //載入模版緩存文件
    include $this->cacheFile;
}

//這個和第一種流程第一步一樣，不多解釋
public function display(string $content, array $vars = []): string
{
    return $this->getContent(function () use ($vars, $content) {
        //調用template中的display方法，並將content和數據傳入進去
        $this->engine()->display($content, array_merge($this->data, $vars));
    });
}

public function display(string $content, array $vars = []): void
{
    //判斷有沒有要編譯的數據/如果有就和this->data叔祖1合併
    if ($vars) {
        $this->data = array_merge($this->data, $vars);
    }
    //獲取到編譯後的緩存模板
    $cacheFile = $this->config['cache_path'] . $this->config['cache_prefix'] . md5($content) . '.' . ltrim($this->config['cache_suffix'], '.');
    //調用checkCahce把緩存模板傳入進去，查看是否過期
    //或不存在
    if (!$this->checkCache($cacheFile)) {
        //如果模板無效或不存在，就調用
        //compiler方法重寫緩存
        $this->compiler($content, $cacheFile);
    }
    // 讀取編譯存儲
    $this->storage->read($cacheFile, $this->data);
}