lrun / laravel-k3cloud
K3cloud SDK for Laravel
0.9.3
2025-08-08 09:33 UTC
Requires
- kingdee-php/k3cloud: ^1.1
Requires (Dev)
- laravel/framework: ^8.5
- roave/security-advisories: dev-latest
README
基于给定的代码结构和内容,以下是一个适合该项目的README.md
文档:
Laravel K3Cloud 扩展包
这是一个为 Laravel 提供金蝶云(K3Cloud)API 集成的扩展包,旨在简化 Laravel 应用中 K3Cloud 的调用逻辑。通过kingdee-php/k3cloud,本包提供更便捷的 Facade 和配置管理,以支持快速开发。
目录结构
src/Facades/K3Cloud.php
- 提供 Laravel 的 Facade 访问方式src/K3CloudManager.php
- 管理 K3Cloud SDK 客户端src/K3CloudServiceProvider.php
- Laravel 的服务提供者,注册配置和单例src/config/k3cloud.php
- 默认配置文件,包含 K3Cloud 连接参数
主要功能
- 提供统一的 Facade 访问入口(
K3Cloud
) - 自动加载配置并实例化 SDK 客户端
- 支持通过
__call
方法动态调用 SDK 接口 - 自带默认配置文件,便于扩展和修改
安装
使用 Composer 安装:
composer require lrun/laravel-k3cloud
发布配置文件:
php artisan vendor:publish --tag=laravel-k3cloud
修改配置文件: 发布后,可以在
config/k3cloud.php
中修改 K3Cloud 的连接参数,如host_url
,auth_type
,username
,password
等。
使用方法
- 基础调用
use Lrun\\LaravelK3cloud\\Facades\\K3Cloud;
// 调用 K3Cloud SDK 的任意方法 $response = K3Cloud::someMethod($arguments);
> ⚠️ 注意:若调用的方法在 SDK 中不存在,会抛出 `BadMethodCallException` 异常。
## 配置
默认配置如下:
return [
'auth_type' => 3,
'host_url' => 'https://xx.xxxx.com/k3cloud/',
'acct_id' => '',
'username' => 'admin',
'password' => '123456',
'appid' => '',
'appsecret' => '',
'lcid' => 2052,
'log' => [
'name' => 'k3cloud',
'path' => storage_path('logs/k3cloud/')
],
];
可根据实际需求修改 `config/k3cloud.php` 中的参数。
## 开源许可
本项目遵循 MIT 许可协议。详情请查看 [LICENSE](LICENSE) 文件。
---
如需进一步功能或 SDK 说明,请参考[kingdee-php/k3cloud](https://github.com/kingdee-php/k3cloud)和金蝶官方文档。