seven-io / php-client

PHP API Client for seven.io

Official PHP API Client

Installation

Via Composer:

composer require seven.io/api

Alternatively you can download as *.ZIP if you don't use Composer.

Usage

use Seven\Api\Client;
use Seven\Api\Params\SmsParams;
$client = new Client('MY_VERY_SECRET_API_KEY!');
$params = new SmsParams('HI2U', '[phone]');
$client->sms($params);

See docs for more details.

Tests

Some basic tests are implemented. You can run them like this:

SEVEN_API_KEY=<API-KEY> SEVEN_API_KEY_SANDBOX=<SANDBOX-API-KEY> php vendor/bin/phpunit tests/Client

Make sure to fill in the values.

Support

Need help? Feel free to contact us.

php-client's Issues

[BUG] When you pass a wrong API-Key the code execution crashes fatally

Crash message:

Fatal error: Uncaught TypeError: Argument 1 passed to Sms77\Api\Response\Sms::__construct() must be an object or null, string given

Fatal Error - Missing parameter in method declaration

Declaration of Sms77\Api\Params\VoiceParams::setLanguage(?string $language): Sms77\Api\Params\VoiceParams must be compatible with Sms77\Api\Params\VoiceParamsInterface::setLanguage()

php-client/src/Params/VoiceParamsInterface.php

Line 26 in 9d56308

public function setLanguage();

PHP-Version: 8.0
php-client Version: 2.6.0

[FEAT] Signing Support

Be able to extract body, Url, Method from a Request without actually sending it to be able to sign it. Or support it natively

[BUG] Exception thrown on valid input

https://github.com/sms77io/php-client/blob/ec0339d72bcdfa930b80ab1c8cd2e2838b944d46/src/Validator/SmsValidator.php#L115

This code block throws an exception if the string consists of valid characters but solely of characters listed in SmsConstants::FROM_ALLOWED_CHARS. Because after the replace command the string will be empty and ctype_alnum() will return FALSE.

[FEAT] Host Documentation

Please host the docs somewhere like github pages.

I dont want to download the repo just to read the docs

[BUG] After closing the cURL-handle it can not be used with curl_error

https://github.com/sms77io/php-client/blob/ec0339d72bcdfa930b80ab1c8cd2e2838b944d46/src/BaseClient.php#L97-L102

PHP 7.4.24

curl_error needs to be called before curl_close.

Or the warning 'curl_error(): supplied resource is not a valid cURL handle resource' and subsequently an exception 'Uncaught Error: Wrong parameters for UnexpectedValueException' (as it is not a string) is thrown.

It seems you put the code upside down in that spot. 'Found that bug when curl wanted to complain about missing SSL klimborium.

[BUG] Faulty cast to boolean

Hey again!

https://github.com/sms77io/php-client/blob/ec0339d72bcdfa930b80ab1c8cd2e2838b944d46/src/Response/Sms.php#L19

(bool)"false" does not evaluate to the boolean value FALSE but to the boolean value TRUE.

https://www.php.net/manual/en/language.types.boolean.php

;)
Cheers!

Throw Exception if API is unreachable

In case of the API being down for whatever reason, a reasonable exception should be thrown.

[BUG] When you pass an empty string to setFrom() the message will not be sent but the costs are deducted from the account.