codenom / assets
为 CodeIgniter 4 提供资产发布和加载
Requires
- php: >=7.2
Requires (Dev)
- codeigniter4/codeigniter4: dev-develop
- mikey179/vfsstream: 1.6.*
- phpunit/phpunit: ^8.5
This package is auto-updated.
Last update: 2024-09-25 17:56:17 UTC
README
为 CodeIgniter 4 提供资产发布和加载
快速开始
- 使用 Composer 安装:
> composer require codenom/assets
- 将 CSS 和 JS 文件放在: public/assets
- 将额外资产添加到配置: app/Config/Assets.php
- 在 head 标签中添加:
<?= service('assets')->css() ?>
- 添加到页脚:
<?= service('assets')->js() ?>
特性
为 CodeIgniter 4 提供 CSS 和 JavaScript 文件的原生加载功能
安装
通过 Composer 轻松安装以利用 CodeIgniter 4 的自动加载功能,并始终保持最新状态
> composer require codenom/assets
或者,通过下载源代码并将目录添加到 app/Config/Autoload.php
来手动安装。
配置(可选)
可以通过库的配置文件覆盖或增强库的默认行为。将 examples/Assets.php 复制到 app/Config/Assets.php 并按照注释中的说明进行操作。如果没有找到配置文件,库将使用其默认设置。
用法
如果安装正确,CodeIgniter 4 将检测并自动加载库、服务和配置。使用库方法 css()
和 js()
显示特定路由的资产标签: <?= service('assets')->css() ?>
结构
库将在资产目录(默认: public/assets)中搜索与当前路由匹配的文件,并按路由段级联加载这些文件。
示例: https://example.com/users/view/30
库将首先加载任何根资产(public/assets/*.css *.js
),然后是 "users" 子目录中的资产(public/assets/users/
),然后是 "view" 子目录,然后是 "12" 子目录。任何缺失或无效的目录都将被忽略。
可以通过配置变量 $routes
指定额外的资产 - 这对于包含预捆绑库尤其有帮助。$routes
将每个路由映射到为该路由加载的资产文件或资产目录。
示例
public $routes = [
'' => [
'bootstrap/dist/css/bootstrap.min.css',
'bootstrap/dist/js/bootstrap.bundle.min.js'
],
'files/upload' => [
'vendor/dropzone'
]
];
这告诉库为每个路由加载 Bootstrap 资产(''
),而无需将其从预捆绑子目录中移动。它还将为指定的路由加载 dropzone
目录中的任何资产。