/api/contracts/overview/contractId要怎么请求接口

Posted 2023-04-26

tags:

篇首语：本文由小常识网(cha138.com)小编为大家整理，主要介绍了/api/contracts/overview/contractId要怎么请求接口相关的知识，希望对你有一定的参考价值。

在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。我们先来看看官方文档中对contracts的定义： Laravel's Contracts are a set of interfaces that define the core services provided by the framework.
意思是说Laravel的Contracts是一个由框架提供的定义了核心服务接口的集合。也就是说，每一个Contract都是一个接口，对应一个框架核心服务。那它的意义何在？官网给出的解释也很简单：使用接口是为了松耦合和简单。先不讲大道理，先来点干货，看看怎么使用contract 先浏览下contracts接口列表：代码如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar …… 太多了，懒得继续贴了，官网手册里有。我们就拿 IlluminateContractsRoutingRegistrar 这个contract来演示一下吧。
首先，打开 app/Providers/AppServiceProvider.php，注意register方法：代码如下:
public function register()

$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现IlluminateContractsAuthRegistrar接口的类AppServicesRegistrar。注意，IlluminateContractsAuthRegistrar就是一个contract。AppServicesRegistrar 这个类文件在 app/Services/Registrar.php。接着我们看 AppHttpControllersAuthAuthController 这个控制器类，看到它有 __construct 构造函数：代码如下:
public function __construct(Guard $auth, Registrar $registrar)

$this->auth = $auth;
$this->registrar = $registrar; $this->middleware('guest', ['except' => 'getLogout']);
它有两个参数，对应的类命名空间在脚本开头可以看到：代码如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar; 这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 AppServicesRegistrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口IlluminateContractsAuthRegistrar的类或对象，有的话就取出来作为实际参数传到构造函数里。整个使用流程其实就可以总结为两个步骤：向容器中注册实现contract接口的对象。
构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。
那么再来说说contract的好处。松耦合官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。先来看看紧耦合的代码：代码如下:
<?php namespace AppOrders;
class Repository
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)

$this->cache = $cache;

/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)

if ($this->cache->has($id))

//

可以看到构造函数中注入了一个详细的缓存实现 SomePackageCacheMemcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。那么，Contract接口是如何解决这个问题的？请看代码：代码如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)

$this->cache = $cache;

注意，缓存实现我们使用了一个接口，也就是contract，IlluminateContractsCacheRepository，因为它只是接口，不需要关心背后是memcache还是redis。简单性如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。参考技术A 在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。我们先来看看官方文档中对contracts的定义： Laravel's Contracts are a set of interfaces that define the core services provided by the framework.
意思是说Laravel的Contracts是一个由框架提供的定义了核心服务接口的集合。也就是说，每一个Contract都是一个接口，对应一个框架核心服务。那它的意义何在？官网给出的解释也很简单：使用接口是为了松耦合和简单。先不讲大道理，先来点干货，看看怎么使用contract 先浏览下contracts接口列表：代码如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar …… 太多了，懒得继续贴了，官网手册里有。我们就拿 IlluminateContractsRoutingRegistrar 这个contract来演示一下吧。
首先，打开 app/Providers/AppServiceProvider.php，注意register方法：代码如下:
public function register()

$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现IlluminateContractsAuthRegistrar接口的类AppServicesRegistrar。注意，IlluminateContractsAuthRegistrar就是一个contract。AppServicesRegistrar 这个类文件在 app/Services/Registrar.php。接着我们看 AppHttpControllersAuthAuthController 这个控制器类，看到它有 __construct 构造函数：代码如下:
public function __construct(Guard $auth, Registrar $registrar)

$this->auth = $auth;
$this->registrar = $registrar; $this->middleware('guest', ['except' => 'getLogout']);
它有两个参数，对应的类命名空间在脚本开头可以看到：代码如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar; 这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 AppServicesRegistrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口IlluminateContractsAuthRegistrar的类或对象，有的话就取出来作为实际参数传到构造函数里。整个使用流程其实就可以总结为两个步骤：向容器中注册实现contract接口的对象。
构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。
那么再来说说contract的好处。松耦合官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。先来看看紧耦合的代码：代码如下:
<?php namespace AppOrders;
class Repository
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)

$this->cache = $cache;

/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)

if ($this->cache->has($id))

//

可以看到构造函数中注入了一个详细的缓存实现 SomePackageCacheMemcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。那么，Contract接口是如何解决这个问题的？请看代码：代码如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)

$this->cache = $cache;

注意，缓存实现我们使用了一个接口，也就是contract，IlluminateContractsCacheRepository，因为它只是接口，不需要关心背后是memcache还是redis。简单性如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。参考技术B 在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。我们先来看看官方文档中对contracts的定义： Laravel's Contracts are a set of interfaces that define the core services provided by the framework.
意思是说Laravel的Contracts是一个由框架提供的定义了核心服务接口的集合。也就是说，每一个Contract都是一个接口，对应一个框架核心服务。那它的意义何在？官网给出的解释也很简单：使用接口是为了松耦合和简单。先不讲大道理，先来点干货，看看怎么使用contract 先浏览下contracts接口列表：代码如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar …… 太多了，懒得继续贴了，官网手册里有。我们就拿 IlluminateContractsRoutingRegistrar 这个contract来演示一下吧。
首先，打开 app/Providers/AppServiceProvider.php，注意register方法：代码如下:
public function register()

$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现IlluminateContractsAuthRegistrar接口的类AppServicesRegistrar。注意，IlluminateContractsAuthRegistrar就是一个contract。AppServicesRegistrar 这个类文件在 app/Services/Registrar.php。接着我们看 AppHttpControllersAuthAuthController 这个控制器类，看到它有 __construct 构造函数：代码如下:
public function __construct(Guard $auth, Registrar $registrar)

$this->auth = $auth;
$this->registrar = $registrar; $this->middleware('guest', ['except' => 'getLogout']);
它有两个参数，对应的类命名空间在脚本开头可以看到：代码如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar; 这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 AppServicesRegistrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口IlluminateContractsAuthRegistrar的类或对象，有的话就取出来作为实际参数传到构造函数里。整个使用流程其实就可以总结为两个步骤：向容器中注册实现contract接口的对象。
构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。
那么再来说说contract的好处。松耦合官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。先来看看紧耦合的代码：代码如下:
<?php namespace AppOrders;
class Repository
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)

$this->cache = $cache;

/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)

if ($this->cache->has($id))

//

可以看到构造函数中注入了一个详细的缓存实现 SomePackageCacheMemcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。那么，Contract接口是如何解决这个问题的？请看代码：代码如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)

$this->cache = $cache;

注意，缓存实现我们使用了一个接口，也就是contract，IlluminateContractsCacheRepository，因为它只是接口，不需要关心背后是memcache还是redis。简单性如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。参考技术C 在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。我们先来看看官方文档中对contracts的定义： Laravel's Contracts are a set of interfaces that define the core services provided by the framework.
意思是说Laravel的Contracts是一个由框架提供的定义了核心服务接口的集合。也就是说，每一个Contract都是一个接口，对应一个框架核心服务。那它的意义何在？官网给出的解释也很简单：使用接口是为了松耦合和简单。先不讲大道理，先来点干货，看看怎么使用contract 先浏览下contracts接口列表：代码如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar …… 太多了，懒得继续贴了，官网手册里有。我们就拿 IlluminateContractsRoutingRegistrar 这个contract来演示一下吧。
首先，打开 app/Providers/AppServiceProvider.php，注意register方法：代码如下:
public function register()

$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现IlluminateContractsAuthRegistrar接口的类AppServicesRegistrar。注意，IlluminateContractsAuthRegistrar就是一个contract。AppServicesRegistrar 这个类文件在 app/Services/Registrar.php。接着我们看 AppHttpControllersAuthAuthController 这个控制器类，看到它有 __construct 构造函数：代码如下:
public function __construct(Guard $auth, Registrar $registrar)

$this->auth = $auth;
$this->registrar = $registrar; $this->middleware('guest', ['except' => 'getLogout']);
它有两个参数，对应的类命名空间在脚本开头可以看到：代码如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar; 这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 AppServicesRegistrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口IlluminateContractsAuthRegistrar的类或对象，有的话就取出来作为实际参数传到构造函数里。整个使用流程其实就可以总结为两个步骤：向容器中注册实现contract接口的对象。
构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。
那么再来说说contract的好处。松耦合官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。先来看看紧耦合的代码：代码如下:
<?php namespace AppOrders;
class Repository
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)

$this->cache = $cache;

/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)

if ($this->cache->has($id))

//

可以看到构造函数中注入了一个详细的缓存实现 SomePackageCacheMemcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。那么，Contract接口是如何解决这个问题的？请看代码：代码如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)

$this->cache = $cache;

注意，缓存实现我们使用了一个接口，也就是contract，IlluminateContractsCacheRepository，因为它只是接口，不需要关心背后是memcache还是redis。简单性如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。参考技术D 在Laravel5中出现了一个新的东西，叫做contracts，那么它到底是什么？有什么用？怎么用？我们就来探讨下吧。我们先来看看官方文档中对contracts的定义： Laravel's Contracts are a set of interfaces that define the core services provided by the framework.
意思是说Laravel的Contracts是一个由框架提供的定义了核心服务接口的集合。也就是说，每一个Contract都是一个接口，对应一个框架核心服务。那它的意义何在？官网给出的解释也很简单：使用接口是为了松耦合和简单。先不讲大道理，先来点干货，看看怎么使用contract 先浏览下contracts接口列表：代码如下:
IlluminateContractsAuthGuard
IlluminateContractsAuthPasswordBroker
IlluminateContractsBusDispatcher
IlluminateContractsCacheRepository
IlluminateContractsCacheFactory
IlluminateContractsConfigRepository
IlluminateContractsContainerContainer
IlluminateContractsCookieFactory
IlluminateContractsCookieQueueingFactory
IlluminateContractsEncryptionEncrypter
IlluminateContractsRoutingRegistrar …… 太多了，懒得继续贴了，官网手册里有。我们就拿 IlluminateContractsRoutingRegistrar 这个contract来演示一下吧。
首先，打开 app/Providers/AppServiceProvider.php，注意register方法：代码如下:
public function register()

$this->app->bind(
'IlluminateContractsAuthRegistrar',
'AppServicesRegistrar'
);
$this->app 就是Application对象，也是容器对象，通过 $this->app->bind 方法我们绑定了一个实现IlluminateContractsAuthRegistrar接口的类AppServicesRegistrar。注意，IlluminateContractsAuthRegistrar就是一个contract。AppServicesRegistrar 这个类文件在 app/Services/Registrar.php。接着我们看 AppHttpControllersAuthAuthController 这个控制器类，看到它有 __construct 构造函数：代码如下:
public function __construct(Guard $auth, Registrar $registrar)

$this->auth = $auth;
$this->registrar = $registrar; $this->middleware('guest', ['except' => 'getLogout']);
它有两个参数，对应的类命名空间在脚本开头可以看到：代码如下:
use IlluminateContractsAuthGuard;
use IlluminateContractsAuthRegistrar; 这两个都是contract，但我们这里就拿 Registrar 说，我们注意到这里面只是通过参数类型指明了$registrar的接口类型，而实际调用的时候实际上是 AppServicesRegistrar 这个类，这就是依赖注入的特性了，Laravel会自动在容器中搜索实现了接口IlluminateContractsAuthRegistrar的类或对象，有的话就取出来作为实际参数传到构造函数里。整个使用流程其实就可以总结为两个步骤：向容器中注册实现contract接口的对象。
构造函数参数类型指定为contract接口类，框架会自动找到符合条件的对象。
那么再来说说contract的好处。松耦合官网给了一个例子解释什么是紧耦合以及Contract接口为何能够松耦合。先来看看紧耦合的代码：代码如下:
<?php namespace AppOrders;
class Repository
/**
* The cache.
*/
protected $cache;
/**
* Create a new repository instance.
*
* @param SomePackageCacheMemcached $cache
* @return void
*/
public function __construct(SomePackageCacheMemcached $cache)

$this->cache = $cache;

/**
* Retrieve an Order by ID.
*
* @param int $id
* @return Order
*/
public function find($id)

if ($this->cache->has($id))

//

可以看到构造函数中注入了一个详细的缓存实现 SomePackageCacheMemcached ，如果换Redis作为缓存服务器或者更改了api方法，就需要修改，而如果项目很大，你不知道还有多少地方需要修改。那么，Contract接口是如何解决这个问题的？请看代码：代码如下:
<?php namespace AppOrders;
use IlluminateContractsCacheRepository as Cache;
class Repository
/**
* Create a new repository instance.
*
* @param Cache $cache
* @return void
*/
public function __construct(Cache $cache)

$this->cache = $cache;

注意，缓存实现我们使用了一个接口，也就是contract，IlluminateContractsCacheRepository，因为它只是接口，不需要关心背后是memcache还是redis。简单性如果所有服务都使用接口定义，就可以很简单的决定一个服务需要的功能，更加容易维护和扩展，并且contract接口还能看作一个简洁的文档便于阅读。