PHP依赖倒置原则实战-php教程-PHP中文网

php中依赖倒置（dip）生效的前提是函数参数带接口类型提示，如manage(employee $worker)；若仅定义interface却无类型约束，则运行时无法保证契约，dip失效。

php依赖倒置原则实战

PHP里不加类型提示的`interface`等于没写

弱类型语言下，光定义interface Employee、让Human和Robot去implements，但调用方函数签名仍是function manage($worker)——这不叫依赖倒置，只是“看起来像”。运行时哪怕传个array进去，只要它有work()方法，PHP也不会报错。

真正起效的写法必须带类型约束：

interface Employee {
    public function work(): void;
}
<p>class Human implements Employee { /<em> ... </em>/ }
class Robot implements Employee { /<em> ... </em>/ }</p><p>// ✅ 依赖倒置生效：参数强制是 interface
function manage(Employee $worker): void {
$worker->work();
}</p><p>// ❌ 这行代码一写，DIP就失效了
manage(new Human()); // OK
manage(['work' => fn() => print 'oops']); // PHP 不拦，但契约崩了</p>

类型提示是PHP中唯一能强制“高层只认抽象”的语法手段
IDE跳转、静态分析（如PHPStan）、重构支持全靠它
去掉Employee类型提示，后续加AIAssistant实现也无需改manage()，但没人能保证它真实现了work()

`__construct()`里`new`具体类就是硬编码

常见错误不是不会写接口，而是把具体实现塞进构造函数或方法体里：

class OrderService {
    private $logger;
<pre class="brush:php;toolbar:false;">public function __construct() {
    // ❌ 错在这里：自己 new，绑定死
    $this->logger = new FileLogger(); 
}

public function placeOrder(array $data): bool {
    $this->logger->info('order placed');
    // ...
}

}

后果直接且现实：

单元测试时无法替换FileLogger为NullLogger或Mockery::mock(LoggerInterface::class)
想切到SentryLogger？得全局搜new FileLogger()，改十几处
IOC容器（Laravel/Symfony）完全接管不了这个实例，注入失效

正确做法：只声明接口，让容器或调用方注入

interface LoggerInterface {
    public function info(string $msg): void;
}
<p>class OrderService {
public function __construct(private LoggerInterface $logger) {}
}</p>

Laravel中`Illuminate\Contracts\Cache\Repository`比`Cache`门面更可靠

用Cache::get()写业务逻辑，看似省事，实际埋雷：

PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。

下载

测试时抛Target class [cache] does not exist——因为门面强依赖Laravel容器和HTTP上下文
命令行脚本、队列Worker里复用该类会失败
换缓存驱动（Redis→Memcached）要改所有Cache::调用点，而非只改配置

Contract注入则干净得多：

use Illuminate\Contracts\Cache\Repository;
<p>class ProductExporter {
public function __construct(private Repository $cache) {}</p><pre class="brush:php;toolbar:false;">public function export(): array {
    return $this->cache->remember('products', 3600, fn() => $this->fetchFromDB());
}

}

容器自动注入已配置好的驱动实例（RedisStore/FileStore等）
测试时可直接传Mockery::mock(Repository::class)，零框架依赖
切换驱动只需改config/cache.php中的default项，业务代码不动

接口设计别暴露实现细节，比如`MySQLConnection`或`RedisClient`

一个坏接口会把底层技术栈钉死在契约里，比如：

// ❌ 把实现细节暴露给上层
interface Database {
    public function execute(MySQLi $conn, string $sql): array;
}

这等于告诉所有使用者：“你必须给我MySQLi对象”，后续换PostgreSQL或Eloquent Query Builder就卡住。

好接口只描述“做什么”：

// ✅ 稳定、语义清晰、可迁移
interface Database {
    public function select(string $table, array $conditions = []): array;
    public function insert(string $table, array $data): int;
}