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);