怎样在CodeIgniter中使用Zendesk_CodeIgniter客服集成方案【方案】-php教程-PHP中文网

codeigniter集成zendesk应选用api token认证，因其不依赖用户会话、适合后台调用；需base64编码邮箱/token并设authorization头，配合accept/content-type: application/json、json_encode请求体、ssl验证配置及完整错误处理与日志记录。

怎样在codeigniter中使用zendesk_codeigniter客服集成方案【方案】

CodeIgniter 本身不提供 Zendesk 官方 SDK，集成必须走 REST API + 手动封装，硬套现成类库大概率失败。

Zendesk API 认证方式选哪一种

Zendesk 支持三种认证：API Token、OAuth 2.0、JWT。对 CodeIgniter 这类无前端会话管理的 PHP 应用，API Token 最直接可靠——它不依赖用户登录态，适合后台服务调用（如工单创建、评论更新）。OAuth 2.0 需要完整授权流程和 token 刷新逻辑，CI 项目若没做 session/cookie 统一管理，极易卡在 invalid_grant 或过期失效；JWT 更适合嵌入 Zendesk Apps 场景，不适用于后端主动调用。

使用 API Token 时，格式为 email/token:your_token，必须 Base64 编码后放入 Authorization 请求头
邮箱必须是 Zendesk 管理员或具备 API 权限的账号，不能是普通客服坐席邮箱
Token 在 Zendesk 后台「Settings > Account > Channels > API」中生成，每次生成只显示一次，务必保存

封装 Zendesk API 客户端要注意 cURL 设置

直接复用 CodeIgniter 自带的 curl 类或写裸 cURL 都行，但以下参数不可省略，否则常见 401 Unauthorized 或 422 Unprocessable Entity：

CURLOPT_SSL_VERIFYPEER 必须设为 false（仅开发环境）或指向真实 CA bundle 路径（生产环境），Zendesk 的证书链有时触发 OpenSSL 验证失败
CURLOPT_HTTPHEADER 至少包含 Accept: application/json 和 Content-Type: application/json，缺一不可
CURLOPT_RETURNTRANSFER 必须为 true，否则 curl_exec() 返回 bool(true) 而非响应体
POST 数据必须用 json_encode() 编码，不能用 http_build_query()（后者发的是 application/x-www-form-urlencoded，Zendesk 拒收）

示例片段（放在 application/libraries/Zendesk_api.php）：

CodeIgniter 4.7.0

CodeIgniter下载页提供 CodeIgniter 4.7.0 官方源码包，并整理框架安装、数据库配置与入门开发说明。

下载

public function create_ticket($data) {
    $url = $this->base_url . '/api/v2/tickets.json';
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(['ticket' => $data]));
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Authorization: Basic ' . base64_encode($this->email . '/token:' . $this->token),
        'Accept: application/json',
        'Content-Type: application/json'
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 生产请替换为 CA 路径
    $response = curl_exec($ch);
    $http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    curl_close($ch);
    return $http_code === 201 ? json_decode($response, true) : false;
}

配置项别写死在控制器里

把 Zendesk 的 subdomain、email、token、timeout 全部抽到 application/config/zendesk.php，避免硬编码污染业务逻辑：

defined('BASEPATH') OR exit('No direct script access allowed');
$config['zendesk_subdomain'] = 'yourcompany';
$config['zendesk_email']     = 'admin@yourcompany.com';
$config['zendesk_token']     = 'abc123xyz789';
$config['zendesk_timeout']   = 15;

然后在客户端类构造函数中加载：

$this->subdomain = $this->ci->config->item('zendesk_subdomain');
$this->base_url  = 'https://' . $this->subdomain . '.zendesk.com';
// ...

敏感字段（如 token）建议通过环境变量注入，例如用 getenv('ZENDESK_TOKEN') 替代配置文件直写
如果多个环境（dev/staging/prod）共用一套代码，配置文件中可加判断：if (ENVIRONMENT === 'production') { $config['zendesk_token'] = getenv('ZENDESK_TOKEN'); }

错误处理不能只靠 try-catch

Zendesk API 返回的不是标准 HTTP 状态码语义：比如工单字段校验失败返回 422，但响应体里有详细错误字段；网络超时或 DNS 失败则根本收不到 JSON。所以仅靠 try-catch 捕获 Exception 不够，必须检查 curl_error() 和 curl_getinfo($ch, CURLINFO_HTTP_CODE)：

curl_error() 非空 → 网络层失败（DNS、连接超时、SSL 握手失败），此时 $response 为 false，不要尝试 json_decode()
HTTP_CODE 为 401 → 认证失败，优先检查邮箱格式、Token 是否过期或权限不足
HTTP_CODE 为 422 → 查看响应体中的 details 字段，常见于 subject 为空、comment 缺 html_body 或 plain_body
所有错误都应记录到 log_message('error', ...)，含原始请求 URL、参数摘要、错误信息，方便排查