Nexmo-PHP-lib 项目常见问题解决方案

Nexmo-PHP-lib 项目常见问题解决方案

项目基础介绍

Nexmo-PHP-lib 是一个用于与 Nexmo SMS 网关集成的 PHP 库。该项目允许开发者通过简单的 API 调用发送和接收 SMS 消息，以及处理消息回执。主要编程语言为 PHP。

新手使用注意事项及解决方案

1. 发送消息返回 false

问题描述: 在使用 Nexmo-PHP-lib 发送 SMS 消息时，返回值为 false，表示消息发送失败。

解决方案:

1. 检查 PHP 配置: 确保 PHP 安装中启用了 CURL 扩展，或者将 PHP 选项 allow_url_fopen 设置为 1（默认值）。

   • 在 php.ini 文件中，找到并确保以下配置项已启用：

     extension=curl
     allow_url_fopen=1
     

   • 保存并重启 Web 服务器。

2. 检查网络连接: 确保服务器能够访问 Nexmo 的 API 端点 rest.nexmo.com/sms/json，端口为 443。

   • 使用 telnet 或 curl 命令测试连接：

     telnet rest.nexmo.com 443
     

   • 如果连接失败，检查服务器防火墙设置，确保允许访问该端口。

2. 消息发送成功但未收到

问题描述: 消息发送成功，但接收方未收到 SMS 消息。

解决方案:

1. 检查 Nexmo 账户配置: 确保 Nexmo 账户配置正确，包括 API 密钥和密钥。

   • 登录 Nexmo 控制台，检查 API 密钥和密钥是否正确。
   • 确保账户余额充足，以支付 SMS 费用。

2. 运行示例代码: 运行项目中提供的示例 PHP 文件 example.php，查看是否有错误信息返回。

   • 在终端或命令行中运行：

     php example.php
     

   • 根据返回的错误信息进行排查。

3. 接收消息回执失败

问题描述: 无法正确接收 Nexmo 发送的消息回执。

解决方案:

1. 检查回执处理代码: 确保回执处理代码逻辑正确，能够正确解析 Nexmo 发送的回执数据。

   • 参考项目中的示例代码，确保回执处理逻辑与示例一致。
   • 例如：

     $receipt = new NexmoReceipt();
     if ($receipt->exists()) {
         switch ($receipt->status) {
             case $receipt::STATUS_DELIVERED:
                 // 消息已成功送达
                 break;
             case $receipt::STATUS_FAILED:
             case $receipt::STATUS_EXPIRED:
                 // 消息发送失败或过期
                 break;
         }
     }
     

2. 检查 Webhook 配置: 确保 Nexmo 控制台中配置的 Webhook URL 正确，并且服务器能够接收并处理 Nexmo 发送的回执请求。

   • 登录 Nexmo 控制台，检查 Webhook URL 配置。
   • 确保服务器能够接收并处理 POST 请求。

通过以上步骤，新手用户可以更好地理解和解决在使用 Nexmo-PHP-lib 项目时遇到的常见问题。