从帮助函数中获取调用控制器和方法的教程

// helpers.php
function logDatabaseError ($exception) {
    $controller = ????; // 如何获取？
    $function = ????;   // 如何获取？

    $log_string = "TIME: ".now().PHP_EOL;
    $log_string.= "User ID: ".Auth::user()->id.PHP_EOL;
    $log_string.= "Controller->Action:".$controller."->".$function.PHP_EOL;
    $log_string.= $exception.PHP_EOL;

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

composer require spatie/backtrace

// helpers.php
use Spatie\Backtrace\Backtrace;
use Spatie\Backtrace\Frame;
use Illuminate\Support\Facades\Storage;
use Illuminate\Support\Facades\Auth;

function logDatabaseError (\Illuminate\Database\QueryException $exception) {
    // 创建一个回溯实例
    $backtrace = Backtrace::create();

    // 过滤回溯帧，找到第一个属于控制器类的帧
    $controllerResponsible = collect($backtrace->frames())
        ->filter(function (Frame $frame) {
            // 确保帧有类名
            return ($frame->class);
        })
        ->filter(function (Frame $frame) {
            // 检查该类是否继承自 Laravel 的基控制器
            // 注意：您的控制器必须继承 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 .= "Trace: " . $exception->getTraceAsString() . PHP_EOL; // 包含完整的堆栈信息

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

// BestControllerEverController.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);
        }
    }
}

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;

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

    /**
     * 不报告的异常类型列表。
     *
     * @var array
     */
    protected $dontReport = [
        //
    ];

    /**
     * 不闪存的验证异常输入列表。
     *
     * @var array
     */
    protected $dontFlash = [
        'current_password',
        'password',
        'password_confirmation',
    ];

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

            // 过滤回溯帧，找到第一个属于控制器类的帧
            $controllerResponsible = collect($backtraceInstance->frames())
                ->filter(function (SpatieBacktraceFrame $frame) {
                    return ($frame->class);
                })
                ->filter(function (SpatieBacktraceFrame $frame) {
                    // 检查该类是否继承自 Laravel 的基控制器
                    return is_subclass_of($frame->class, \App\Http\Controllers\Controller::class);
                })
                ->first();

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

    /**
     * 获取用于日志记录的默认上下文变量。
     * 此方法在 Laravel 记录异常时被调用。
     *
     * @return array
     */
    protected function context()
    {
        $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);
    }
}

// BestControllerEverController.php
namespace App\Http\Controllers;

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

class BestControllerEver extends Controller
{
    public function writeStuffToDatabase (Request $request) {
        // 直接执行数据库操作，如果发生 QueryException，它将被 Laravel 的异常处理器捕获和处理
        DB::table('non_existent_table')->get();

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