README

此 Static Assets 包可让您的 Laravel 应用静态资源远程编译和托管。

您不再需要在主机上安装 Node.js 仅用于资源编译。此外，还可以获得远程管理的所有好处，包括更快的编译时间、降低资源利用率、CDN 托管等。

要了解 Static Assets 可以为您做什么以及如何设置您的账户，请访问 staticassets.app。

要求

PHP >= 8.1
Laravel >= 9.0

特性

使用远程生成和托管的 Vite 或 Mix 编译文件。
选择将更新的 Vite / Mix 清单文件存储在磁盘上或缓存中。

安装

composer require static-assets/laravel

您还需要安装 Vite 或 Mix 包以用于您的 Laravel 应用。

安装 Vite 包的说明

安装 Laravel Mix 包的说明

配置

可以使用以下 .env 变量配置此包。

默认情况下，以下所有变量均不是必需的。以下定义了默认行为。

启用/禁用包

STATIC_ASSETS=true

默认值：当 APP_ENV 为 production 时为 true，否则为 false。

清单存储

我们将由 Static Assets 编译的清单存储在您的默认磁盘上或缓存中。

有效值是： disk 或 cache。

STATIC_ASSETS_STORAGE=disk

默认情况下，Static Assets 编译的清单将存储在默认磁盘上。

清单缓存超时（仅缓存）

当在缓存中存储 Static Assets 清单时，您可以指定清单应缓存的天数。

STATIC_ASSETS_CACHE_TIMEOUT=90

默认情况下，Static Assets 编译的清单将缓存 30 天。

指定发布

我们通过 git hash 引用静态资源。在此处，您可以定义要使用特定版本。

这可能在调试或测试时非常有用。

STATIC_ASSETS_RELEASE=0e5eb38d172ceed3735ecae5a02767c8c945b31c

默认情况下，使用最新的 git 提交哈希值。

trim(exec('git --git-dir '.base_path('.git').' rev-parse HEAD'))

清单自定义目录

如果您的 Vite/Mix 清单不在默认位置（/public 或 /public/build）存储，您可以在此指定目录。

# This non-default example will look for the manifest file in the 
# /build directory of your project.

STATIC_ASSETS_DIRECTORY=build

默认情况下，包将在 /public 目录中查找清单文件。

发布配置文件

虽然不是必需的，但您也可以使用以下命令可选地发布配置文件

php artisan vendor:publish --tag=static-assets-config

变更日志

请参阅包的 GitHub 发布页面了解最近更改的详细信息。

贡献

我们欢迎对此包的贡献。请提交拉取请求，我们将进行审查。

安全漏洞

Static Assets 对安全性非常重视。任何安全问题应报告给 security@staticassets.app。

鸣谢

Static Assets 是 Init Development Studios 的产品。我们是 Laravel 社区的自豪成员，并赞助我们当地的 Laravel 会议 Laracon AU。

许可

MIT许可证（MIT）。请参阅许可证文件以获取更多信息。

静态资源 / laravel

维护者

详细信息