Laravel 8下PHP Trait类属性返回Null 如何为Trait属性赋值数据库值
原实现属性返回Null的核心原因
- Trait本质是可复用的代码片段,并非独立类,它内部定义的
__construct不会自动强制执行:- 只有当使用该Trait的类完全没有自定义构造函数时,Trait里的构造方法才会被注册生效
- 只要宿主类自己实现了构造函数,Trait中的构造方法会被直接完全覆盖,执行不到给
$user赋值的逻辑,最终访问属性时自然为null
- 在Trait中编写构造函数本身就违背了Trait的设计初衷:会把不可控的初始化逻辑强绑到宿主类上,后续维护时很容易因为初始化顺序、构造覆盖出现排查成本极高的问题。
无构造冲突的最优实现方案
方案1:惰性加载的属性访问器(推荐日常使用)
完全绕开构造函数依赖,在Trait内部封装带缓存的访问方法,用到的时候才触发数据库查询,同一个实例内不会重复打库:
use App\Models\User; trait TestTrait { // 用专门的缓存属性存查询结果,避免和业务属性命名冲突 protected $traitUserCache; /** * 获取全量用户列表 */ protected function getTraitUsers() { // 已有缓存直接返回,不重复查询 if (!$this->traitUserCache) { $this->traitUserCache = User::all(); } return $this->traitUserCache; } public function test() { // 直接调用访问方法取值,不会出现空值问题 var_dump($this->getTraitUsers()); } }
这个方案的优势:
- 没有隐式的初始化依赖,不管宿主类的构造函数怎么写,都不会影响取值逻辑
- 内置实例级缓存,比每次直接调用
User::all()的数据库开销更低 - 方法可见性可以灵活调整,需要对外暴露就改成
public即可
方案2:显式初始化方法(需要构造阶段取值时使用)
如果业务确实需要在类实例初始化完成时就把用户数据赋值给类属性,就不要在Trait里写默认构造函数,改成提供一个公开的初始化方法,由宿主类在自己的构造逻辑里主动调用:
use App\Models\User; trait TestTrait { protected $user; /** * 显式初始化Trait绑定的属性 * 使用该Trait的类需要在初始化流程中主动调用 */ public function initTestTraitData() { $this->user = User::all(); } public function test() { var_dump($this->user); } }
宿主类使用示例:
namespace App\Http\Controllers; class UserController extends Controller { use TestTrait; public function __construct() { // 在宿主类的构造流程中主动触发Trait的初始化 $this->initTestTraitData(); // 其他自定义初始化逻辑正常编写即可 } }
这个方案的优势:
- 不存在构造函数覆盖的隐式冲突,初始化逻辑完全透明,其他开发者看到代码就知道这个Trait需要提前做什么初始化
- 可以灵活控制初始化时机,不需要一构造就查库的场景,完全可以在实际用到属性前再调用初始化方法
额外注意:Laravel 8版本的模型默认存放在
App/Models目录下,原示例代码中写的use App\User;是旧版本的模型路径,路径不匹配也会导致类找不到、查询失败的问题。
内容的提问来源于stack exchange,提问作者alvirbismonte
相关产品推荐
相关产品推荐

