高效 / larasset
Larasset 是一个用于 Laravel 5 的库,可以轻松管理资源。
Requires
- php: >=5.4.0
- efficiently/jquery-laravel: ~2.1.0
- laravelcollective/html: ~5.0.0||~5.1.0||~5.2.0
Requires (Dev)
- illuminate/console: ~5.0
- illuminate/support: ~5.0
README
Laravel 5.1, 5.2 & 5.3 的资源管道!
资源管道提供了一个框架,用于连接和压缩或压缩 JavaScript 和 CSS 资源。它还增加了使用其他语言和预处理器(如 CoffeeScript、LESS、Sass 和 EJS)编写这些资源的能力。
有关 Laravel 4.1 或 4.2 的支持,请参阅 Larasset 0.9 分支
有关 Laravel 5.0 的支持,请参阅 Larasset 1.0 分支
有关此包的更完整描述,您可以阅读 Wiki 文档
Larasset 使用示例。
php artisan larasset:precompile
:预编译应用程序的资源,对您的生产环境很有用php artisan larasset:serve
:启动 Larasset 服务器以提供服务,对您的开发环境很有用php artisan server
:在 PHP 开发服务器上运行 Laravel 应用程序,并启动 Larasset 服务器以提供服务
演示应用程序
您可以通过此在线演示看到此包的实际应用。您还可以在此处获取此演示的源代码。
先决条件
您必须在您的计算机上安装 Node.js(仅限开发环境)。
此包仅与 PHP >= 5.5 和 Laravel >= 5.1 框架兼容。
安装
安装和配置 Larasset 包
-
在
composer.json
中,将行"minimum-stability": "stable"
替换为"minimum-stability": "dev"
-
使用 composer 安装 Larasset 包
composer require efficiently/larasset:1.2.*
-
打开您的应用程序调试模式,创建或编辑
config/app.php
文件<?php return [ 'debug' => true, // Others config options.... ];
注意:强烈建议您在生产环境中关闭错误详情。
-
将这些服务提供者添加到
config/app.php
'Collective\Html\HtmlServiceProvider', 'Efficiently\Larasset\LarassetServiceProvider', 'Efficiently\JqueryLaravel\JqueryLaravelServiceProvider',
-
将这些别名(外观)添加到您的 Laravel
config/app.php
文件'Form' => 'Collective\Html\FormFacade', 'HTML' => 'Collective\Html\HtmlFacade', 'Asset' => 'Efficiently\Larasset\Facades\Asset',
-
现在,您可以在此
app/Http/Kernel.php
文件中添加此安全中间件'Efficiently\JqueryLaravel\VerifyJavascriptResponse',
-
运行这些 Larasset 命令需要安装一些 Node.js 模块
npm install -g larasset-js
-
最后,运行
php artisan larasset:setup
。安装的其余部分取决于是否使用资源管道。
资源中间件服务器
运行
php artisan larasset:serve
注意:您应仅在使用开发/本地环境时使用它
预编译资源(使用清单)
运行
php artisan larasset:precompile
注意:您被鼓励在 production 环境中使用它,有关更多信息,请 阅读下一节。
开发与生产模式
默认情况下,Larasset 以 开发 模式运行。这意味着它将在需要时重新编译(服务器)任何更改的资源。此外,在开发模式下,它不会压缩 JavaScript 和/或样式表。要以生产就绪模式运行 Larraset 服务器和预编译器,请使用 --assets-env production
命令行选项,如下所示
php artisan larasset:precompile --assets-env production
更新日志
1.3.x
- 支持 Laravel 5.3!
1.2.0
- 支持 Laravel 5.2!
1.1.0
- 支持 Laravel 5.1!
- 通过
larasset-js
1.2.0,现在 CoffeeScript 编译 JavaScript 时不再使用顶层函数安全包装器(非裸模式)。 - 通过 ECMAScript 2015 (ES6) 支持,通过 Babel,使用
larasset-js
1.1.1。 - 添加了
humanize()
函数辅助工具来修复image_tag()
辅助工具(修复 #15)。 - 添加了
larasset.port
配置选项。用于正确处理php artisan server
命令的--larasset-port
选项。这在您运行资产服务器时对开发环境非常有用。默认端口值为3000
。您可以在 Laravel 应用的config/larasset.php
文件中更改它。 - 将废弃的
illuminate/html
包替换为laravelcollective/html
包。 - 升级说明(如果您之前使用过与 Laravel 4.x 或 5.0 版本的此包)
- 您应该在 Laravel 应用的
config/app.php
文件中替换'Illuminate\Html\HtmlServiceProvider',
为'Collective\Html\HtmlServiceProvider',
'Form' => 'Illuminate\Html\FormFacade',
为'Form' => 'Collective\Html\FormFacade',
'HTML' => 'Illuminate\Html\HtmlFacade',
为'HTML' => 'Collective\Html\HtmlFacade',
- 您应该在 Laravel 应用的
1.0.2
- 修复了 PHP 5.4 支持。
1.0.1
- 将
humanize()
函数辅助工具回滚以修复image_tag()
辅助工具(修复 #15)。
1.0.0
- 支持 Laravel 5.0!
0.9.8
- 将
humanize()
函数辅助工具回滚以修复image_tag()
辅助工具(修复 #15)。
0.9.7
- 添加了一个禁用源映射的选项。
0.9.6
- 重大变更: 命令行选项
--environment
重命名为--assets-env
。因为与 Laravel 命令行选项--env
存在冲突。并且命令行选项larasset-environment
重命名为--larasset-env
。有关更多信息,请参阅问题 #6。
致谢
- 来自 Ruby on Rails 框架的原始 Asset Pipeline(Sprockets)。
- Asset Pipeline 的 Node.js 版本:Mincer
- Asset Pipeline 的 PHP 版本:Asset Pipeline
致谢
基于 MIT 许可证发布。
这是测试版质量的软件
根据我们的测试,它运行良好。内部 API 可能会更改,并将添加其他功能。我们正在努力使 Larasset 成为生产质量的软件。