Telefonní číslo

Třída BulkGate\Sms\Message\PhoneNumber reprezentuje objekt telefonního čísla.

use BulkGate\Sms\Message\PhoneNumber;

Konstruktor přijímá povinný parametr telefonní číslo a volitelný parametr ISO kódu země.

$phone_number = new PhoneNumber(
    "420777777777", 
    BulkGate\Sms\Country::CZECH_REPUBLIC
);

Druhý parametr je nutný v případě, že zadáváte telefonní číslo v národním formátu. Pokud zadáte telefonní číslo v národním formátu a nevyplníte ISO 3166-1 alpha-2 kód, pak se BulkGate pokusí doplnit mezinárodní telefonní předvolbu podle země uvedenou ve vašem uživatelském účtu.

Změnit telefonní číslo lze i po vytvoření instance.

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
$phone_number->phoneNumber('420777777777');

Stejně lze nastavit i ISO kód.

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
$phone_number->iso(BulkGate\Sms\Country::CZECH_REPUBLIC);

// nebo

$phone_number->iso('cz');

V případě neplatného ISO kódu je vyvolána výjimka BulkGate\Sms\Message\InvalidPhoneNumberException

Převedení na JSON

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
echo json_encode($phone_number);

Výstupem je:

{
    "number": "420777777777",
    "iso": null
}

Ostatní

Získání zformátovaného telefonního čísla v řetězci

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
$phone_number->getPhoneNumber();
$number = (string) $phone_number; 
echo $phone_number;

Získání ISO kódu

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
$phone_number->getIso(); // vrátí řetězec nebo null

Podporuje také fluentní rozhraní (anglicky fluent interface)

/** @var BulkGate\Sms\Message\PhoneNumber $phone_number */
$phone_number
    ->phoneNumber('777777777')
    ->iso(BulkGate\Sms\Country::CZECH_REPUBLIC);