lrun/laravel-k3cloud

K3cloud SDK for Laravel

0.9.3 2025-08-08 09:33 UTC

This package is auto-updated.

Last update: 2025-08-08 09:34:31 UTC


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 接口
  • 自带默认配置文件,便于扩展和修改

安装

  1. 使用 Composer 安装:

    composer require lrun/laravel-k3cloud
    
  2. 发布配置文件:

    php artisan vendor:publish --tag=laravel-k3cloud
    
  3. 修改配置文件: 发布后,可以在 config/k3cloud.php 中修改 K3Cloud 的连接参数,如 host_url, auth_type, username, password 等。

使用方法

  1. 基础调用
    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)和金蝶官方文档。