非洲通话PHP SDK使用教程

非洲通话PHP SDK使用教程

africastalking-phpOfficial PHP SDK项目地址:https://gitcode.com/gh_mirrors/af/africastalking-php

1. 项目的目录结构及介绍

africastalking-php/
├── src/
│   ├── AfricasTalkingGateway.php
│   ├── AfricasTalkingGatewayException.php
│   └── ...
├── examples/
│   ├── airtime.php
│   ├── sms.php
│   └── ...
├── README.md
├── composer.json
└── ...

• src/：包含SDK的核心文件，如AfricasTalkingGateway.php和AfricasTalkingGatewayException.php。
• examples/：包含使用SDK的示例代码，如发送短信的sms.php和发送 airtime 的airtime.php。
• README.md：项目说明文档。
• composer.json：Composer 配置文件，用于管理依赖。

2. 项目的启动文件介绍

项目的启动文件通常是examples/目录下的示例文件，例如sms.php。以下是一个简单的启动文件示例：

<?php
require_once __DIR__ . '/../src/AfricasTalkingGateway.php';

$username = 'your_username';
$apiKey   = 'your_api_key';
$gateway  = new AfricasTalkingGateway($username, $apiKey);

try {
    $results = $gateway->sendMessage('+254711XXXYYY', 'Hello World!');
    foreach ($results as $result) {
        echo "Number: " . $result->number;
        echo "Status: " . $result->status;
        echo "MessageId: " . $result->messageId;
        echo "Cost: " . $result->cost . "\n";
    }
} catch (AfricasTalkingGatewayException $e) {
    echo "Encountered an error while sending: " . $e->getMessage();
}
?>

3. 项目的配置文件介绍

项目的配置文件主要是composer.json，用于管理依赖和项目元数据。以下是一个简单的composer.json示例：

{
    "name": "africastalking/africastalking-php",
    "description": "Official PHP SDK for Africa's Talking API",
    "type": "library",
    "require": {
        "php": ">=5.6"
    },
    "autoload": {
        "psr-4": {
            "AfricasTalking\\": "src/"
        }
    }
}

• name：项目名称。
• description：项目描述。
• type：项目类型。
• require：项目依赖。
• autoload：自动加载配置。

通过以上配置，可以使用Composer来管理项目的依赖和自动加载。

africastalking-phpOfficial PHP SDK项目地址:https://gitcode.com/gh_mirrors/af/africastalking-php