自定义Laravel Blade设备检测指令报错：undefined constant detect 如何修复？

错误原因 #

你遇到的undefined constant detect错误，是因为两个核心问题：

1. 你定义的是Blade指令@detect，但在@if条件中直接写detect，PHP会将其识别为未定义的常量，而非调用你的指令。
2. 原Blade指令的实现逻辑错误：Blade指令的闭包需要返回可执行的PHP代码字符串，而非直接返回布尔值true/false——Blade会把指令编译成PHP代码执行，直接返回布尔值会导致编译后的代码逻辑失效。

修复方案 #

方案一：修正Blade指令实现并正确调用 #

步骤1：修改AppServiceProvider中的指令实现

将原指令改为返回PHP表达式字符串，让Blade编译后能正确执行判断逻辑：

<?php

namespace App\Providers;

use Illuminate\Support\ServiceProvider;
use Blade;

class AppServiceProvider extends ServiceProvider
{
    public function register()
    {
        //
    }

    public function boot()
    {
        Blade::directive('detect', function () {
            // 返回可执行的PHP判断表达式
            return '($_SERVER[\'HTTP_USER_AGENT\'] ?? \'\') && preg_match(\'/(Mobile|Android|Tablet|GoBrowser|[0-9]x[0-9]*|uZardWeb\/|Mini|Doris\/|Skyfire\/|iPhone|Fennec\/|Maemo|Iris\/|CLDC\-|Mobi\/)/uis\', $_SERVER[\'HTTP_USER_AGENT\'])';
        });
    }
}

步骤2：在Blade视图中正确调用指令

在@if条件中通过@detect调用指令：

<div class="mb-3  
    @if(@detect)          
     col-6      
    @else
    col-3       
    @endif
    expand_on_mobile">
    <label for="exampleInputEmail1" class="form-label">Category</label>
    <input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp">
</div>

方案二：改用辅助函数（更推荐） #

对于设备检测这类通用逻辑，使用辅助函数比Blade指令更直观、易维护：

步骤1：创建辅助函数

在app/Helpers目录下新建DeviceHelper.php文件：

<?php

if (!function_exists('is_mobile')) {
    function is_mobile()
    {
        $user_ag = $_SERVER['HTTP_USER_AGENT'] ?? '';
        return preg_match('/(Mobile|Android|Tablet|GoBrowser|[0-9]x[0-9]*|uZardWeb\/|Mini|Doris\/|Skyfire\/|iPhone|Fennec\/|Maemo|Iris\/|CLDC\-|Mobi\/)/uis', $user_ag);
    }
}

步骤2：配置自动加载

修改项目根目录的composer.json，添加辅助函数的自动加载规则：

"autoload": {
    "files": [
        "app/Helpers/DeviceHelper.php"
    ]
},

执行composer dump-autoload命令让配置生效。

步骤3：在视图中使用辅助函数

<div class="mb-3  
    @if(is_mobile())          
     col-6      
    @else
    col-3       
    @endif
    expand_on_mobile">
    <label for="exampleInputEmail1" class="form-label">Category</label>
    <input type="email" class="form-control" id="exampleInputEmail1" aria-describedby="emailHelp">
</div>

内容的提问来源于stack exchange，提问作者Gandalf