camoo / sms
CAMOO API 包
4.1.0
2023-11-01 17:06 UTC
Requires
- php: >=8.1
- ext-curl: *
- ext-json: *
- ext-mbstring: *
- ext-mysqli: *
- ext-simplexml: *
- camoo/curl-http-client: ^1.0.3
- camoo/inflector: ^1.0
- giggsey/libphonenumber-for-php: ^8.10
- nicoswd/php-gpg: ^1.7
- vlucas/valitron: ^1.4
Requires (Dev)
- phpunit/phpunit: ^9.6.1
Suggests
- phpunit/phpunit: Allows automated tests to be run without system-wide install.
This package is auto-updated.
Last update: 2024-09-30 01:24:38 UTC
README
PHP SMS API 通过 CAMOO SMS 网关发送短信
需求
此库运行良好的最低要求。
- 免费注册 CAMOO SMS 账户
- 向 CAMOO 团队申请开发者的新 access_key
- CAMOO SMS API PHP 客户端需要版本 8.1.x 及以上
通过 Composer 安装
该包可在 Packagist 上找到,您可以使用 Composer 安装它。
composer require camoo/sms
或者前往
下载完整版本
如果您想安装与 PHP7.4
兼容的旧版本,请使用以下命令运行 composer
composer require camoo/sms "3.2.*"
或者从 Camoo-SMS-API 旧版本 下载
快速示例
发送短信
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='YourCompany'; $oMessage->to = '+237612345678'; $oMessage->message ='Hello Kmer World! Déjà vu!'; var_dump($oMessage->send());
向多个收件人发送相同的短信
- Per request, a max of 50 recipients can be entered.
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='YourCompany'; $oMessage->to =['+237612345678', '+237612345679', '+237612345610', '+33689764530']; //OR from version 3.3.0 $collection = new RecipientCollection(); $collection->add('237612345678'); $collection->add('237612345679'); $collection->add('237612345610'); $collection->add('33689764530'); $oMessage->to = $collection; $oMessage->message ='Hello Kmer World! Déjà vu!'; var_dump($oMessage->send());
发送非定制的发送者短信。
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='WhatEver'; // will be overridden $oMessage->to = '+237612345678'; // This parameter tells our system to use the classic route to send your message. $oMessage->route ='classic'; $oMessage->message ='Hello Kmer World! Déjà vu!'; var_dump($oMessage->send());
发送加密短信
Encrypt message using GPG before sending, ensure an end to end ecryption between your server and ours
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='YourCompany'; $oMessage->to = '+237612345678'; $oMessage->message ='Hello Kmer World! Déjà vu!'; $oMessage->encrypt = true; var_dump($oMessage->send());
发送批量短信
在后台发送批量短信。此调用需要启用 shell_exec
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='YourCompany'; $oMessage->to = ['+237612345678', '+237612345679', '+237612345610', '+33689764530', '+4917612345671']; $oMessage->message ='Hello Kmer World! Déjà vu!'; var_dump($oMessage->sendBulk());
发送个性化批量短信
在后台发送批量短信。此调用需要启用 shell_exec
。您应在消息中使用占位符 %NAME%
,并且 to
属性应包含每个元素的 name
和 mobile
的关联数组。请参阅以下示例
$oMessage = \Camoo\Sms\Message::create('YOUR_API_KEY', 'YOUR_API_SECRET'); $oMessage->from ='YourCompany'; $oMessage->to = [['name' => 'John Doe', 'mobile' => '+237612345678'], ['name' => 'Jeanne Doe', 'mobile' => '+237612345679'], ['...']]; $oMessage->message ='Hello %NAME% Kmer World! Déjà vu!'; var_dump($oMessage->sendBulk());
通过 API 充值短信账户
自版本 >=3.3.3 起可用。
您可以直接从自己的应用程序中使用 MTN 或 Orange Mobile Money Cameroon 通过 API 充值您的 Camoo SMS
账户,无需额外费用。
// Step 1: create Top up instance /** @var TopUp&\Camoo\Sms\Objects\TopUp $topup */ $topup = TopUp::create('YOUR_API_KEY', 'YOUR_API_SECRET'); // Step 2 Assign phone number and amount $topup->amount = 3000; $topup->phonenumber = '612345678'; // Step 3 Call add to top up your account. You will then receive a notification to complete the process. $response = $topup->add(); var_dump($response);
从脚本发送批量短信
向任何系统发送大量数据显然是一个问题!因此,您应该查看我们的最佳实践建议
- (查看批量短信示例)
WordPress 插件
如果您正在寻找一个强大的 WordPress 插件来发送短信,请下载我们的 wp-camoo-sms