PHP发送短信怎么实现？代码示例和免费接口推荐？

PHP发送短信是现代Web开发中常见的功能需求,广泛应用于用户验证码、订单通知、营销推广等场景，实现这一功能通常需要借助第三方短信服务平台提供的API接口，通过HTTP请求或SDK包将短信内容发送至目标手机号码，以下将从技术原理、实现步骤、注意事项及代码示例等方面详细说明PHP发送短信的具体方法。

技术原理与准备工作

PHP发送短信的核心原理是通过HTTP协议向短信服务商的API接口发送POST或GET请求,请求中包含目标手机号、短信内容、签名模板等参数，服务商验证请求合法性后调用运营商网络完成短信下发，实现前需完成以下准备工作：

1. 选择短信服务商：国内主流服务商包括阿里云、腾讯云、七牛云等，需注册账号并获取API Key、Secret Key及签名模板。
2. 配置白名单IP：在服务商平台添加服务器IP地址至白名单，避免请求被拦截。
3. 了解接口文档：仔细阅读服务商提供的API文档，确认请求地址、参数格式、字符编码（通常为UTF8）及返回数据结构。

实现步骤详解

获取API凭证

登录短信服务商控制台,创建短信签名（如“【您的公司名称】”）和短信模板（需包含变量，如“您的验证码是${code}，5分钟内有效”），记录以下关键信息：

• AccessKey ID（或AppKey）
• AccessKey Secret（或AppSecret）
• 模板ID（TemplateId）
• 签名名称（SignName）

安装依赖包（可选）

若服务商提供PHP SDK包，可通过Composer安装，以阿里云短信SDK为例：

composer require alibabacloud/dysmsapi20170525

编写发送代码

基础实现（使用cURL直接调用API）

以下以模拟调用阿里云短信API为例，展示原生PHP实现方式：

<?php // 1. 初始化cURL $ch = curl_init(); $url = 'https://dysmsapi.aliyuncs.com/'; $params = [ 'PhoneNumbers' => '13800138000', // 目标手机号 'SignName' => '【您的公司名称】', // 签名 'TemplateCode' => 'SMS_123456789', // 模板ID 'TemplateParam' => json_encode(['code' => '123456']), // 模板变量 'AccessKeyId' => 'LTAI4G*****', // AccessKey ID 'Signature' => '', // 签名（需后续计算） 'Timestamp' => date('YmdTH:i:sZ'), // 当前UTC时间 'Format' => 'JSON', 'Version' => '20170525', 'Action' => 'SendSms' ]; // 2. 计算签名（按服务商规范拼接字符串并加密） $sortedParams = http_build_query($params); $stringToSign = 'GET&' . urlencode('/') . '&' . urlencode($sortedParams); $signature = base64_encode(hash_hmac('sha1', $stringToSign, 'AccessKey Secret', true)); $params['Signature'] = $signature; // 3. 发送请求 curl_setopt($ch, CURLOPT_URL, $url . '?' . http_build_query($params)); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); $response = curl_exec($ch); curl_close($ch); // 4. 处理响应 $result = json_decode($response, true); if ($result['Code'] === 'OK') { echo '短信发送成功'; } else { echo '发送失败：' . $result['Message']; } ?>

使用SDK简化开发

通过SDK可大幅简化代码量，以阿里云SDK为例：

<?php require_once 'vendor/autoload.php'; use AlibabaCloudClientAlibabaCloud; use AlibabaCloudClientExceptionClientException; use AlibabaCloudClientExceptionServerException; AlibabaCloud::accessKeyClient('AccessKey ID', 'AccessKey Secret') >regionId('cnhangzhou') >asDefaultClient(); try { $result = AlibabaCloud::dysmsapi20170525() >v20170525SendSms() >withPhoneNumbers('13800138000') >withSignName('【您的公司名称】') >withTemplateCode('SMS_123456789') >withTemplateParam(json_encode(['code' => '123456'])) >request(); print_r($result>toArray()); } catch (ClientException | ServerException $e) { echo $e>getErrorMessage() . PHP_EOL; } ?>

常见参数说明

注意事项

1. 频率限制：服务商通常对单个手机号和总发送量有限制，需合理控制发送频率，避免触发风控，合规**：禁止发送营销、涉政等违规内容，否则可能导致账号被封禁。
2. 错误处理：需捕获网络异常、API返回错误（如签名错误、余额不足等）并记录日志。
3. 成本控制：测试环境使用测试模板，避免产生实际费用；生产环境做好发送量统计。

进阶优化

• 异步发送：通过队列（如RabbitMQ、Redis）将发送任务异步化，避免阻塞用户请求。
• 状态回执：配置短信状态接收地址，服务商会通过回调接口告知发送结果（成功/失败/送达）。
• 模板变量校验：发送前检查TemplateParam是否符合模板定义的变量类型和数量。

相关问答FAQs

Q1：为什么短信发送失败，提示“签名未审核通过”？

A：首先检查控制台中签名状态是否为“审核通过”，确保签名内容与发送时填写的SignName完全一致（包括标点符号），若已通过但仍报错，可能是缓存延迟，建议等待10分钟后重试。

Q2：如何实现验证码短信的有效期控制？

A：在发送验证码时，需同时将验证码及过期时间存储至缓存（如Redis），并设置自动过期时间，用户提交验证时，先从缓存获取对应验证码并比对，同时检查当前时间是否在有效期内。

// 发送时存储验证码 $redis = new Redis(); $redis>connect('127.0.0.1', 6379); $redis>setex('verify_code:13800138000', 300, '123456'); // 5分钟有效期 // 验证时校验 $code = $redis>get('verify_code:13800138000'); if ($code === $_POST['code']) { echo '验证成功'; } else { echo '验证码错误或已过期'; }