Laravel控制器类全局变量在类方法中返回null问题求助

我是一名Java开发者，刚接触Laravel与PHP。我在AddPersInfoController.php控制器类中定义了私有类变量$person，在GET路由触发的add_all方法中初始化该变量后能正常获取数据库数据，但在表单提交触发的POST路由对应的addPromHist方法中，该变量返回null，无法用于关联数据库表记录。

路由配置 #

GET路由（web.php） #

Route::get('/add_all/{persId?}',[AddPersInfoController::class,'add_all'])->name('add_all');

POST路由（web.php） #

Route::post('/add/prom_hist',[AddPersInfoController::class,'addPromHist'])->name('add_prom_hist');

控制器代码片段 #

class AddPersInfoController extends Controller
{   
    private $person;
    
    public function add_all(int $user_id){
        $pers = $this->person = Pers_info::find($user_id);
        dd($pers); // 此处能正常显示从数据库获取的所有值
        // ...其他代码
    }

    public function addPromHist(Request $request)
    {
        $this->validate($request, [
            // ...验证规则
        ]);
        dd($this->person); // 此处返回null
        $promHist = new Prom_history();
        $promHist->pers_info_id = $this->person->id; // 需要在此处使用该变量
        $promHist->date = $request->date;
        // ...保存等操作
    }
}

核心原因 #

Laravel的控制器每次HTTP请求都会创建全新的实例，这和Java Web里部分框架的单例控制器机制完全不同。你在GET请求的add_all方法中给$person赋值，只在那次请求的控制器实例中有效；当POST请求触发addPromHist时，系统会新建一个控制器实例，原来的$person变量自然是null。

解决方案 #

方法1：通过表单隐藏字段传递persId #

在add_all方法渲染的表单里，加个隐藏字段携带用户ID：

<form method="POST" action="{{ route('add_prom_hist') }}">
    @csrf
    <input type="hidden" name="pers_id" value="{{ $pers->id }}">
    <!-- 其他表单字段 -->
    <button type="submit">提交</button>
</form>

然后在addPromHist方法里直接从请求取ID并查询：

public function addPromHist(Request $request)
{
    $this->validate($request, [
        'pers_id' => 'required|integer|exists:pers_info,id',
        // ...其他验证规则
    ]);

    $person = Pers_info::findOrFail($request->pers_id);
    $promHist = new Prom_history();
    $promHist->pers_info_id = $person->id;
    $promHist->date = $request->date;
    $promHist->save();

    // ...后续操作，比如跳转
}

方法2：利用Session暂存用户信息 #

如果需要在多个请求间共享数据，用Laravel的Session：
在add_all方法里存入Session：

public function add_all(int $user_id){
    $this->person = Pers_info::find($user_id);
    session(['current_person' => $this->person]);
    // ...渲染视图
}

然后在addPromHist方法里取出：

public function addPromHist(Request $request)
{
    $this->validate($request, [
        // ...验证规则
    ]);

    $person = session('current_person');
    if(!$person){
        // 处理未找到的情况，比如跳转回列表
        return redirect()->route('some_list_route')->with('error', '未找到用户信息');
    }

    $promHist = new Prom_history();
    $promHist->pers_info_id = $person->id;
    $promHist->date = $request->date;
    $promHist->save();
}

注意：Session存的是序列化数据，如果Pers_info模型有复杂关联，建议只存ID，用时再查询，避免序列化问题。

方法3：修改POST路由携带persId参数 #

调整POST路由，把用户ID放在URL里：

Route::post('/add/prom_hist/{persId}',[AddPersInfoController::class,'addPromHist'])->name('add_prom_hist');

表单的action也要对应修改：

<form method="POST" action="{{ route('add_prom_hist', ['persId' => $pers->id]) }}">
    @csrf
    <!-- 其他表单字段 -->
    <button type="submit">提交</button>
</form>

然后在控制器方法里接收参数并查询：

public function addPromHist(Request $request, int $persId)
{
    $this->validate($request, [
        // ...验证规则
    ]);

    $person = Pers_info::findOrFail($persId);
    $promHist = new Prom_history();
    $promHist->pers_info_id = $person->id;
    $promHist->date = $request->date;
    $promHist->save();
}

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