自定义 Blade 指令实现静态资源路径配置-php教程-PHP中文网

自定义 Blade 指令实现静态资源路径配置

花韻仙語

发布： 2025-10-16 13:12:02

原创

919人浏览过

自定义 blade 指令实现静态资源路径配置

本文介绍了如何在 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'>

登录后复制

注意事项：

稿定PPT

海量PPT模版资源库

111

查看详情

这种方法需要硬编码资源路径，不够灵活。
无法利用 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'> （时间戳会根据文件修改时间变化）

登录后复制

注意事项：