instacar / autometrica-webservice-client
与 Autometrica Webservice 通信的 Web 服务客户端
v1.0.0
2022-03-15 18:49 UTC
Requires
- php: >=7.4
- doctrine/annotations: ^1.13
- doctrine/collections: ^1.6.8
- psr/http-client: ^1.0.1
- psr/http-factory: ^1.0.1
- psr/http-message: ^1.0.1
- symfony/property-access: ^4.4|^5.4|^6.0
- symfony/property-info: ^4.4|^5.4|^6.0
- symfony/serializer: ^4.4|^5.4|^6.0
Requires (Dev)
- nyholm/psr7: ^1.5
- phpstan/phpstan: ^1.4
- phpunit/phpunit: ^9.5
- roave/security-advisories: dev-latest
- squizlabs/php_codesniffer: ^3.6
- symfony/http-client: ^4.4|^5.4|^6.0
This package is auto-updated.
Last update: 2024-09-20 04:08:53 UTC
README
Autométrica Webservice 的非官方实现。
注释
这个库与 Autométrica 没有任何关系和形式。它仅仅是一个衍生的作品,为了能够以简单、实用的方式通过 POPO (Plain Old PHP Objects) 模型使用 Autométrica Webservice。
安装
依赖项
这个库依赖于实现 PSR-18 接口的 HTTP 客户端。你可以按照以下方式安装这个实现的标准客户端:
composer require symfony/http-client
库
安装客户端很简单,只需执行以下命令:
composer require instacar/autometrica-webservice-client
使用方法
要使用客户端,你可以创建一个默认实例,该实例将负责创建 HTTP PSR-18 客户端。客户端为 Autometrica Webservice 的每个端点提供了一种方法。例如,为了请求车辆目录:
use Instacar\AutometricaWebserviceClient\AutometricaClient; $cliente = AutometricaClient::createDefault($username, $password); $catalogo = $cliente->getCatalog();
每个 Webservice 实体都由一个 PHP 类建模,该类为每个属性提供了 getter,旨在为 IDE 提供更好的帮助和自动完成功能,并为每个属性提供严格的数据类型。继续上述示例:
foreach ($catalogo as $vehiculo) { echo $vehiculo->getBrand(); // La marca del vehículo echo $vehiculo->getModel(); // El modelo del vehículo echo $vehiculo->getYear(); // EL año del vehículo echo $vehiculo->getTrim(); // La versión del vehículo }
如果您想查看实现的方法和模型,请参阅文档。
高级
如果您想使用自己的 HTTP PSR-18 客户端实现,可以直接使用 HTTP 客户端实例化 AutometricaClient
。
use Instacar\AutometricaWebserviceClient\AutometricaClient; $cliente = new AutometricaClient($clienteHttp, $username, $password);
许可证
这个库使用 Lesser General Public Licence Version 3 (LGPLv3)。您可以在 LICENSE 文件中查看。