respect-validation/docs/rules/Phone.md

# Phone

- `Phone()`
- `Phone(string $countyCode)`

Validates whether the input is a valid phone number.

```php
v::phone()->validate('+1 650 253 00 00'); // true
v::phone('BR')->validate('+55 11 91111 1111'); // true
v::phone('BR')->validate('11 91111 1111'); // false
```

## Note

When validating with `$countryCode`, this rule will require the `giggsey/libphonenumber-for-php-lite` package.

## Categorization

- Strings

## Changelog

| Version | Description                         |
|--------:|-------------------------------------|
|   2.3.0 | Introduced a validation per country |
|   0.5.0 | Created                             |

***
See also:

- [Email](Email.md)
- [Json](Json.md)
- [Url](Url.md)
- [VideoUrl](VideoUrl.md)
Update documentation 2015-01-30 09:40:06 +01:00			`# Phone`

Change how documentation of rules are presented Rules are not always used from the alias `v`, neither called staticaly. 2017-03-27 14:47:07 +02:00			- `Phone()`
Remove backwards compatibility break from Phone rule In version 2.3, the Phone rule started to require "giggly/libphonenumber-for-php" as a dependency. That was a backward compatibility break, but the validation also became stricter, and phone numbers without country codes would not be considered valid. This commit will revert the backward compatibility break. That way, when validating a phone number without a country code (the behaviour from version 2.2), the Phone will not use an external library. Signed-off-by: Henrique Moody <henriquemoody@gmail.com> 2024-03-11 22:06:55 +01:00			- `Phone(string $countyCode)`
Update documentation 2015-01-30 09:40:06 +01:00
Remove backwards compatibility break from Phone rule In version 2.3, the Phone rule started to require "giggly/libphonenumber-for-php" as a dependency. That was a backward compatibility break, but the validation also became stricter, and phone numbers without country codes would not be considered valid. This commit will revert the backward compatibility break. That way, when validating a phone number without a country code (the behaviour from version 2.2), the Phone will not use an external library. Signed-off-by: Henrique Moody <henriquemoody@gmail.com> 2024-03-11 22:06:55 +01:00			`Validates whether the input is a valid phone number.`
Update documentation 2015-01-30 09:40:06 +01:00
Use libphonenumber Doing regex on phone numbers is not a great idea. This is a breaking change, but a good one. Phone validation is now much stricter, and allows choosing the country. 2023-02-18 22:09:26 +01:00			```php
			`v::phone()->validate('+1 650 253 00 00'); // true`
			`v::phone('BR')->validate('+55 11 91111 1111'); // true`
			`v::phone('BR')->validate('11 91111 1111'); // false`
			```
Add changelog to rules' documentation Also: - Create documentation for `Base` rule; - Increase number of rules 2017-03-27 22:04:13 +02:00
Remove backwards compatibility break from Phone rule In version 2.3, the Phone rule started to require "giggly/libphonenumber-for-php" as a dependency. That was a backward compatibility break, but the validation also became stricter, and phone numbers without country codes would not be considered valid. This commit will revert the backward compatibility break. That way, when validating a phone number without a country code (the behaviour from version 2.2), the Phone will not use an external library. Signed-off-by: Henrique Moody <henriquemoody@gmail.com> 2024-03-11 22:06:55 +01:00			`## Note`

			When validating with `$countryCode`, this rule will require the `giggsey/libphonenumber-for-php-lite` package.

Add "Categorization" section to rule documentations Signed-off-by: Henrique Moody <henriquemoody@gmail.com> 2019-05-11 18:32:13 +02:00			`## Categorization`

			`- Strings`

Add changelog to rules' documentation Also: - Create documentation for `Base` rule; - Increase number of rules 2017-03-27 22:04:13 +02:00			`## Changelog`

Remove backwards compatibility break from Phone rule In version 2.3, the Phone rule started to require "giggly/libphonenumber-for-php" as a dependency. That was a backward compatibility break, but the validation also became stricter, and phone numbers without country codes would not be considered valid. This commit will revert the backward compatibility break. That way, when validating a phone number without a country code (the behaviour from version 2.2), the Phone will not use an external library. Signed-off-by: Henrique Moody <henriquemoody@gmail.com> 2024-03-11 22:06:55 +01:00			`\| Version \| Description \|`
			`\|--------:\|-------------------------------------\|`
			`\| 2.3.0 \| Introduced a validation per country \|`
			`\| 0.5.0 \| Created \|`
Documentation improvements - Add a space after comments with `//`; - Add missing "See also" sections in some files 2015-10-20 02:53:25 +02:00
			`***`
			`See also:`

Uniform Markdown lists on documentation 2017-03-28 11:53:14 +02:00			`- [Email](Email.md)`
Merge branch '1.1' 2018-12-11 13:31:50 +01:00			`- [Json](Json.md)`
Uniform Markdown lists on documentation 2017-03-28 11:53:14 +02:00			`- [Url](Url.md)`
			`- [VideoUrl](VideoUrl.md)`