在CodeIgniter中集成第三方API需配置分离、封装请求类并处理错误。首先将API地址、密钥等信息写入application/config/api.php，通过$this->config->item()调用；接着在application/libraries下创建Api_client类，使用cURL封装GET、POST、PUT等请求方法，并加载配置项；控制器中通过$this->load->library('api_client')实例化后调用request()方法发送请求，根据返回的success状态判断结果，结合log_message()记录错误日志，确保安全性与可维护性。
要在CodeIgniter中集成第三方API，关键在于合理组织请求逻辑、管理配置信息并确保数据安全。CodeIgniter作为轻量但结构清晰的PHP框架，非常适合快速对接外部服务，比如支付网关、短信平台或社交媒体接口。
配置API基本信息
把第三方API的访问地址、密钥、认证方式等信息集中管理，避免硬编码在业务逻辑中。
可以在 application/config/config.php 或创建自定义配置文件如 application/config/api.php 中定义：
// application/config/api.php
defined('BASEPATH') OR exit('No direct script access allowed');
$config['api_url'] = 'https://www.php.cn/link/0f7348316d529b628dabb2d25376a142';
$config['api_key'] = 'your_api_key_here';
$config['secret_token'] = 'your_secret_token';
$config['timeout'] = 30;
之后通过 $this->config->item('api_key') 调用这些值，提升可维护性。
立即学习“PHP免费学习笔记（深入）”；
封装API请求服务类
建议在 application/libraries 目录下创建一个专用类来处理所有与API通信的逻辑。
例如创建 Api_client.php：
class Api_client {
protected $CI;
protected $api_url;
protected $api_key;
public function __construct() {
$this->CI =& get_instance();
$this->CI->config->load('api');
$this->api_url = $this->CI->config->item('api_url');
$this->api_key = $this->CI->config->item('api_key');
}
public function request($method, $endpoint, $data = []) {
$url = $this->api_url . '/' . ltrim($endpoint, '/');
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, TRUE);
curl_setopt($ch, CURLOPT_TIMEOUT, $this->CI->config->item('timeout'));
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Authorization: Bearer ' . $this->api_key,
'Content-Type: application/json'
]);
if ($method === 'POST') {
curl_setopt($ch, CURLOPT_POST, TRUE);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
} elseif ($method === 'PUT') {
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
}
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
return [
'success' => $http_code >= 200 && $http_code < 300,
'data' => json_decode($response, TRUE),
'status' => $http_code
];
}}
将这个类加载到控制器中使用：$this->load->library('api_client');
在控制器中调用API
实际业务中通常在控制器里触发API请求。比如从外部获取用户数据：
class User extends CI_Controller {
public function index() {
$this->load->library('api_client');
$result = $this->api_client->request('GET', 'users/123');
if ($result['success']) {
$data['user'] = $result['data'];
$this->load->view('user_profile', $data);
} else {
show_error('无法获取用户信息：' . $result['status']);
}
}}
对于POST请求发送数据，只需传入数组即可：
$data = ['name' => '张三', 'email' => 'zhang@example.com'];
$result = $this->api_client->request('POST', 'users', $data);
错误处理与日志记录
真实环境中必须处理网络异常、超时、认证失败等情况。
可以结合CodeIgniter的日志功能记录请求细节：
if (!$result['success']) {
log_message('error', 'API请求失败：' . $result['status'] . ' - ' . json_encode($result['data']));
}
也可以在封装类中加入重试机制或状态码映射提示信息，提升系统稳定性。
基本上就这些。只要把配置分离、请求封装、错误捕获做好，CodeIgniter对接第三方API就很清晰高效。不复杂但容易忽略细节。
