PHP面向对象工程实践的庖丁解牛-编程实验室

“PHP 面向对象工程实践” 不是语法堆砌，而是通过对象建模解决真实业务问题的系统性方法论。它融合了设计原则、模式选择、测试驱动、性能考量，最终目标是构建可维护、可扩展、可验证的系统。

一、核心原则：SOLID + 契约编程

▶ 1.SOLID 原则（工程基石）

原则	实践要点	反例
S（单一职责）	1 个类 = 1 个修改原因	`UserService`同时处理邮件发送
O（开闭原则）	扩展开放，修改关闭	用 if-else 新增支付方式
L（里氏替换）	子类可替换父类	重写父类方法改变行为契约
I（接口隔离）	小而专的接口	`UserInterface`包含 20 个方法
D（依赖倒置）	依赖抽象，非具体	`OrderService`直接 new`Alipay`

▶ 2.契约编程（Design by Contract）

前置条件：方法参数校验

publicfunctionwithdraw(float$amount):void{assert($amount>0,'Amount must be positive');}

后置条件：返回值保证

publicfunctionfindById(int$id):?User{// 保证返回 User 或 null}

不变式：对象状态约束

privatestring$email;publicfunction__construct(string$email){assert(filter_var($email,FILTER_VALIDATE_EMAIL));$this->email=$email;}

💡核心认知：
OOP 的本质是“通过对象协作履行契约”

二、工程实践模型：C.O.D.E.

▶ C.O.D.E. =Contract → Object → Dependency → Evidence

字母	含义	实践
C	Contract（契约）	定义接口 + 断言校验
O	Object（对象）	单一职责 + 不变式
D	Dependency（依赖）	依赖注入 + 服务容器
E	Evidence（证据）	单元测试 + 性能报告

▶ 示例：订单支付系统

// C: 契约（接口）interfacePaymentGateway{publicfunctioncharge(float$amount):PaymentResult;}// O: 对象（单一职责）classOrderService{publicfunction__construct(privatePaymentGateway$payment,privateOrderRepository$repo){}publicfunctionpay(int$orderId,float$amount):void{// 前置条件assert($amount>0);$order=$this->repo->findById($orderId);$result=$this->payment->charge($amount);// 后置条件assert($result->isSuccess());$order->markPaid();}}// D: 依赖（注入）$alipay=newAlipayGateway($config);$orderService=newOrderService($alipay,$repo);// E: 证据（测试）publicfunctiontestPaySuccess(){$mockPayment=$this->createMock(PaymentGateway::class);$mockPayment->method('charge')->willReturn(newPaymentResult(true));$service=newOrderService($mockPayment,$repo);$service->pay(1,100.0);$this->assertTrue($repo->findById(1)->isPaid());}

三、关键工程实践

▶ 1.依赖注入（DI） vs 服务定位器

正确 DI：

classOrderService{publicfunction__construct(privateUserRepository$userRepo){}}

错误服务定位器：

classOrderService{publicfunctionprocess(){$user=app(UserRepository::class);// 隐藏依赖}}

优势：
- 可测试（Mock 依赖）
- 可读（依赖显式声明）

▶ 2.值对象（Value Object） vs 实体（Entity）

值对象（不可变）：

finalclassMoney{publicfunction__construct(publicreadonlyfloat$amount){}publicfunctionadd(Money$other):self{returnnewself($this->amount+$other->amount);}}

实体（可变 + ID）：

classUser{publicfunction__construct(privateint$id,privatestring$name){}publicfunctionchangeName(string$name):void{$this->name=$name;}}

▶ 3.异常处理策略

领域异常：

classInsufficientBalanceExceptionextendsDomainException{}

避免返回 null：

// 错误publicfunctionfindById(int$id):?User{...}// 正确publicfunctionfindById(int$id):User{if(!$user)thrownewUserNotFoundException();}

四、性能与 OOP 的平衡

▶ 1.避免过度封装

反例：

classStringWrapper{publicfunction__construct(privatestring$value){}publicfunctiongetValue():string{return$this->value;}}

正例：
基本类型直接使用，仅在需要行为时封装

▶ 2.延迟加载（Lazy Loading）

场景：关联对象昂贵初始化

classOrder{private?User$user=null;publicfunctiongetUser():User{if($this->user===null){$this->user=$this->userRepo->findById($this->userId);}return$this->user;}}

▶ 3.对象池（Object Pool）

场景：高频创建/销毁对象（如数据库连接）

classConnectionPool{privatearray$connections=[];publicfunctiongetConnection():Connection{returnarray_pop($this->connections)?:newConnection();}publicfunctionrelease(Connection$conn):void{$this->connections[]=$conn;}}

五、避坑指南

陷阱	破局方案
为模式而模式	先写简单代码，痛点出现再重构
忽视测试	每个公共方法必须有单元测试
过度设计	遵循 YAGNI（You Aren’t Gonna Need It）
忽略性能	用 Blackfire 分析对象创建开销