README

大家好，这是一个PHP包，用于短信短码应用程序，例如将入学编号发送到短码25551。然后通过https://www.africastalking.com/contact上的Africa's Talking API将短信发送到用户手机。这是在沙箱（测试）模式下开发的。要上线，请联系Africa's Talking Ltd。

先决条件

为了测试，请从Google Playstore下载https://simulator.africastalking.com:1517/.It上的Africa's Talking安卓应用或使用https://simulator.africastalking.com:1517/上的Web界面。建议使用安卓应用以获得更好的体验。

安装

此项目支持Composer依赖管理工具，也可以不使用Composer使用

使用Composer

运行以下命令

composer require bascil/sms_shortcode_application

不使用Composer

下载源代码的压缩文件

配置

1. 将message_table.sql文件导入MySQL数据库。

2. 使用dbConnector.php文件配置数据库连接

<?php
     /* Configure Database */

     $conn = 'mysql:dbname=ussd_sample;host=127.0.0.1;'; //database name
     $user = 'root'; // your mysql user
     $password = ''; // your mysql password

     //  Create a PDO instance that will allow you to access your database
     try {
        $db = new PDO($conn, $user, $password);
     }

    catch(PDOException $e) {
     //var_dump($e);
        echo("PDO error occurred");
    }

    catch(Exception $e) {
    //var_dump($e);
    echo("Error occurred");
    }

?>

1. 在message_table.sql文件中修改电话号码为您在应用程序中配置的电话号码。您可以保留入学编号不变，或者根据需要更改它。

    CREATE TABLE `message_table` (
      `id` int(11) NOT NULL,
      `student_name` varchar(50) NOT NULL,
      `adm` varchar(5) NOT NULL,
      `fee_balance` varchar(6) NOT NULL,
      `phone_number` varchar(15) NOT NULL,
      `date_posted` datetime NOT NULL
    ) ENGINE=MyISAM DEFAULT CHARSET=latin1;


    INSERT INTO `message_table` (`id`, `student_name`, `adm`, `fee_balance`, `phone_number`, `date_posted`) VALUES
    (1, 'Basil Ndonga', '4567', '13000', '+254728986084', '2018-06-20 11:14:00');


    ALTER TABLE `message_table`
      ADD PRIMARY KEY (`id`);


    ALTER TABLE `message_table`
      MODIFY `id` int(11) NOT NULL AUTO_INCREMENT, AUTO_INCREMENT=2;

1. 转到https://account.africastalking.com/。创建一个账户，然后点击“转到沙箱应用”按钮

2. 配置接收短信的回调URL（SMS Callback URLs > Incoming Messages）例如 http://www.example.com/folder_name/sms.php，然后点击提交。这假设您正在使用example.com域名的实时服务器。将域名替换为您自己的。

3. 如果您在本地主机上工作，可以设置一个Ngrok服务器或Localtunnel来将本地主机暴露给互联网。使用提供的临时URL作为您的回调，例如 http://6a71f5ec.ngrok.io/folder_name/ussd.php。这仅在计算机开启并连接到互联网时才有效。如果您使用的是Ngrok免费套餐，此地址可能每8小时更改一次。您可以选择每月5美元的付费版本。

4. 转到设置 > API密钥并输入密码以生成API密钥。查找名为config.php的文件，将用户名设置为sandbox并将API密钥设置为生成的密钥。

5. 配置一个测试短信短码（我的短码是25551）。这将用于短信消息，让您能够与Africa's Talking短信API交互。转到短码 > 创建短码以创建用于测试的短信短码。

用法

     try{
        $recipients = $from;
        $gateway= new AfricasTalkingGateway($username, $apikey,"sandbox");
        $gateway->sendMessage($recipients,$message,"25551");


    }
    catch(AfricasTalkingGatewayException $e){

        echo $e->getMessage();
      }

1. 现在使用从Google Playstore下载的Africa's Talking安卓应用或使用https://simulator.africastalking.com:1517/上的Web界面测试您配置的短码，即25551。请确保您配置的电话号码与步骤2中创建的电话号码相似。

Linux托管

如果您需要VPS或专用托管，请访问此链接Server Host

支持

需要使用此包的支持：-

邮箱basilndonga@gmail.com或通过skype联系我basilndonga。

如果您希望成为本项目的贡献者，请告知我。如果您想请我喝咖啡，可以通过这个链接支持我。

如果您受到了这个项目的启发，别忘了在github和twitter @basilndonga上关注我。

如果您希望聘请我作为您项目的开发者，请随时联系我。

许可证

本软件包是开源软件，根据MIT许可证授权。

快乐编码!!!!!!!