本文介绍了如何在 duncan3dc/blade 模板引擎中静态添加自定义指令，以实现对 CSS 和 JavaScript 资源路径的预定义和便捷引用。通过示例代码，详细讲解了利用 `Blade::directive` 方法以及 `assetify` 函数自定义指令的多种实现方式，旨在帮助开发者更灵活地管理和使用静态资源。
在使用 duncan3dc/blade 模板引擎时，有时需要自定义指令来简化模板编写，特别是对于静态资源（如 CSS 和 JavaScript）的引用。 默认情况下，模板引擎可能没有提供直接修改资源路径的配置项，因此需要手动添加指令来实现。以下介绍几种静态添加指令的方法，以便在 Blade 模板中方便地使用预定义的资源路径。
方法一：使用 Blade::directive 自定义指令
Blade::directive 方法允许你定义新的 Blade 指令。 这种方法简单直接，但需要手动处理资源路径的拼接。
use duncan3dc\Laravel\Blade;
Blade::directive('css', function($parameter){
return "<link rel='stylesheet' type='text/css' href='/assets/css/{$parameter}'>";
});
// 使用示例：
// 在 Blade 模板中使用 @css('style.css')
// 将会输出： <link rel='stylesheet' type='text/css' href='/assets/css/style.css'>注意事项：
- 这种方法需要硬编码资源路径，不够灵活。
- 无法利用 assetify 函数的优势，例如处理外部资源链接。
方法二：复制 assetify 函数并自定义指令
assetify 函数负责处理资源路径的拼接和转换，但它是 Directives 类的私有方法。 为了利用其功能，可以将 assetify 函数的代码复制出来，并自定义指令。
use duncan3dc\Laravel\Blade;
function assetify(string $file, string $type, string $path): string
{
// 复制 Directives->assetify 的代码
$file = trim($file, "\"'");
if (preg_match("#^(https?:)?//#i", $file)) {
return $file;
}
if (substr($file, 0, 1) !== "/") {
$file = "/" . $path . "/" . $file;
}
$file = str_replace(" ", "%20", $file);
return $file . "?" . filemtime(getcwd() . $file);
}
Blade::directive('css', function($parameter){
$file = assetify($parameter, "css", 'assets/css');
return "<link rel='stylesheet' type='text/css' href='{$file}'>";
});
Blade::directive('js', function($parameter){
$file = assetify($parameter, "js", 'assets/js');
return "<script type='text/javascript' src='{$file}'></script>";
});
// 使用示例：
// 在 Blade 模板中使用 @css('style.css')
// 将会输出： <link rel='stylesheet' type='text/css' href='/assets/css/style.css?1678886400'> （时间戳会根据文件修改时间变化）注意事项：
- 需要手动维护 assetify 函数的代码，当 Directives 类中的 assetify 函数发生变化时，需要同步更新。
方法三：使用反射绕过访问权限
可以使用 PHP 的反射机制来访问 Directives 类的私有方法 assetify。 这种方法可以确保使用最新版本的 assetify 函数，避免手动维护代码。
use duncan3dc\Laravel\Directives;
use duncan3dc\Laravel\Blade;
function assetify(string $file, string $type, string $path): string
{
static $assetify;
if(!$assetify){
$assetify = new \ReflectionMethod(Directives::class, 'assetify');
$assetify->setAccessible(true);
}
return $assetify->invoke(new Directives, $file, $type, $path);
}
Blade::directive('css', function($parameter){
$file = assetify($parameter, "css", 'assets/css');
return "<link rel='stylesheet' type='text/css' href='{$file}'>";
});
Blade::directive('js', function($parameter){
$file = assetify($parameter, "js", 'assets/js');
return "<script type='text/javascript' src='{$file}'></script>";
});
// 使用示例：
// 在 Blade 模板中使用 @css('style.css')
// 将会输出： <link rel='stylesheet' type='text/css' href='/assets/css/style.css?1678886400'> （时间戳会根据文件修改时间变化）注意事项：
- 使用反射可能会带来性能损耗。
- 依赖于 Directives 类的内部实现，如果 assetify 方法被移除或重命名，代码将会失效。
总结
以上三种方法都可以实现静态添加 Blade 指令，以便在模板中方便地引用静态资源。选择哪种方法取决于具体的需求和偏好。
- 如果对资源路径的处理要求不高，可以选择第一种方法，简单直接。
- 如果需要利用 assetify 函数的优势，可以选择第二种或第三种方法。 第二种方法需要手动维护代码，第三种方法使用反射，可以确保使用最新版本的 assetify 函数。
无论选择哪种方法，都需要仔细测试，确保指令能够正确地工作。
