larakit / laravel-larakit-staticfiles
用于Laravel的管理静态文件库(将文件打包成一个文件,压缩JS/CSS,在URL中添加哈希以刷新浏览器缓存)
Requires
This package is not auto-updated.
Last update: 2015-12-14 06:48:52 UTC
README
用于Laravel的管理静态文件库(将文件打包成一个文件,压缩JS/CSS,在URL中添加哈希以刷新浏览器缓存)
步骤 1
将可用的样式和脚本移至单独的文件,为此,在 app/start/global.php 的末尾添加一行
require app_path() . '/staticfiles.php';
步骤 2
创建文件 app/staticfiles.php 并填写连接JS/CSS的指令
<?php
\LaraCss::add('http://fonts.googleapis.com/css?family=Open+Sans:300&subset=cyrillic')
->add('http://fonts.googleapis.com/css?family=Oswald:400,700,300')
->add('/packages/components/font-awesome/css/font-awesome.css')
->add('/packages/components/animate.css/animate.css')
->add('/packages/components/jquery-pace/jquery-pace.js')
->add('/packages/components/jquery-notific8/jquery.notific8.min.css')
;
\LaraJs::add('/!/build/bootstrap.min.js')
->add('/!/static/js/main.js')
;
步骤 3
为了将添加的样式和脚本插入到所有页面上,您需要在模板中添加调用
<html>
<head>
<title>title</title>
{{ laracss() }}
</head>
<body>
...
{{ larajs() }}
</body>
</html>
步骤 4
完成后,可以在控制台中调用一个过程
php artisan latastatic:deploy
该过程将为每个已注册的包将静态文件发布到public目录中
如何使用包含静态文件的现成包
1) 访问 packagist.org 并在搜索框中输入所需包的名称,例如 jquery、bootstrap、jqueryui、angular 等... 该包可能来自“components”供应商
注意!
为与模块一起使用的包标记了标签 "larastatic"
2) 将包写入 composer.json 项目文件
{
"require": {
"components/bootstrap": "*",
"components/jqueryui": "*",
"components/font-awesome": "*",
"components/animate.css": "*",
"components/jquery-pace": "*",
"components/jquery-notific8": "dev-master",
"components/jquery": "*"
},
}
3) 在应用程序中注册包,以便可以发布静态文件
<?php
larastatic_register("<vendor>/<package>");
注意!!! 注册静态文件包函数的第二个参数是包内发布文件的路径。默认情况下传递值为 true,表示静态文件将在“public”子目录中查找,这是Laravel中通常的做法。如果发布的静态文件位于包的根目录中,例如“components/bootstrap”,则应将第二个参数传递为空字符串
<?php larastatic_register('components/bootstrap', '');
如果发布的静态文件位于包的某个子目录中,例如“components/animate.css”,则应将第二个参数传递为该子目录
<?php larastatic_register('components/animate.css', 'css');
那么,将仅发布包的所需部分,例如,不包含源代码
功能和推荐
此包能够将文件打包成一个文件并最小化静态文件。所有构建版本都经过版本控制,从而避免了客户端的缓存。
对于开发模式,请禁用构建,而在生产服务器上启用。
这将大大减少获取静态文件对服务器的请求次数。
要更改模块的默认设置,需要发布它们
php artisan config:publish larakit/laravel-larakit-staticfiles
设置将位于 app/config/packages/larakit/laravel-larakit-staticfiles/ 目录中,并可用于重写。