evp/gsms-php-client

此软件包最新版本(0.2)没有提供许可证信息。

gsms.lt API PHP 客户端

0.2 2015-10-23 09:13 UTC

This package is not auto-updated.

Last update: 2024-09-13 06:31:04 UTC


README

#GsmsPhpClient

##什么是 GsmsPhpClient? GsmsPhpClient 是一个辅助库,可以帮助您轻松地将发送短信功能集成到您的网站中,如果您拥有一个具有正余额的活跃 Gsms.lt 账户。

简而言之:这是一个现有的 Gsms.lt API 包装器 - 下载 DOC 格式规范

##章节

##要求

  • 活跃的 gsms.lt 账户
  • PHP 5.1.2+

##安装

  • 使用 git clone https://github.com/evp/GsmsPHPClient.git 将 GsmsPHPClient 目录复制到您的项目目录。
  • 将以下代码添加到您打算使用 SMS 发送功能的 PHP 文件中
   require_once '/path/to/GsmsPHPClient/src/Evp/Gsms/Autoloader.php';
   Evp_Gsms_Autoloader::register();

这将确保所有库类的正确加载。请确保将 'path/to' 更改为 GsmsPHPClient 的实际路径。

恭喜,您已成功安装 GsmsPHPClient!

##代码示例 安装库后,您现在可以创建一个 Gsms_Client

  $client = Evp_Gsms_Client::newInstance('username', 'password')

其中 "username" 和 "password" 分别是您的 gsms.lt 账户登录名和密码。

现在使用客户端发送您的第一条短信

$response = $client->send('Your telephone number', 'Receiver telephone number', 'message');

您只能从通过 gsms.lt 网络界面添加到您的账户中的号码发送短信,这意味着您不要指定随机电话号码作为发送方法的第一个参数。

现在检查您发送的短信是否顺利完成,请使用 Gsms_Client::send 方法返回的 $response 对象。

    if ($response->isSuccessful()) {
           // Do something when the sms has been sent
       } else {
           // Do something when the sms has not been sent
           $lastResponse = $client->getLastResponse();
       }

$lastResponse 字符串将提供来自 API 的反馈,并帮助您调试可能遇到的问题。

##附加说明 Gsms_Client::send 方法如果 API 的响应无效,则会抛出异常。始终在您的代码中围绕 try-catch 子句以预见此类行为是个好主意

  try {
    # This is where you send your message
  } catch (Evp_Gsms_Exception $e) {
      $e->getMessage();
      $client->getLastResponse();
  }

##联系方式 如果您有任何其他问题,请随时联系我们

"EVP International", UAB
Mėnulio g. 7
LT-04326 Vilnius
Email: pagalba@gsms.lt
电话 +370 (5) 2 03 27 19
传真 +370 (5) 2 63 91 79