gregoriohc/laravel-preview

Laravel 视图预览包

v1.0.2 2016-09-03 13:34 UTC

This package is auto-updated.

Last update: 2024-09-17 09:21:01 UTC


README

Latest Version on Packagist Software License Build Status StyleCI Quality Score Code Climate Test Coverage Total Downloads

警告:仅在本地/调试模式下使用此包!在生产环境中启用此包可能代表一个重大的安全问题!

查看Laravel视图预览包

此包可用于预览Laravel视图,无需创建路由或控制器来加载视图。如果您想预览电子邮件视图而不需要发送它们,它也非常有用。

内容

安装

您可以通过composer安装此包

composer require gregoriohc/laravel-preview

您必须安装服务提供者

// config/app.php
'providers' => [
    ...
    Gregoriohc\Preview\PreviewServiceProvider::class,
],

使用

现在,如果您处于已启用调试模式的本地环境中,您可以访问预览路由。

预览路由路径具有以下结构:/_preview/{view}?{params}

{view}可以是任何应用程序或包的视图,使用Laravel的点命名空间表示法(例如:welcome、errors.503、mypackage::myview)

例如,如果您想预览Laravel默认的欢迎页面,您可以访问:/_preview/welcome

可选的{params}可以是一系列参数,这些参数将被转换为变量并传递给视图。参数的键是变量名,值将根据其格式进行转换。可能的格式如下

  • 从JSON对象:如果您传递一个JSON字符串,它将自动转换为对象。例如:user={"name": "John Doe", "email": "johndoe@example.com"}
  • 模型对象:要加载模型对象,只需传递(由::分隔)模型类(包含完整命名空间)和您要查找的对象ID。例如:user=App\User::1
  • 类方法调用:要调用类方法,只需传递(由::分隔)类(包含完整命名空间)、方法以及参数列表。例如:appname=Config::get::app.namesomething=MyClass::myMethod::param_1::param_2::param_3。如果是静态方法,将静态调用,如果不是,将实例化类对象并调用该方法。
  • 在其他情况下,值将保持不变传递

更多示例

  • /_preview/emails.user.welcome?user=App\User::1
  • /_preview/admin.user.show?user=App\User::1
  • /_preview/mypackage::my.fantastic.view?something=Cache::get::something&anotherthing=textcontent&somenumber=123

更新日志

有关最近更改的更多信息,请参阅更新日志

测试

$ composer test

安全

如果您发现任何与安全相关的问题,请通过电子邮件gregoriohc@gmail.com报告,而不是使用问题跟踪器。

贡献

有关详细信息,请参阅贡献

致谢

许可

MIT许可证(MIT)。有关更多信息,请参阅许可文件