aleahy/laravel-saasu-connect

Laravel 对 SaasuConnect 的封装

1.0 2024-09-09 11:45 UTC

This package is auto-updated.

Last update: 2024-09-09 11:45:50 UTC


README

为 SaasuConnect 提供的 Laravel 封装

概述

此包可以被导入到 Laravel 中,以便能够对 Saasu API 进行请求。

安装

composer require aleahy/laravel-saasu-connect

然后发布配置文件,以便能够访问您的 saasu 用户名、密码和文件 ID。

php artisan vendor:publish --provider="Aleahy\LaravelSaasuConnect\ServiceProvider" --tag=config

用法

使用 SaasuAPI 门面对 Saasu API 进行调用。

use Aleahy\LaravelSaasuConnect\Facade\SaasuAPI;
use Aleahy\SaasuConnect\Entities\Invoice as SaasuInvoice;

SaasuAPI::findEntity(SaasuInvoice::class, [
  'AmountOwed' => 490.0
]);

可用方法

目前存在以下方法

findEntity - 根据搜索属性找到提供的实体。返回实体集合。

insertEntity - 对给定实体进行带有提供属性的 POST 请求。

getEntity - 返回具有给定 ID 的特定实体。

getAllEntities - 返回单个数组中的所有实体。

可用实体

  • 公司
  • 联系人
  • 发票

HasSaasuEntity 特性

模型也可以与 saasu ID 关联。此特性添加了一个 SaasuEntity hasOne 关系,该关系包含 saasu ID。

将特性 HasSaasuEntity 添加到您的模型中将为它们分配一个模型来手动跟踪 saasu ID。

安装

将特性 HasSaasuEntity 添加到您的模型。

您还需要发布迁移来存储 saasu ID。

php artisan vendor:publish --provider="Aleahy\LaravelSaasuConnect\ServiceProvider" --tag=migrations

可用方法

setSaasuID - 为模型设置 saasu ID 的值。

getSaasuID - 返回模型 saasu ID 的值。

hasSaasuID - 返回 true 或 false,取决于是否已设置 saasuID 值。