elfsundae/laravel-asset-version

Laravel 静态资源版本控制通过查询字符串:`app.js` → `app.js?d41d8cd98f`

1.0.0 2017-11-23 16:06 UTC

This package is auto-updated.

Last update: 2024-08-29 04:43:03 UTC


README

Latest Version on Packagist Software License StyleCI

Laravel 静态资源版本控制通过查询字符串:app.jsapp.js?d41d8cd98f

安装

$ composer require elfsundae/laravel-asset-version

对于 Lumen 或低于 v5.5 的 Laravel,您需要手动注册服务提供者

ElfSundae\Laravel\AssetVersion\AssetVersionServiceProvider::class,

配置

首先,您需要在 config/asset-version.php 路径下创建一个资产版本配置文件,并填写资产路径。或者您也可以运行 asset-version:update 艺术家命令来创建此文件

<?php

return [
    'css/app.css',
    'js/app.js',
    'images/foo.png',
];

然后,您可以运行 asset-version:update 命令来更新资产版本配置

$ php artisan asset-version:update

现在配置文件可能如下所示

<?php

return array (
  'css/app.css' => '3ede8f2085',
  'js/app.js' => '2eaf111399',
  'images/foo.png' => 'd41d8cd98f',
);

⚠️ 您需要每次更改任何资产内容时都运行 asset-version:update 命令。 您可以在您的资产构建脚本中调用此命令,例如 Laravel Elixir

elixir((mix) => {
    mix.sass('app.scss')
       .webpack('app.js')
       .exec('php artisan asset-version:update');
});

对于 Laravel Elixir,您可以使用 laravel-elixir-asset-version NPM 包来轻松执行更新。

用法

您可以使用 asset_path() 辅助函数获取已版本化的资产路径

asset_path('css/app.css');  // "/css/app.css?3ede8f2085"

<link href="{{ asset_path('js/app.js') }}" rel="stylesheet">

许可证

此软件包是开源软件,受 MIT 许可证 许可。