在Laravel应用中获取调用辅助函数的控制器和方法

// helpers.php
function logDatabaseError ($exception) {
    // 如何在此处动态获取 $controller 和 $function？
    $controller = '???';
    $function = '???';

    $log_string = "TIME: ".now().PHP_EOL;
    $log_string.= "User ID: ".(Auth::user() ? Auth::user()->id : 'Guest').PHP_EOL;
    $log_string.= "Controller->Action:".$controller."->".$function.PHP_EOL;
    $log_string.= $exception->getMessage().PHP_EOL; // 获取异常消息
    $log_string.= $exception->getTraceAsString().PHP_EOL; // 完整堆栈追踪

    Storage::disk('logs')->append('database.log', $log_string);
}

// BestControllerEverController.php
class BestControllerEver extends Controller
{
    function writeStuffToDatabase (Request $request) {
        try {
            DB::table('some_table')->insert(['data' => 'value']);
        }
        catch(\Illuminate\Database\QueryException $exception) {
            logDatabaseError($exception); // 希望在此处自动识别 BestControllerEver 和 writeStuffToDatabase
        }
    }
}

composer require spatie/backtrace

// helpers.php
use Spatie\Backtrace\Backtrace;
use Spatie\Backtrace\Frame as SpatieBacktraceFrame; // 避免与 Laravel 内部 Frame 冲突

function logDatabaseError ($exception) {
    $backtrace = Backtrace::create();

    // 过滤堆栈帧，找到第一个继承自 App\Http\Controllers\Controller 的类
    $controllerResponsible = collect($backtrace->frames())
        ->filter(function (SpatieBacktraceFrame $frame) {
            return (bool)$frame->class; // 确保帧有类名
        })
        ->filter(function (SpatieBacktraceFrame $frame) {
            // 检查该类是否是 App\Http\Controllers\Controller 的子类
            // 注意：您的控制器必须继承 App\Http\Controllers\Controller
            return is_subclass_of($frame->class, \App\Http\Controllers\Controller::class);
        })
        ->first(); // 获取第一个匹配的控制器帧

    $log_string = "TIME: " . now()->format('Y-m-d H:i:s') . PHP_EOL;
    $log_string .= "User ID: " . (auth()->check() ? auth()->id() : 'Guest') . PHP_EOL;

    if ($controllerResponsible) {
        $log_string .= "Controller->Action:" . $controllerResponsible->class . "->" . $controllerResponsible->method . PHP_EOL;
    } else {
        $log_string .= "Controller->Action: N/A (Could not determine from backtrace)" . PHP_EOL;
    }

    $log_string .= "Exception: " . $exception->getMessage() . PHP_EOL;
    $log_string .= "File: " . $exception->getFile() . " Line: " . $exception->getLine() . PHP_EOL;
    $log_string .= "Trace: " . $exception->getTraceAsString() . PHP_EOL; // 包含完整堆栈追踪

    \Illuminate\Support\Facades\Storage::disk('logs')->append('database.log', $log_string);

    // 如果需要使用 Laravel 8.66.0+ 的按需日志功能，可以取消注释以下代码
    /*
    \Illuminate\Support\Facades\Log::build([
        'driver' => 'single',
        'path' => storage_path('logs/database.log'),
    ])->info($log_string);
    */
}

// BestControllerEverController.php
class BestControllerEver extends Controller
{
    function writeStuffToDatabase (Request $request) {
        // 移除 try-catch，让异常被全局处理器捕获
        DB::table('myunavialbetable')->get(); // 假设这会抛出 QueryException
    }
}

<?php

namespace App\Exceptions;

use Illuminate\Foundation\Exceptions\Handler as ExceptionHandler;
use Throwable;
use Spatie\Backtrace\Backtrace as SpatieBacktrace;
use Spatie\Backtrace\Frame as SpatieBacktraceFrame; // 避免命名冲突

class Handler extends ExceptionHandler
{
    /**
     * 用于在 reportable 回调中存储控制器负责信息。
     *
     * @var SpatieBacktraceFrame|null
     */
    public $controllerResponsible = null;

    /**
     * A list of the exception types that are not reported.
     *
     * @var array<int, class-string<Throwable>>
     */
    protected $dontReport = [
        //
    ];

    /**
     * A list of the inputs that are never flashed for validation exceptions.
     *
     * @var array<int, string>
     */
    protected $dontFlash = [
        'current_password',
        'password',
        'password_confirmation',
    ];

    /**
     * Register the exception handling callbacks for the application.
     *
     * @return void
     */
    public function register(): void
    {
        $this->reportable(function (Throwable $e) {
            // 在异常被报告时，创建回溯实例并查找负责的控制器
            $backtraceInstance = SpatieBacktrace::createForThrowable($e);

            $controllerResponsible = collect($backtraceInstance->frames())
                ->filter(function (SpatieBacktraceFrame $frame) {
                    return (bool)$frame->class;
                })
                ->filter(function (SpatieBacktraceFrame $frame) {
                    return is_subclass_of($frame->class, \App\Http\Controllers\Controller::class);
                })
                ->first();

            // 将找到的控制器帧存储起来，以便在 context 方法中使用
            $this->controllerResponsible = $controllerResponsible;
        });
    }

    /**
     * Get the default context variables for logging.
     *
     * @return array<string, mixed>
     */
    protected function context(): array
    {
        $extraContext = [];

        // 如果找到了负责的控制器，则将其信息添加到日志上下文中
        if ($this->controllerResponsible instanceof SpatieBacktraceFrame) {
            $extraContext['controller'] = $this->controllerResponsible->class;
            $extraContext['method'] = $this->controllerResponsible->method;
            $extraContext['controller@method'] = $this->controllerResponsible->class . '@' . $this->controllerResponsible->method;
        }

        // 合并父类的上下文和我们添加的额外上下文
        return array_merge(parent::context(), $extraContext);
    }
}