0

0

laravel怎么通过契约(Contracts)编程_laravel契约(Contracts)编程方法

冰火之心

冰火之心

发布时间:2025-12-14 22:27:53

|

376人浏览过

|

来源于php中文网

原创

Laravel通过契约实现松耦合,提升可测试性与可维护性。首先,契约是illuminate/contracts包中的接口,用于定义核心服务的API,开发者应依赖接口而非具体实现。在自定义类中通过类型提示引入如Queue或Cache等契约,由服务容器自动注入实例,实现解耦。其次,在服务类中使用构造函数注入契约,例如SmsSender注入Queue契约,调用push方法时实际执行配置的队列驱动操作。第三,可自定义契约并绑定实现,如创建PaymentGateway契约接口,由StripePaymentService实现,并在AppServiceProvider中注册绑定。第四,在控制器中也应依赖契约,如注入Cache Store接口进行缓存操作,便于后续更换驱动而不修改业务代码。最后,尽管门面提供便捷访问,但其为静态代理,隐藏依赖,不利于测试;在复杂逻辑中应优先使用契约依赖注入,便于模拟和替换行为,遵循面向接口设计原则。

laravel怎么通过契约(contracts)编程_laravel契约(contracts)编程方法

如果您在使用Laravel框架进行开发时,希望利用其强大的解耦特性来提升代码的可测试性和可维护性,那么通过契约(Contracts)编程是一个理想的选择。Laravel中的契约是一组定义服务接口的接口类,它们允许您明确地声明依赖关系,从而实现松耦合的设计。

本文运行环境:MacBook Pro,macOS Sonoma

一、理解Laravel契约的作用

Laravel契约是框架中各个核心服务的接口定义,它们存在于illuminate/contracts包中。通过依赖这些接口而非具体实现,您可以更容易地替换底层服务或编写模拟对象用于单元测试。

1、打开项目中的vendor/illuminate/contracts目录,浏览可用的契约列表,例如Queue\QueueableCache\Store等。

2、在自定义类中通过类型提示引入所需契约接口,让Laravel的服务容器自动注入对应实例。

二、在服务类中使用契约依赖注入

通过构造函数或方法注入的方式引入契约接口,可以确保您的代码不依赖于特定实现,而是面向接口编程,提高灵活性。

1、创建一个新服务类,例如SmsSender.php,并在其中引入Illuminate\Contracts\Queue\Queue契约。

2、在构造函数中添加参数类型为\Illuminate\Contracts\Queue\Queue的对象。

3、调用该对象的方法如push()时,实际执行的是当前配置驱动(如Redis、Database)的队列操作。

三、绑定自定义契约实现

您可以定义自己的契约接口并注册到服务容器中,以支持扩展或替换Laravel内置功能。

1、在app/Contracts目录下新建接口文件PaymentGateway.php,声明charge()方法。

奇布塔
奇布塔

基于AI生成技术的一站式有声绘本创作平台

下载

2、在app/Services目录下创建实现类StripePaymentService.php,实现上述接口。

3、在AppServiceProviderregister()方法中添加:$this->app->bind(\App\Contracts\PaymentGateway::class, \App\Services\StripePaymentService::class);

四、在控制器中调用契约定义的服务

控制器应依赖契约而非具体类,这有助于保持高层逻辑与底层实现分离。

1、在控制器构造函数中接收实现了契约的类实例,例如注入\Illuminate\Contracts\Cache\Store

2、使用该实例调用get()put()方法操作缓存数据。

3、由于依赖的是接口,后续可自由切换缓存驱动而无需修改控制器代码。

五、使用门面替代契约的注意事项

虽然Laravel提供了门面对契约的便捷访问方式,但在需要更高控制度的场景下,直接使用契约更为合适。

1、避免在复杂业务逻辑中过度使用门面,因其隐藏了真实依赖关系,不利于测试。

2、当需要模拟某个服务行为时,优先选择通过契约进行依赖注入,并在测试中传入Mock对象。

3、记住,门面本质是静态代理,而契约体现的是面向接口设计原则,两者适用场景不同。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2788

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1688

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1548

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

1036

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1485

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1256

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1589

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1307

2023.11.13

C++ 高级模板编程与元编程
C++ 高级模板编程与元编程

本专题深入讲解 C++ 中的高级模板编程与元编程技术,涵盖模板特化、SFINAE、模板递归、类型萃取、编译时常量与计算、C++17 的折叠表达式与变长模板参数等。通过多个实际示例,帮助开发者掌握 如何利用 C++ 模板机制编写高效、可扩展的通用代码,并提升代码的灵活性与性能。

2

2026.01.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 9.2万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 10万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号