README

Laravel Carta del Docente

这是一个 Laravel 对 datomatic/carta-del-docente 包的包装。

要求

• Laravel >= 9.0
• PHP >= 8.0
• ext-soap

安装

您可以通过 composer 安装此包

composer require datomatic/laravel-carta-del-docente

配置

在测试环境中使用 Carta del Docente 无需进行任何操作，而在生成生产环境的证书时，需要遵循以下指南。

在生产环境中，我们需要在 .env 文件中添加以下两个值

• CARTA_DEL_DOCENTE_CERTIFICATE= 将证书路径设置为项目根目录（请避免将其设置为外部可访问，因此不要将其放在 public 文件夹中）
• CARTA_DEL_DOCENTE_CERTIFICATE_PASSWORD 证书密码
• 可选的 CARTA_DEL_DOCENTE_ENV，因为默认情况下它将使用项目的 APP_ENV

您可以使用以下命令发布 cartade-docente 的配置

php artisan vendor:publish --tag="laravel-carta-del-docente-config"

这是已发布的配置文件的内容

return [
    'certificatePath' => env('CARTA_DEL_DOCENTE_CERTIFICATE'),
    'certificatePassword' => env('CARTA_DEL_DOCENTE_CERTIFICATE_PASSWORD'),
    'environment' => env('CARTA_DEL_DOCENTE_ENV', config('app.env')),
];

使用方法

该包的使用非常简单，可以通过两种方式：facade 和 service container。有关函数的详细信息，请参阅基础包 datomatic/carta-del-docente 和官方文档。

Facade

Facade 是最简单的方法，只需调用 CartaDelDocente，即可直接获得一个客户端，从而可以静态调用其功能。

use Datomatic\LaravelCartaDelDocente\Facades\CartaDelDocente;

CartaDelDocente::merchantActivation();
CartaDelDocente::check(1, 'voucher');
CartaDelDocente::confirm(1, 'voucher', 52.5);

Service container

通过 service container，需要调用 Datomatic\CartaDelDocente\CartaDelDocenteClient 类以获得客户端实例。

use Datomatic\CartaDelDocente\CartaDelDocenteClient;

//Resolve
$client = App::make(CartaDelDocenteClient::class);
$client = app(CartaDelDocenteClient::class);
$client = resolve(CartaDelDocenteClient::class);

//Automatic Injection
public function __construct(public CartaDelDocenteClient $client){}

$client->merchantActivation();
$client->check(1, 'voucher');
$client->confirm(1, 'voucher', 52.5);

测试

composer test

变更日志

请参阅CHANGELOG 以了解最近更改的详细信息。

贡献

请参阅CONTRIBUTING 了解详细信息。

安全漏洞

请查看我们的安全策略，了解如何报告安全漏洞。

鸣谢

• Alberto Peripolli
• 所有贡献者

许可

MIT 许可证 (MIT)。请参阅许可文件了解详细信息。