folded / view
查看您PHP Web应用的工具。
v0.3.0
2020-10-14 19:01 UTC
Requires
- php: >=7.4.0
- folded/exception: 0.4.*
- illuminate/view: 7.*
Requires (Dev)
- phpstan/phpstan: 0.12.*
README
查看您PHP Web应用的工具。
摘要
关于
我创建这个库是为了能够轻松地将它拉入现有的Web应用中,而不需要太多的设置工作。
Folded是一个包集合,可以帮助您轻松地设置Web应用,使用即插即用的包。
- folded/action:一种组织您Web应用控制器的方式。
- folded/config:PHP Web应用的配置工具。
- folded/crypt:为您的Web应用加密和解密字符串。
- folded/exception:为您的Web应用抛出各种异常。
- folded/history:操作您的Web应用的浏览器历史。
- folded/http:PHP Web应用的HTTP工具。
- folded/orm:为您的Web应用提供的ORM。
- folded/request:包括请求验证器在内的请求工具,适用于PHP Web应用。
- folded/routing:PHP Web应用的路由函数。
- folded/session:您的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");