larakit/laravel-larakit-staticfiles

此包已被废弃且不再维护。未建议替代包。

用于Laravel的管理静态文件库(将文件打包成一个文件,压缩JS/CSS,在URL中添加哈希以刷新浏览器缓存)

dev-master 2015-09-14 10:46 UTC

This package is not auto-updated.

Last update: 2015-12-14 06:48:52 UTC


README

Total Downloads Latest Stable Version Latest Unstable Version License

用于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/ 目录中,并可用于重写。