folded/view

查看您PHP Web应用的工具。

v0.3.0 2020-10-14 19:01 UTC

This package is auto-updated.

Last update: 2024-09-17 16:14:46 UTC


README

查看您PHP Web应用的工具。

Packagist License Packagist PHP Version Support Packagist Version Build Status Maintainability TODOs

摘要

关于

我创建这个库是为了能够轻松地将它拉入现有的Web应用中,而不需要太多的设置工作。

Folded是一个包集合,可以帮助您轻松地设置Web应用,使用即插即用的包。

功能

  • 可以渲染Blade视图,并将数据传递给它
  • 可以渲染纯PHP视图
  • 可以在之前将数据添加到特定的视图中(例如,如果您的布局总是需要某些数据,这很有用)
  • 在调用displayView()之前预热视图引擎,这样它就不会在调用之前启动

需求

  • PHP版本 >= 7.4.0
  • 已安装Composer

安装

1. 安装包

在您的根目录中,运行以下命令

composer require folded/view

2. 设置视图引擎

在调用显示视图之前的脚本中,添加以下设置代码

use function Folded\setViewFolderPath;
use function Folded\setViewCacheFolderPath;

setViewFolderPath(__DIR__ . "/views");
setViewCacheFolderPath(__DIR__ . "/cache/views");

缓存是一个将您的代码编译成纯PHP并存储在磁盘中的位置,以便在后续请求中更快地渲染视图。

示例

由于这个库依赖于Laravel的illuminate/view,如果您需要有关Blade语法和可用Blade指令的信息,可以参考7.X文档

1. 显示视图

在这个示例中,我们将显示一个Blade视图。

use function Folded\displayView;

displayView("home.index");

以下内容在views/home/index.blade.php

<h1>Hello world</h1>

2. 将数据传递到您的视图

在这个示例中,我们将向显示的视图中传递一个字符串。

use function Folded\displayView;

displayView("home.index", [
  "name" => "John",
]);

以下内容在视图中

<h1>Hello world</h1>

<p>Welcome to my website, {{ $name }}.</p>

3. 显示纯PHP视图

在这个示例中,我们将显示一个纯PHP文件。

use function Folded\displayView;

displayView("about-us.index");

纯PHP视图位于views/about-us/index.php(注意现在没有“blade”扩展名),以下内容

<h1>About us</h1>

4. 总是向视图传递某些数据

在这个示例中,我们将向布局视图中传递公司名称,以便不必将其添加到每个扩展布局的视图中。

use function Folded\addDataToView;

addDataToView("layouts.base", [
  "companyName" => "Folded",
]);

5. 获取渲染的视图

在这个例子中,我们将获取渲染后的视图并将其存储在一个变量中(例如,用于发送电子邮件)。

use function Folded\getRenderedView;

$content = getRenderedView("emails.account-created");

版本支持