PHPackages                             qqchen/dify-laravel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [API Development](/categories/api)
4. /
5. qqchen/dify-laravel

ActiveLibrary[API Development](/categories/api)

qqchen/dify-laravel
===================

Dify SDK for Laravel, supporting Knowledge Base and Chat APIs.

v1.1.2(3mo ago)10AGPL-3.0PHPPHP ^7.2|^8.0

Since Jan 7Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/hei0323/dify-laravel)[ Packagist](https://packagist.org/packages/qqchen/dify-laravel)[ RSS](/packages/qqchen-dify-laravel/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (2)Versions (6)Used By (0)

Dify SDK for Laravel
====================

[](#dify-sdk-for-laravel)

A powerful, feature-rich Laravel SDK for Dify.ai, supporting Knowledge Base management, Chatflow (Workflows), Multi-tenancy, Streaming responses, and advanced Document Segment control.

这是一个功能强大的 Dify.ai Laravel SDK，支持知识库管理、工作流（Chatflow/Workflow）、多租户架构、流式对话响应以及精细化的文档分段管理。

🌟 Features (特性)
---------------

[](#-features-特性)

- **Multi-Tenancy Support (多租户支持):** Easily manage different API keys for different tenants (Stores/Users) via configuration or database.
- **Separated Keys (密钥分离):** Support distinct keys for Knowledge Base (Dataset) and Chatflow (Workflow) within the same tenant.
- **Multi-App Support (多应用支持):** Configure multiple Chatflow Apps (e.g., Marketing Bot, Support Bot) for a single tenant.
- **Knowledge Base Management (知识库管理):** Create datasets, upload documents (local/URL), manage metadata, and tags.
- **Document Segments (文档分段):** Fine-grained control over document chunks (list, add, update, delete, child-chunks).
- **Models Management (模型管理):** Retrieve available embedding models from Dify.
- **Chatflow & Streaming (对话流与流式响应):** Send messages, handle streaming responses (SSE), upload files/audio, and text-to-speech.
- **Workflow Execution (工作流执行)::** Trigger workflow runs, handle file inputs, and retrieve execution logs.
- **Metadata & Tags (元数据与标签):** Comprehensive management for dataset metadata and tagging system.

📦 Installation (安装)
-------------------

[](#-installation-安装)

Install the package via Composer:

`composer require qqchen/dify-laravel`

Publish the configuration file:

` php artisan vendor:publish --tag=dify-config`

⚙️ Configuration (配置)
---------------------

[](#️-configuration-配置)

### 1. Basic Configuration (单租户模式)

[](#1-basic-configuration-单租户模式)

If you are building a single-tenant application, simply add your keys to your .env file:

```
DIFY_API_KEY=your-common-api-key
# OR separate keys if needed
DIFY_DATASET_API_KEY=your-dataset-key
DIFY_CHATFLOW_API_KEY=your-chatflow-key

DIFY_BASE_URL=[https://api.dify.ai/v1](https://api.dify.ai/v1)

```

### 2. Multi-Tenant Configuration (多租户模式)

[](#2-multi-tenant-configuration-多租户模式)

This SDK shines in SaaS applications. You can configure it to fetch API keys dynamically based on a tenant ID (e.g., `store_id`).

Edit `config/dify.php` to enable multi-tenancy and choose a driver (`model` or `config`).

### Option A: Database Model Driver (Recommended for SaaS)

[](#option-a-database-model-driver-recommended-for-saas)

Map your database columns to Dify keys.

```
// config/dify.php
'multi_tenant' => [
    'enabled' => true,
    'driver' => 'model',
    'model' => [
        'class' => \App\Models\StoreConfig::class, // Your Tenant Model
        'foreign_key' => 'store_id',               // The column to match tenant($id)
        'mapping' => [
            'dataset_api_key'  => 'dify_dataset_key', // DB column for Dataset Key

            // Map multiple bots to a JSON column (e.g. {"default": "key1", "marketing": "key2"})
            'chatflow_api_key' => 'dify_chatflow_keys', // DB column (JSON)

            // Map multiple workflows to a JSON column
            'workflow_api_key' => 'dify_workflow_keys', // DB column (JSON)

            'base_url'         => 'dify_base_url',    // DB column for private deployment URL
        ],
    ],
],

```

### Option B: Config Array Driver

[](#option-b-config-array-driver)

Define tenants directly in the config file.

```
// config/dify.php
'multi_tenant' => [
    'enabled' => true,
    'driver' => 'config',
    'config' => [
        '1001' => [
            'dataset_api_key' => 'kb-key-1001',
            'chatflow_api_key' => [
                'default' => 'chat-key-1001',
                'marketing' => 'marketing-key-1001'
            ],
            'workflow_api_key' => [
                'default' => 'wf-key-1001',
                'translator' => 'translator-key-1001'
            ],
            'base_url' => '[https://private-dify.com/v1](https://private-dify.com/v1)',
        ],
    ],
],

```

🚀 Usage (使用方法)
--------------

[](#-usage-使用方法)

### Initialization (初始化)

[](#initialization-初始化)

```
use QQChen\Dify\Facades\Dify;

// 1. Single Tenant (Default)
Dify::dataset()->list();

// 2. Multi-Tenant (Switch Context)
// Automatically fetches keys for store_id 1001 from DB/Config
Dify::tenant(1001)->dataset()->list();

// 3. Manual Keys (On-the-fly)
Dify::withKey('your-api-key')->chatflow()->sendMessage(...);

```

### 📚 Knowledge Base (知识库)

[](#-knowledge-base-知识库)

### Create Dataset (创建知识库)

[](#create-dataset-创建知识库)

```
$response = Dify::dataset()->create('My Knowledge Base', 'Description');
$datasetId = $response['id'];

```

### Upload Document (上传文档)

[](#upload-document-上传文档)

Supports local files and remote URLs.

```
// Upload local file
Dify::document()->createByFile($datasetId, '/path/to/file.pdf', [
    'mode' => 'automatic',
    'file_name' => 'manual.pdf' // Optional override
]);

// Upload from URL
Dify::document()->createByFile($datasetId, '[https://example.com/doc.pdf](https://example.com/doc.pdf)');

```

### Retrieve (测试检索)

[](#retrieve-测试检索)

Use the SDK's built-in retrieval presets (vector, full\_text, hybrid\_rerank).

```
// Simple usage with presets
Dify::dataset()->retrieve($datasetId, 'How to use this?', 'hybrid_rerank');

// Override specific parameters
Dify::dataset()->retrieve($datasetId, 'How to use this?', 'vector', ['top_k' => 10]);

```

### 🧩 Document Segments (文档分段)

[](#-document-segments-文档分段)

Manage chunks within a document.

```
// List segments
$segments = Dify::segment()->list($datasetId, $documentId);

// Add new segments
Dify::segment()->create($datasetId, $documentId, [
    ['content' => 'This is chunk 1', 'keywords' => ['test']],
    ['content' => 'This is chunk 2']
]);

// Update a segment
Dify::segment()->update($datasetId, $documentId, $segmentId, [
    'content' => 'Updated content',
    'enabled' => true
]);

// Delete a segment
Dify::segment()->delete($datasetId, $documentId, $segmentId);

```

### 🤖 Models (模型管理)

[](#-models-模型管理)

Get available embedding models for creating datasets.

```
$models = Dify::model()->getEmbeddingModels();

```

### 💬 Chatflow / Agent (工作流对话)

[](#-chatflow--agent-工作流对话)

### Send Message (发送消息)

[](#send-message-发送消息)

### Blocking Mode (Wait for full response):

[](#blocking-mode-wait-for-full-response)

```
$response = Dify::chatflow()->sendMessage(
    'Hello, who are you?',
    'user-123',
    [], // inputs
    'blocking'
);
echo $response['data']['answer'];

```

### Streaming Mode (Real-time SSE):

[](#streaming-mode-real-time-sse)

*Note: In your Controller, return a StreamedResponse to stream data to the frontend.*

```
// Controller
public function chat(Request $request)
{
$response = Dify::chatflow()->sendMessage(
$request->input('query'),
'user-123',
[],
'streaming'
);

    // Stream the raw Guzzle response body
    return response()->stream(function () use ($response) {
        $body = $response->getBody();
        while (!$body->eof()) {
            echo $body->read(1024);
            ob_flush();
            flush();
        }
    }, 200, [
        'Content-Type' => 'text/event-stream',
        'X-Accel-Buffering' => 'no',
    ]);
}

```

### Multiple Bots (多应用调用)

[](#multiple-bots-多应用调用)

If you configured multiple chatflow keys (e.g., `default`, `marketing`):

```
// Use the 'default' bot
Dify::chatflow()->sendMessage(...);

// Use the 'marketing' bot
Dify::chatflow('marketing')->sendMessage(...);

```

### ⚙️ Workflow (工作流)

[](#️-workflow-工作流)

Manage and run Workflow apps (Text Generator, Translator, etc.).

### Run Workflow (执行工作流)

[](#run-workflow-执行工作流)

```
// Blocking Mode
$result = Dify::workflow()->run(
    ['input_1' => 'value'], // inputs
    'user-123',
    'blocking'
);

// Streaming Mode (same as Chatflow example above)
$stream = Dify::workflow()->run(
    ['input_1' => 'value'],
    'user-123',
    'streaming'
);

```

### Other Workflow Actions

[](#other-workflow-actions)

```
// Get Workflow Logs
Dify::workflow()->getLogs(['status' => 'succeeded']);

// Upload File for Workflow
Dify::workflow()->uploadFile('/path/to/image.png', 'user-123');

// Use specific Workflow App
Dify::workflow('translator')->run(...);

```

### 🏷️ Tags & Metadata (标签与元数据)

[](#️-tags--metadata-标签与元数据)

Comprehensive management for organizing your datasets.

### Tag Management (标签管理)

[](#tag-management-标签管理)

```
// List all tags
$tags = Dify::tag()->list();

// Create a new tag
$tag = Dify::tag()->create('HR Documents');

// Update a tag
Dify::tag()->update($tag['id'], 'Human Resources');

// Delete a tag
Dify::tag()->delete($tag['id']);

// Bind tag to a dataset
Dify::tag()->bind($datasetId, [$tag['id']]);

// Unbind tag from a dataset
Dify::tag()->unbind($datasetId, $tag['id']);

```

### Metadata Management (元数据管理)

[](#metadata-management-元数据管理)

```
// List metadata fields for a dataset
$fields = Dify::metadata()->list($datasetId);

// Create a new metadata field
// types: 'string', 'number', 'time'
Dify::metadata()->createField($datasetId, 'category', 'string');

// Update metadata field (name only)
Dify::metadata()->updateField($datasetId, $metadataId, 'new_category_name');

// Delete metadata field
Dify::metadata()->deleteField($datasetId, $metadataId);

// Batch update metadata for documents
Dify::metadata()->updateDocumentsMetadata($datasetId, [
    [
        'document_id' => 'doc-uuid-1',
        'metadata_list' => [
            ['id' => 'meta-uuid-1', 'value' => 'Finance', 'name' => 'category'],
            ['id' => 'meta-uuid-2', 'value' => 2024, 'name' => 'year']
        ]
    ]
]);

```

📜 License
---------

[](#-license)

This project is licensed under the **GNU Affero General Public License v3.0 (AGPL-3.0).**See the LICENSE file for details.

###  Health Score

34

—

LowBetter than 77% of packages

Maintenance78

Regular maintenance activity

Popularity2

Limited adoption so far

Community4

Small or concentrated contributor base

Maturity43

Maturing project, gaining track record

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~2 days

Total

5

Last Release

117d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a3919a01c20e0f9ce019870f311071ee977e42a2f67035d4de76cdf3e5fcb64f?d=identicon)[hei0323](/maintainers/hei0323)

---

Tags

laravelsdkaillmdify

### Embed Badge

![Health badge](/badges/qqchen-dify-laravel/health.svg)

```
[![Health](https://phpackages.com/badges/qqchen-dify-laravel/health.svg)](https://phpackages.com/packages/qqchen-dify-laravel)
```

###  Alternatives

[claude-php/claude-php-sdk-laravel

Laravel integration for the Claude PHP SDK - Anthropic Claude API

5010.8k](/packages/claude-php-claude-php-sdk-laravel)[neuron-core/neuron-laravel

Official Neuron AI Laravel SDK.

10710.0k](/packages/neuron-core-neuron-laravel)[gemini-api-php/laravel

Gemini API client for Laravel

8915.7k](/packages/gemini-api-php-laravel)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)