Download the PHP package geoffreyrose/rank-phone-numbers without Composer

!!IN BETA!!

Find The Best Phone Number! PHP + Laravel Facade

A PHP/Laravel package to rank phone numbers to help you find the best ones. Great for when you have a list of phone numbers, and you want to find the best one to use.

Works great with Twilio, Bandwidth, Vonage, SignalWire or any other programmable communication provider to help you find the best phone number to use.

Requirements

• PHP 8.4+

Usage

Installation

With Plain PHP

With Laravel Facade

Laravel uses Package Auto-Discovery, which doesn't require you to manually add the ServiceProvider and Facade.

Example

Methods

setPhoneNumbers(array $phoneNumbers): self

Sets the phone numbers to be ranked

setPhoneNumbersKeyName(string $phoneNumbersKeyName): self

Sets the key name of the phone number when using an associative array or object

addRule($rule): self

Adds a rule to the ranking system. Must extend \RankPhoneNumbers\Abstracts\RuleAbstract

addWordRule($rule): self

Adds a word rule to the ranking system. Must extend \RankPhoneNumbers\Abstracts\WordRuleAbstract

rank(): array

Ranks the phone numbers. Returning an array of the phone numbers sorted by rank.

Includes the rank_phone_number_points and rank_phone_number_word_match_end properties.

Rules

Default Rules

Rules look at last four digits of the phone number.

• double_match (100 Points) // 2323
• ends_in_zero_or_five (50 Points) // XXX0 or XXX5
• funny_69 (10 Points) // XX69
• funny_420 (10 Points) // X420
• partial_sequential_numbers (90 Points) // 123X or X134, etc
• pattern_135 (60 Points) // 135X or X135
• pattern_246 (60 Points) // 246X or X246
• pattern_357 (60 Points) // 357X or X357
• pattern_369 (60 Points) // 369X or X369
• pattern_468 (60 Points) // 468X or X468
• pattern_579 (60 Points) // 579X or X579
• pattern_642 (60 Points) // 642X or X642
• pattern_753 (60 Points) // 753X or X753
• pattern_864 (60 Points) // 864X or X864
• pattern_963 (60 Points) // 963X or X963
• pattern_975 (60 Points) // 975X or X975
• pattern_two_increment (60 Points) // 123X or X123
• pattern_x2y2 (50 Points) // X2Y2
• repeats_in_a_row (100 Points) // 2323
• same_numbers (75 Points) // 2XX2, 2X2X 22XX, 22X2, 222X, etc
• sequential_numbers (100 Points) // 1234
• song_865 (10 Points) // X865 or 865X
• song_5309 (100 Points) // 5309
• symmetrical (100 Points) // 5225, 1221, etc
• two_from_end_is_zero_or_five (50 Points) // XX0X or XX5X

Modify Rules

Add Rule

Word Rules

The list of words that is checked against is mostly the words from the Oxford 5000, which is a list of 5000 words you should understand for a1-b2 english literacy. The list is trimmed down to be about 3000 words that are length 4-7 long.

Checks the last four, five, six, and seven letters of the phone number to see if it is a word in T9 conversion.

Default Word Rules

• word_is_last_four (5 Points)
• word_is_last_five (5 Points)
• word_is_last_six (5 Points)
• word_is_last_seven (5 Points)

Modify Word Rules

Rule Abstracts and Word Rule Abstracts

All defaults can be updated as needed.

For example, to change the points of a rule:

Rule Properties

• name: string
• points: int
• pattern: string

Word Rule Properties

If you want to disable a specific word rule, set isActive to false.

• name: string
• points: int
• isActive: bool
• endingDigitsToCheck: int

TODO

• [ ] Add Tests
• [ ] Documentation
• [ ] Add to or use a different word list