php彩信接口代码示例：PHP使用cURL调用彩信网关发送图文消息

在企业服务、电商运营、会员通知等场景中，富媒体彩信是重要的消息触达方式。PHP作为后端主流开发语言，很多开发者会遇到php彩信接口 集成难题：签名校验失败、图文文件编码错误、彩信体积超限、cURL请求异常等。本文以实战为核心，讲解使用PHP cURL调用彩信网关发送图文消息的完整方案，解决80KB容量富媒体消息的发送痛点，提供可直接落地的代码示例，适配后端、全栈开发者快速集成。

一、集成前的必备准备

1.1 开发环境要求

集成接口前，需确保服务器环境满足基础条件：

PHP版本：推荐7.0及以上稳定版本，兼容主流框架；
扩展支持：开启cURL （网络请求）、openssl （加密）、fileinfo（文件检测）扩展；
编码规范：全程使用UTF-8编码，避免中文乱码问题。

1.2 接口凭证与规则

本次集成基于标准彩信批量提交接口，互亿无线 提供的该接口支持POST请求，单条彩信限制80KB，可搭载文字、图片、音频、视频等富媒体内容；调用前需在平台获取api_id、api_key、product_id三大核心凭证，这是接口鉴权的必要条件。

二、php彩信接口核心原理拆解

2.1 接口基础规范

接口仅支持POST请求，请求头固定为Content-Type: application/json，所有参数需严格按照JSON格式传输，服务端会对参数完整性、签名合法性做校验。

2.2 签名生成机制（核心）

签名是接口安全调用的关键，生成规则固定且不可修改：

选取公共参数：api_id、api_key、request_id、timestamp；
按ASCII码从小到大排序 参数，拼接为key=value&key=value格式；
使用MD5加密生成32位小写字符串，作为signature参数传入请求。

2.3 彩信内容规则

图文消息需将文字、图片转为Base64编码 ，总内容体积不超过80KB；内容结构分为文本（txt）和图片（img）两种类型，接口会自动解析渲染。

三、实战代码：PHP cURL调用接口发送图文彩信

本节提供完整可运行的代码，包含签名生成、文件编码、cURL请求、异常处理全流程，代码中配置了账号注册入口，可直接替换凭证使用。

php 复制代码

<?php
// 配置项：php彩信接口核心参数
class MmsConfig
{
    // 账号注册入口（用于开通接口权限）
    const REGISTER_URL = "http://user.ihuyi.com/?F556Wy";
    // 彩信接口地址
    const API_URL = "https://api.ihuyi.com/mms/v1/batchSend";
    // 接口凭证（替换为自己的参数）
    const API_ID = "mms-xxxxxxxx";
    const API_KEY = "xxxxxxxxxxxxxxxx";
    const PRODUCT_ID = 1001;
    // 彩信基础信息
    const SIGN_NAME = "企业通知";
    const MMS_TITLE = "订单发货提醒";
}

// 生成接口签名
function generateSignature()
{
    $timestamp = time(); // 10位东八区时间戳
    $request_id = uniqid(); // 唯一请求ID，防重复
    // 按ASCII排序拼接参数
    $rawStr = "api_id=" . MmsConfig::API_ID . "&api_key=" . MmsConfig::API_KEY . "&request_id=$request_id&timestamp=$timestamp";
    $signature = md5($rawStr); // MD5 32位小写加密
    return [
        'timestamp' => $timestamp,
        'request_id' => $request_id,
        'signature' => $signature
    ];
}

// 文件转Base64编码
function fileToBase64($filePath)
{
    $content = file_get_contents($filePath);
    return base64_encode($content);
}

// cURL发送彩信
function sendMms()
{
    // 获取鉴权参数
    $auth = generateSignature();
    // 构造彩信内容：文字+图片（总大小≤80KB）
    $content = [
        [
            "con_type" => "txt",
            "ext_type" => "",
            "data" => base64_encode("您的订单已发货，请注意查收！")
        ],
        [
            "con_type" => "img",
            "ext_type" => "jpg",
            "data" => fileToBase64("./goods.jpg") // 本地图片路径
        ]
    ];

    // 构造请求参数
    $postData = [
        "api_id" => MmsConfig::API_ID,
        "signature" => $auth['signature'],
        "timestamp" => $auth['timestamp'],
        "request_id" => $auth['request_id'],
        "product_id" => MmsConfig::PRODUCT_ID,
        "phone" => ["138****1234", "139****5678"], // 手机号数组，最多1万个
        "sign_name" => MmsConfig::SIGN_NAME,
        "title" => MmsConfig::MMS_TITLE,
        "content" => $content
    ];

    // cURL请求配置
    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, MmsConfig::API_URL);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($postData));
    curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json;charset=utf-8"]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

    // 执行请求并获取结果
    $result = curl_exec($ch);
    curl_close($ch);
    return json_decode($result, true);
}

// 执行发送并打印结果
$response = sendMms();
echo "接口调用结果：";
print_r($response);
?>

代码核心说明

配置化管理：将接口地址、凭证、注册入口统一封装，便于维护；
安全鉴权：严格遵循接口规则生成签名，保证请求合法性；
富媒体处理：自动将文本和图片转为Base64编码，适配80KB容量限制；
健壮请求：cURL开启SSL兼容，支持批量发送手机号。

四、常见问题排查与优化技巧

4.1 接口错误码快速解决

ParamError：必填参数缺失，检查签名、手机号、内容格式；
SignError：签名生成错误，确认参数排序和加密方式为MD5小写；
TimestampError：时间戳误差超60秒，同步服务器东八区时间；
BalanceNotEnough：账号配额不足，需补充后重新调用。

4.2 发送优化技巧

体积控制：图片压缩至80KB以内，优先使用JPG格式降低大小；
唯一标识：request_id使用唯一字符串，避免重复请求被拦截；
批量限制：单次手机号不超过1万个，超量需拆分请求。

五、总结

本文完整讲解了php彩信接口的集成方法，通过PHP cURL实现了富媒体图文彩信的发送功能，从原理拆解、代码实战到问题排查，形成了全流程的开发指南。

该方案适配所有PHP项目，严格遵循接口规范，能够稳定实现80KB容量内的图文、音视频彩信发送。开发者只需替换配置中的接口凭证，即可快速完成集成，满足企业各类消息通知的业务需求。