上一篇
php发送短信教程怎么实现？新手必看步骤详解
PHP发送短信是许多Web应用中常见的功能需求,比如用户注册验证码、订单通知、营销推广等场景，本文将详细介绍如何使用PHP实现短信发送功能，包括准备工作、选择短信服务商、代码实现及注意事项等内容。
准备工作
在开始编写PHP代码之前,需要完成以下准备工作：
-
选择短信服务商：目前国内主流的短信服务商包括阿里云短信、腾讯云短信、 Twilio（国际）、容联云通讯等，选择服务商时需考虑价格、到达率、接口稳定性、是否支持测试号码等因素，以阿里云短信为例，新用户通常会有免费试用额度。
-
获取API密钥：注册并登录所选短信服务商的控制台，创建应用后获取AccessKey ID和AccessKey Secret，这两个密钥用于API接口的身份认证。
-
申请签名模板需要提前申请签名（如“【您的公司名称】”）和模板（如“您的验证码是{code}，5分钟内有效”），审核通过后才能使用。
-
安装依赖库：部分服务商提供SDK（软件开发工具包），可以通过Composer安装，例如阿里云短信的PHP SDK安装命令为：composer require alibabacloud/dysmsapi20170525。
- 频率限制：短信服务商通常对同一手机号的发送频率有限制（如1分钟内不超过1条，1小时内不超过5条），需在业务逻辑中做控制，避免触发限流，合规**：禁止发送营销类、违法内容短信，否则可能导致账号被封禁。
- 错误处理：建议对API返回的错误码进行分类处理，例如签名错误时提示管理员，手机号错误时提示用户重新输入。
- 测试环境：部分服务商提供测试模板（如“【测试签名】您的验证码是{code}”），可在开发阶段使用，避免浪费免费额度。
代码实现
以下以阿里云短信为例,展示PHP发送短信的具体步骤：
初始化SDK
在项目目录下通过Composer安装阿里云短信SDK,然后在PHP文件中引入自动加载文件并初始化客户端：
require 'vendor/autoload.php'; use AlibabaCloudClientAlibabaCloud; use AlibabaCloudClientExceptionClientException; use AlibabaCloudClientExceptionServerException; AlibabaCloud::accessKeyClient('youraccesskeyid', 'youraccesskeysecret') >regionId('cnhangzhou') // 替换为你的区域ID >asDefaultClient();
调用发送接口
使用SDK提供的单发短信接口,填写手机号、签名、模板及模板参数：
try { $result = AlibabaCloud::dysmsapi20170525() >v20170525SendSms() >phoneNumbers('13800138000') // 目标手机号 >signName('您的签名') // 已审核的签名 >templateCode('SMS_123456789') // 已审核的模板CODE >templateParam(json_encode(['code' => '123456'])) // 模板参数，如验证码 >request(); print_r($result>toArray()); } catch (ClientException $e) { echo $e>getErrorMessage() . PHP_EOL; } catch (ServerException $e) { echo $e>getErrorMessage() . PHP_EOL; }
返回结果处理
接口返回结果为JSON格式,包含Code（状态码）、Message（提示信息）、RequestId（请求ID）等字段，常见的状态码及含义如下表所示：
| 状态码 | 含义 | 处理建议 |
|---|---|---|
| OK | 请求成功 | 记录发送日志，等待用户反馈 |
| isv.INVALID_SIGNATURE | 签名错误 | 检查AccessKey是否正确 |
| isv.TEMPLATE_ILLEGAL | 模板未审核 | 确认模板状态并通过控制台重新提交审核 |
| isv.MOBILE_NUMBER_ILLEGAL | 手机号格式错误 | 验证手机号是否符合11位国内号码规则 |
完整示例代码
以下是一个完整的PHP发送短信示例,包含参数校验和日志记录：
<?php require 'vendor/autoload.php'; use AlibabaCloudClientAlibabaCloud; use AlibabaCloudClientExceptionClientException; use AlibabaCloudClientExceptionServerException; // 初始化SDK AlibabaCloud::accessKeyClient('LTAI4Gexample', 'yoursecretkey') >regionId('cnhangzhou') >asDefaultClient(); function sendSms($phone, $code) { if (!preg_match('/^1[39]d{9}$/', $phone)) { throw new Exception('手机号格式错误'); } try { $result = AlibabaCloud::dysmsapi20170525() >v20170525SendSms() >phoneNumbers($phone) >signName('您的签名') >templateCode('SMS_123456789') >templateParam(json_encode(['code' => $code])) >request(); // 记录日志 file_put_contents('sms.log', date('Ymd H:i:s') . " 发送结果: " . $result>toString() . PHP_EOL, FILE_APPEND); return $result>toArray()['Code'] === 'OK'; } catch (Exception $e) { file_put_contents('sms_log', date('Ymd H:i:s') . " 错误: " . $e>getMessage() . PHP_EOL, FILE_APPEND); return false; } } // 调用示例 $phone = '13800138000'; $code = rand(100000, 999999); if (sendSms($phone, $code)) { echo '短信发送成功'; } else { echo '短信发送失败'; } ?>
注意事项
相关问答FAQs
Q1：如何解决短信发送失败的问题？
A：首先检查API密钥是否正确，签名和模板是否已审核通过，若返回isp.RAM_PERMISSION_DENIED错误，说明AccessKey权限不足，需在RAM控制台为密钥添加dysmsapi:SendSms权限，若手机号频繁发送失败，可能是被运营商拦截，建议更换测试号码或降低发送频率。
Q2：如何实现发送验证码后的倒计时功能？
A：在前端使用JavaScript实现倒计时，
let countdown = 60; document.getElementById('sendBtn').disabled = true; const timer = setInterval(() => { countdown; document.getElementById('sendBtn').value = `${countdown}秒后重试`; if (countdown <= 0) { clearInterval(timer); document.getElementById('sendBtn').disabled = false; document.getElementById('sendBtn').value = '发送验证码'; } }, 1000);
后端需记录发送时间和验证码,并在用户提交时验证是否过期（如5分钟内有效），可通过Redis存储验证码及过期时间，
$redis = new Redis(); $redis>connect('127.0.0.1', 6379); $redis>setex("sms_code:{$phone}", 300, $code); // 设置5分钟过期
