Laravel控制器方法间请求数据传递指南

<?php

namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Routing\Controller; // 显式导入基础控制器类

class DataProcessorController extends Controller
{
    /**
     * @var Request|null 存储处理后的请求实例
     * 使用 protected 访问修饰符，确保属性在控制器内部及其子类中可访问。
     * 初始化为 null 是一个好的实践。
     */
    protected ?Request $processedRequest = null;

    /**
     * 内部辅助方法：处理并修改请求数据，然后存储到控制器属性。
     * 这个方法通常不会直接作为路由终点，而是由其他公共方法调用。
     *
     * @param Request $request 当前HTTP请求实例，通过依赖注入获取。
     * @return void
     */
    protected function processAndStoreRequest(Request $request): void
    {
        // 示例：获取请求中的 'tax' 参数，如果不存在则默认为0
        $originalTax = $request->input('tax', 0);

        // 示例：根据业务逻辑修改数据，例如将 'tax' 乘以12
        $modifiedTax = $originalTax * 12;

        // 将修改后的数据合并到当前请求实例中，并存储到控制器属性。
        // 注意：这里我们直接操作并存储了当前请求实例。
        // 如果需要基于原始请求创建一个全新的修改版本而不影响原始实例，可以考虑 $request->duplicate()。
        $this->processedRequest = $request->merge([
            'tax' => $modifiedTax,
            'processed_at' => now()->toDateTimeString() // 添加一个处理时间戳
        ]);

        // 如果需要链式调用，可以在这里返回 $this，但对于简单的数据共享不是必须的。
        // return $this;
    }

    /**
     * 公共方法：应用处理后的请求数据。
     * 这个方法可以作为一个路由终点，负责协调数据处理和业务逻辑。
     *
     * @param Request $request 当前HTTP请求实例。
     * @return \Illuminate\Http\JsonResponse 包含处理结果的JSON响应。
     */
    public function applyProcessedData(Request $request): \Illuminate\Http\JsonResponse
    {
        // 在应用数据之前，首先调用内部处理方法来准备数据。
        // 这确保了 $this->processedRequest 属性在后续逻辑中可用。
        $this->processAndStoreRequest($request);

        // 此时，$this->processedRequest 属性中已经包含了修改后的请求数据。
        if ($this->processedRequest) {
            $data = $this->processedRequest;

            // 示例：使用获取到的数据进行业务逻辑处理，例如保存到数据库或进行其他计算。
            // Log::info('Received processed tax: ' . $data->tax);
            // $order = new Order();
            // $order->tax_amount = $data->tax;
            // $order->user_id = $data->user_id; // 假设请求中包含user_id
            // $order->save();

            return response()->json([
                'message' => 'Processed data applied successfully!',
                'original_request_data' => $request->all(), // 原始请求数据
                'processed_request_data' => $data->all(), // 经过处理的请求数据
                'received_tax' => $data->tax,
                'processed_at' => $data->get('processed_at')
            ]);
        } else {
            // 理论上，如果 processAndStoreRequest 被调用，这里不应该为空。
            return response()->json(['message' => 'Failed to process request data.'], 500);
        }
    }
}

use App\Http\Controllers\DataProcessorController;

// 假设通过 POST 请求提交数据到此路由
Route::post('/process-and-apply', [DataProcessorController::class, 'applyProcessedData']);