PHP接口编程本质是用interface约束行为、解耦实现、支撑可替换与可测试，而非写返回JSON的HTTP API；interface是代码契约，与网络协议层的API无关，混淆二者将导致无法理解Laravel等框架的设计。
PHP接口编程不是学“怎么写一个能返回JSON的文件”，而是学「如何用interface约束行为、解耦实现、支撑可替换与可测试」——这是绝大多数初学者一上来就搞反的方向。
别把interface当成api.php来学
搜索“PHP接口”时，大量结果指向HTTP API（比如api.php接收GET/POST并json_encode），但这和面向对象里的interface完全无关。前者是网络通信协议层的概念，后者是代码设计契约层的机制。混淆这两者，会导致你花几周学完“接口开发”，却依然看不懂Laravel源码里满屏的CacheInterface、MailerInterface。
- 看到
interface UserRepository，它不处理HTTP请求，也不输出JSON，只规定“必须有find()、save()” - 看到
class DatabaseUserRepository implements UserRepository，说明这个类承诺了行为，但具体怎么查数据库、用PDO还是Redis，interface不管 - 如果你在写
api.php，那根本用不到interface关键字；但如果你在写可维护的业务逻辑，不用interface迟早要重写三遍
implements报错时，先检查这三件事
常见错误信息：Fatal error: Class XXX contains 1 abstract method and must therefore be declared abstract or implement the remaining methods。这不是语法错，是契约违约。
- 方法名拼错：接口写的是
getUserById()，类里实现成getUserId()—— PHP区分大小写，不会自动匹配 - 参数数量或类型不一致：接口声明
function update(int $id, array $data)，类里写成function update($id, $data)（PHP 7.0+启用了严格模式后会直接报TypeError） - 漏掉
public修饰符：接口方法默认public，但类中实现时如果写private function find()，PHP会认为你没实现，而不是“权限降级”
多接口实现时，方法冲突怎么破
当一个类implements A, B，而A和B都定义了同名方法（比如都含log()），PHP不会报错，但你必须提供唯一实现 —— 这个实现同时服务于两个契约。
立即学习“PHP免费学习笔记（深入）”；
- 这不是bug，是设计信号：如果两个接口要求同一方法，说明它们在语义上存在交集，比如
Loggable和Reportable都要求log()，那你的类就该有一个统一的日志入口 - 避免强行“合并”：不要因为A要
log(string $msg)、B要log(array $context)，就在类里写两个重载版本 —— PHP不支持方法重载，只能选其一或用变通（如接受mixed再内部判断） - 更推荐做法：重构接口，把共用行为抽成第三个接口
LoggerInterface，让A和B都extends LoggerInterface，清晰表达依赖关系
类型提示里用interface比用class更安全
函数参数写function sendEmail(Mailer $mailer)，意味着你锁死了具体类；而写function sendEmail(MailerInterface $mailer)，才真正获得替换自由。
- 测试时可传
MockMailer，无需启动SMTP服务 - 上线后可无缝切换
SendgridMailer或MailgunMailer，只要它们都实现了MailerInterface - 注意：PHP不会自动检查“类是否真实现了接口”，只有在运行时传参那一刻才校验 —— 所以
TypeError往往出现在调用点，而非定义点
真正卡住人的从来不是语法，而是想清楚“这个行为契约，到底该由谁承诺、谁实现、谁消费”。写十个api.php不如认真实现一个PaymentProcessorInterface并替换三次真实支付网关 —— 那才算摸到接口编程的边。
