🇨🇱 Chilean Phone Tool ☎️

Introduction

A PHP composer package to work with Chilean 🇨🇱 phone numbers.

Features

• Parsing
• Get prefix
• Validation
• Formatting
• Factory

Contents

• Introduction
  • Features
  • Contents
• Install
  • Requirements
• Usage
  • Set a phone number.
    • parse
    • setPhone
  • Validation
    • validate
    • errors and messages
    • Error messages
    • Ignore prefix validation
    • fix and luckyFix
  • Formatting
    • format
    • Choosing format
  • Factory
  • Aliases
• Inspired by
• License

Install

Requirements

• PHP >= 7.3

Usage

Set a phone number.

parse

Usually you may want to take a phone in any format, check if it's valid and bring it to the desired format. Use parse to set the number, if that the case.

If you parse a valid number you can get the number and prefix just calling these:

Clean an invalid input (use quiet to prevent validation exceptions):

setPhone

Sometimes you just want to know if an input value is a valid phone number without clean or make any changes on it before validation. It's time to use setPhone:

Validation

validate

Use validate to check if it is a valid number. An invalid number will throw an exception with a message giving information about the reasons.

The features of this tool make sense on a valid phone. This is why by default it works with exceptions. But you can use quiet to avoid this behavior, but be careful, if you try to get or format an invalid number you will get the original digits or value depending on the case.

errors and messages

They allow to obtain an array with validation messages if quiet has been used. They may look like aliases, but there is a little difference:

• with errors you get a list of the validation messages with error codes as keys.
• with messages you only get the messages.

Error messages

Ignore prefix validation

To avoid prefix validation use ignorePrefix:

fix and luckyFix

Tries to set a valid phone from original input.

Use getOld to get original value.

Sometimes the inputs may lack the Santiago prefix (2). Use luckFix to fix and try to guess if the missing prefix can be fixed.

As you can see, after fix, validation can be true. If you need to check if original was modified because it was invalid, then you can count errors.

Formatting

format

Use format on a valid phone to get the value in standard numbering format.

Choosing format

Give format method the desired format as an argument.

Factory

You can generate a valid phone number using Phone Tool:

Make multiple numbers giving a count as argument to make method.

You can use the unique, cellPhone, landLine or prefix modifiers to make unique numbers, cell phone, landline (red fija), or set a valid prefix manually.

Use format (check choosing format) modifier to give desired format to numbers.

Aliases

Inspired by

Freshworks Chilean Bundle

License

MIT License
Copyright (c) 2021 gmarsano