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

composer require spatie/backtrace

// helpers.php 或其他适当的文件
use Spatie\Backtrace\Backtrace;
use Spatie\Backtrace\Frame;
use Illuminate\Support\Facades\Auth;
use Illuminate\Support\Facades\Storage;

if (!function_exists('logDatabaseError')) {
    function logDatabaseError(\Throwable $exception)
    {
        // 创建一个回溯实例
        $backtrace = Backtrace::create();

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

        $log_string = "TIME: " . now()->toDateTimeString() . PHP_EOL;
        $log_string .= "User ID: " . (Auth::check() ? Auth::user()->id : 'Guest') . PHP_EOL;

        if ($controllerResponsible) {
            $log_string .= "Controller->Action: " . $controllerResponsible->class . "->" . $controllerResponsible->method . PHP_EOL;
        } else {
            $log_string .= "Controller->Action: Unknown->Unknown" . PHP_EOL;
        }

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

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

// App\Http\Controllers\BestControllerEver.php
<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;
use Illuminate\Database\QueryException;

class BestControllerEver extends Controller
{
    public function writeStuffToDatabase(Request $request)
    {
        try {
            // 模拟一个数据库操作，例如访问不存在的表
            DB::table('non_existent_table')->get();
        } catch (QueryException $exception) {
            logDatabaseError($exception); // 直接调用，无需额外参数
            return response()->json(['error' => 'Database operation failed.'], 500);
        }
        return response()->json(['message' => 'Database operation successful.']);
    }
}

composer require spatie/backtrace

<?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;
use Illuminate\Support\Collection; // 确保导入 Collection

class Handler extends ExceptionHandler
{
    /**
     * 用于在异常报告时存储负责的控制器帧。
     *
     * @var SpatieBacktraceFrame|null
     */
    public $controllerResponsible = null;

    /**
     * 不应报告的异常类型列表。
     *
     * @var array<int, class-string<Throwable>>
     */
    protected $dontReport = [
        //
    ];

    /**
     * 不应闪存到会话的输入字段列表。
     *
     * @var array<int, string>
     */
    protected $dontFlash = [
        'current_password',
        'password',
        'password_confirmation',
    ];

    /**
     * 注册应用程序的异常处理回调。
     *
     * @return void
     */
    public function register(): void
    {
        $this->reportable(function (Throwable $e) {
            // 为当前异常创建回溯实例
            $backtraceInstance = SpatieBacktrace::createForThrowable($e);

            // 过滤回溯帧，找到第一个继承自 App\Http\Controllers\Controller 的类
            $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;
        });
    }

    /**
     * 获取用于日志记录的默认上下文变量。
     *
     * @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);
    }
}

// App\Http\Controllers\BestControllerEver.php
<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Support\Facades\DB;

class BestControllerEver extends Controller
{
    public function writeStuffToDatabase(Request $request)
    {
        // 直接执行可能抛出 QueryException 的操作
        // 如果发生异常，Handler.php 会自动捕获并记录
        DB::table('non_existent_table')->get();

        return response()->json(['message' => 'Database operation successful.']);
    }
}