# laravel-k3cloud

**Repository Path**: Lrun/laravel-k3cloud

## Basic Information

- **Project Name**: laravel-k3cloud
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-08
- **Last Updated**: 2025-08-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



基于给定的代码结构和内容，以下是一个适合该项目的`README.md`文档：

---

# Laravel K3Cloud 扩展包

这是一个为 [Laravel](https://laravel.com) 提供金蝶云（K3Cloud）API 集成的扩展包，旨在简化 Laravel 应用中 K3Cloud 的调用逻辑。通过[kingdee-php/k3cloud](https://github.com/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 安装：
```bash
composer require lrun/laravel-k3cloud
```

2. 发布配置文件：
```bash
php artisan vendor:publish --tag=laravel-k3cloud
```

3. 修改配置文件：
发布后，可以在 `config/k3cloud.php` 中修改 K3Cloud 的连接参数，如 `host_url`, `auth_type`, `username`, `password` 等。

## 使用方法

1. **基础调用**
```php
use Lrun\\LaravelK3cloud\\Facades\\K3Cloud;

// 调用 K3Cloud SDK 的任意方法
$response = K3Cloud::someMethod($arguments);
```

> ⚠️ 注意：若调用的方法在 SDK 中不存在，会抛出 `BadMethodCallException` 异常。

## 配置

默认配置如下：
```php
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)和金蝶官方文档。