README

由于手持手机的普及，今天的短信被认为是最好的通信媒介。

人们大部分时间都在用手机，这在空闲时间或午餐休息时阅读短信是合适的。

安装

可以通过composer安装linlak/linsms-php-sdk，这是一个PHP依赖管理器。要在项目中安装，请在项目根目录中打开终端或命令提示符，并运行以下命令。

composer require linlak/linsms-php-sdk

这就是您需要在项目中安装linlak/linsms-php-sdk所需的所有内容

集成

如果您已经到达这一步，那么您可能已经在LinSMS上有一个账户，或者您需要一个API，可以帮助您轻松地将我们的短信网关集成到您的bulksms系统中，或者您计划将在线支付系统集成到您的App或网站上。

要集成到我们的系统中，您必须在LinSMS上有一个账户，并且必须创建一个App，其中包含初始化API所需的client_id和secret。

注意：永远不要在非安全环境中使用您的secret。如果您怀疑您的client_id或secret有任何泄露，您总是可以刷新它们，即请求您App的新client_id或secret，在开发者控制台中。

##初始化## 在您继续之前，我们假设您已通过composer安装了此SDK，并且您已在LinSMS的开发者控制台创建了App。如果您还没有，请阅读上面的集成部分。

要初始化API，创建一个名为bootstrap.php的文件

<?php
	require_once "{location to your vendor directory}/vendor/autoload.php";
	
	use LinSms\LinSMSClient;
	
	$client_id="";
	$secret="";
	
	$linsmsClient=LinSMSClient::init($client_id, $secret);

SMS API

SMS API默认启用，在开发者控制台创建App后，只需将您的client_id和secret复制到bootstrap.php中，您就可以开始了。但是，如果您不需要短信发送功能，您可以在开发者控制台中直接禁用它。

SMS API示例

1. 检查短信余额

创建一个名为sms_balance.php的文件

<?php
	require_once "./bootstrap.php";
	
	use LinSms\Util\HttpCodes;
	
	$response=$linsmsClient->balance();
	if($response->status_code===HttpCodes::HTTP_OK){
		echo $response->getBalance();
	}else{
		echo $response->status_phrase;
	}

2. 发送短信

在发送请求之前，将过滤掉重复的、无效的或不受支持的号码。

创建一个名为send_sms.php的文件

<?php
	
	require_once "./bootstrap.php";
	
	use LinSms\Util\HttpCodes;
	
	$sender_id="testing";
	$message="This is a test message";
	$recipients="{comma seperated ugandan phone numbers}";
	
	$response=$linsmsClient->sendSMS($sender_id, $message, $recipients);
	
	if($response->isSent())
	{
		echo "refrenceId ". $response->getReferenceId();
		echo"\r\n";
		echo "sender_id ". $response->getSenderId();
		echo"\r\n";
		echo "message ". $response->getMessage();
		echo"\r\n";
		echo "recipients ". $response->getRecipients();
	}

3. 检查短信状态

这检查短信是否已发送、失败或挂起。创建一个名为sms_status.php的文件

<?php
	
	require_once "./bootstrap.php";
	
	use LinSms\Util\HttpCodes;
	
	$refrenceId="testing";
	
	
	$response=$linsmsClient->smsStatus($refrenceId);
	
	if($response->isSent())
	{
		echo "refrenceId ". $response->getReferenceId();
		echo"\r\n";
		echo "sender_id ". $response->getSenderId();
		echo"\r\n";
		echo "message ". $response->getMessage();
		echo"\r\n";
		echo "recipients ". $response->getRecipients();
	}

支付API

即将推出

支付API

即将推出