alezq1986/zendesk-laravel

v1.0.0 2024-09-26 14:28 UTC

This package is auto-updated.

Last update: 2024-09-26 14:39:28 UTC


README

这是一个 huddledigital/zendesk-laravel 的分支,专门创建用来修复动态创建属性上的警告。

Laravel Zendesk

此包提供了与 Zendesk API 的集成。它支持创建工单、检索和更新工单、删除工单等。

此包简单提供了一个 Zendesk 外观,该外观作为 zendesk/zendesk_api_client_php 包的包装器。

注意:目前仅支持基于令牌的认证。

安装

您可以通过 Composer 使用以下命令安装此包:

composer require alezq1986/zendesk-laravel

您还必须安装服务提供者。

Laravel 5.5+ 用户:此步骤可以跳过,因为该包支持自动发现。

// config/app.php
'providers' => [
    ...
    Huddle\Zendesk\Providers\ZendeskServiceProvider::class,
    ...
];

如果您想使用外观,也必须安装它。

// config/app.php
'aliases' => [
    ..
    'Zendesk' => Huddle\Zendesk\Facades\Zendesk::class,
];

配置

要发布配置文件到 app/config/zendesk-laravel.php,请运行:

php artisan vendor:publish --provider="Huddle\Zendesk\Providers\ZendeskServiceProvider"

使用 环境变量 设置您的配置,可以在您的 .env 文件或服务器的控制面板上设置

  • ZENDESK_SUBDOMAIN

您的 Zendesk 组织 URL 的子域部分。

例如,http://huddledigital.zendesk.com 使用 huddledigital

  • ZENDESK_USERNAME

认证账户的用户名。

  • ZENDESK_TOKEN

API 访问令牌。您可以在: https://SUBDOMAIN.zendesk.com/agent/admin/api/settings 创建一个。

  • ZENDESK_DRIVER (可选)

将此设置为 nulllog 以防止从您的环境中直接调用 Zendesk API。

使用方法

外观

Zendesk 外观作为 Zendesk\API\Client 类的一个实例的包装器。此类上可用的任何方法(在此处查看文档)都可通过外观访问。例如

// Get all tickets
Zendesk::tickets()->findAll();

// Create a new ticket
Zendesk::tickets()->create([
  'subject' => 'Subject',
  'comment' => [
      'body' => 'Ticket content.'
  ],
  'priority' => 'normal'
]);

// Update multiple tickets
Zendesk::ticket([123, 456])->update([
  'status' => 'urgent'
]);

// Delete a ticket
Zendesk::ticket(123)->delete();

依赖注入

如果您不想使用外观,可以跳过在 config/app.php 中添加别名,并直接将 Huddle\Zendesk\Services\ZendeskService 注入到您的类中。然后您可以使用此对象上的所有相同方法,就像在外观上一样。

<?php

use Huddle\Zendesk\Services\ZendeskService;

class MyClass {

    public function __construct(ZendeskService $zendesk_service) {
        $this->zendesk_service = $zendesk_service;
    }

    public function addTicket() {
        $this->zendesk_service->tickets()->create([
              'subject' => 'Subject',
              'comment' => [
                    'body' => 'Ticket content.'
              ],
              'priority' => 'normal'
        ]);
    }

}

此包根据 MIT 许可证 提供。