Download the PHP package nepada/phone-number-input without Composer

Phone number form input

Installation

Via Composer:

Option A: install form container extension method via DI extension

It will register extension method addPhoneNumber($name, $label = null, ?string $defaultRegionCode = null): PhoneNumberInput to Nette\Forms\Container.

Option B: use trait in your base form/container class

You can also use PhoneNumberInputMixin trait in your base form/container class to add method addPhoneNumber($name, $label = null, ?string $defaultRegionCode = null): PhoneNumberInput.

Example:

Usage

PhoneNumberInput is form control that uses phone number value object to represent its value (see brick/phonenumber for further details). It automatically validates the user input and getValue() method always returns PhoneNumber instance, or null if the input is not filled.

Validation

The default validation is fairly lenient - it performs only basic check based on the parsed region and the length of the number.

Strict validation

You can add a more strict validation rule PhoneNumberInput::VALID_STRICT. This rule validates the content against regular expressions from metadata database.

Warning: you must make sure you've got up-to-date metadata library, otherwise you risk running into false positives and false negatives during the validation. The metadata are provided by giggsey/libphonenumber-for-php for backend validation and libphonenumber-js for client side validation.

Region validation

You can restrict the input to accept only numbers from specific region(s):

Default region code

When creating the input you may specify default region code (ISO 3166-1 alpha-2 country code), e.g. $form->addPhoneNumber('phone', 'Phone', 'CZ'). This has two effects: 1) User may omit the country code prefix for this region in the input field, e.g. 212 345 678 is interpreted as +420 212 345 678. 2) When rendering the input, phone numbers for this region are displayed in national format instead of international, i.e. the country code is omitted.

Client side validation

This package comes with client side validation built on top of libphonenumber-js. It is published as npm package @nepada/phone-number-input.

libphonenumber-js provides several different metadata sets. You should choose the one based on your validation needs (e.g. if you don't need strict validation, go with min), or build your own custom metadata set.

Using precompiled bundle

Using precompiled bundles is the quick'n'dirty way of getting client side validation to work.

Building your own bundle

It is highly recommended to install the client side package via nmp and compile your own bundle. This way you can use your custom build of metadata set mentioned earlier.

Here is an example script for initialization of phone number input and Nette forms.