php对接短信发送接口通常通过http客户端(如guzzle或curl)向服务商api发起post请求,并携带签名、模板id及参数。以阿里云为例,需使用accesskey id和secret进行hmac-sha1签名,将结果放入header中调用sendsms接口。若签名错误或参数缺失,接口会返回错误码而非成功状态。

SmsClient如何构建请求头与签名?
SmsClient在构建请求时,必须按特定顺序拼接待签名字符串,并使用HmacSHA1算法结合AccessKeySecret生成签名值。该签名值需置于Authorization头部,格式为acs {AccessKeyId}:{Signature}。如果未正确编码参数或排序错误,服务端将拒绝请求。

require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
class SmsClient {
private $accessKeyId;
private $accessKeySecret;
private $endpoint;
public function __construct($id, $secret, $endpoint) {
$this->accessKeyId = $id;
$this->accessKeySecret = $secret;
$this->endpoint = $endpoint;
}
public function send($phone, $templateParam) {
$params = [
'PhoneNumbers' => $phone,
'SignName' => 'MySign',
'TemplateCode' => 'SMS_123456',
'TemplateParam' => json_encode($templateParam),
'RegionId' => 'cn-hangzhou'
];
$headers = $this->signHeaders($params);
try {
$client = new Client();
$response = $client->post($this->endpoint, [
'headers' => $headers,
'form_params' => $params
]);
return json_decode($response->getBody(), true);
} catch (RequestException $e) {
return ['error' => $e->getMessage()];
}
}
private function signHeaders($params) {
ksort($params);
$stringToSign = 'POST&%2F&' . urlencode(http_build_query($params));
$signature = base64_encode(hash_hmac('sha1', $stringToSign, $this->accessKeySecret . '&', true));
return [
'Authorization' => 'acs ' . $this->accessKeyId . ':' . $signature,
'Content-Type' => 'application/x-www-form-urlencoded'
];
}
}
$client = new SmsClient('YOUR_ID', 'YOUR_SECRET', 'https://dysmsapi.aliyuncs.com/');
$result = $client->send('13800138000', ['code' => '1234']);
print_r($result);如何处理接口返回的成功与失败状态?
接口调用成功后,返回JSON中包含Code字段为OK表示发送成功,否则为错误码。开发者需检查Message字段获取具体错误原因,如isv.BUSINESS_LIMIT_CONTROL表示触发频率限制。对于网络异常或超时,应捕获GuzzleHttp\Exception\RequestException并进行重试或记录日志。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
立即学习“PHP免费学习笔记(深入)”;

// 接上节代码
if (isset($result['Code']) && $result['Code'] === 'OK') {
echo "Success: " . $result['Message'];
} else {
echo "Failed: " . ($result['Message'] ?? 'Unknown error');
}当TemplateParam为空时会发生什么?
当TemplateParam为空数组或null时,json_encode会将其转换为{}字符串发送给服务端。如果短信模板中定义了变量(如${code}),服务端可能因缺少对应值而返回isv.TEMPLATE_MISSING_PARAMETERS错误。因此,必须确保模板参数与模板内容严格匹配,即使某些参数可选,也建议显式传递空字符串或默认值以避免歧义。


















