Formatting Phone Numbers in PHP

Question

I am working on an SMS app and need to be able to convert the sender s phone number from  11234567890 to 123-456-7890 so it can be compared to records in a MySQL database    The numbers are stored in the latter format for use elsewhere on the site and I would rather not change that format as it would require modifying a lot of code   How would I go about this with PHP   Thanks

User · Answer

United Kingdom Phone Formats

For the application I developed, I found that people entered their phone number 'correctly' from a human readable form, but inserted varous random characters such as '-' '/' '+44' etc. The problem was that the cloud app that it needed to talk to was quite specific about the format. Rather than use a regular expression (can be frustrating for the user) I created an object class which processes the entered number into the correct format before being processed by the persistence module.

The format of the output ensures that any receiving software interprets the output as text rather than an integer (which would then immediately lose the leading zero) and the format is consistent with British Telecoms guidelines on number formatting - which also aids human memorability by dividing a long number into small, easily memorised, groups.

+441234567890 produces (01234) 567 890
02012345678 produces (020) 1234 5678
1923123456 produces (01923) 123 456
01923123456 produces (01923) 123 456
01923hello this is text123456 produces (01923) 123 456

The significance of the exchange segment of the number - in parentheses - is that in the UK, and most other countries, calls between numbers in the same exchange can be made omitting the exchange segment. This does not apply to 07, 08 and 09 series phone numbers however.

I'm sure that there are more efficient solutions, but this one has proved extremely reliable. More formats can easily be accomodated by adding to the teleNum function at the end.

The procedure is invoked from the calling script thus

$telephone = New Telephone;
$formattedPhoneNumber = $telephone->toIntegerForm($num)

`

<?php
class   Telephone 
{   
    public function toIntegerForm($num) {
        /*
         * This section takes the number, whatever its format, and purifies it to just digits without any space or other characters
         * This ensures that the formatter only has one type of input to deal with
         */
        $number = str_replace('+44', '0', $num);
        $length = strlen($number);
        $digits = '';
        $i=0;
        while ($i<$length){
            $digits .= $this->first( substr($number,$i,1) , $i);
            $i++;
        }
        if (strlen($number)<10) {return '';}
        return $this->toTextForm($digits);
    }
    public function toTextForm($number) {

        /*
         * This works on the purified number to then format it according to the group code
         * Numbers starting 01 and 07 are grouped 5 3 3
         * Other numbers are grouped 3 4 4 
         * 
         */
        if (substr($number,0,1) == '+') { return $number; }
        $group = substr($number,0,2);
        switch ($group){
            case "02" :
                $formattedNumber = $this->teleNum($number, 3, 4); // If number commences '02N' then output will be (02N) NNNN NNNN
                break;
            default :
                $formattedNumber = $this->teleNum($number, 5, 3); // Otherwise the ooutput will be (0NNNN) NNN NNN
        }
        return $formattedNumber;

    }
    private function first($digit,$position){
        if ($digit == '+' && $position == 0) {return $digit;};
        if (!is_numeric($digit)){
            return '';
        }
        if ($position == 0) {
            return ($digit == '0' ) ? $digit :  '0'.$digit;
        } else {
            return $digit;
        } 
    }
    private function teleNum($number,$a,$b){
        /*
         * Formats the required output 
         */
        $c=strlen($number)-($a+$b);
        $bit1 = substr($number,0,$a);
        $bit2 = substr($number,$a,$b);
        $bit3 = substr($number,$a+$b,$c);
        return '('.$bit1.') '.$bit2." ".$bit3;
    }
}

User · Answer

All   I think I fixed it   Working for current input files and have following 2 functions to get this done   function format phone number           function format phone number    mynum   mask                                                                                                  Purpose  Return either masked phone number or false                               Masks  Val 1 or xxx xxx xxxx                                                                      Val 2 or xxx xxx xxxx                                                                      Val 3 or xxx xxx xxxx                                                                      Val 4 or  xxx  xxx xxxx                                                                    Val 5 or  xxx  xxx xxxx                                                                    Val 6 or  xxx  xxx xxxx                                                                    Val 7 or  xxx  xxx-xxxx                                                                    Val 8 or  xxx -xxx-xxxx                                                                                                                                                val num          self  validate phone number    mynum            if     val num  amp  amp   is string    mynum                    echo  Number  mynum is not a valid phone number   n               return false                 end if   val num         if      mask    1         mask     xxx xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                               1  2  3     n    mynum               return  phone                 end if  mask    1         if      mask    2         mask     xxx xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                               1  2  3     n    mynum               return  phone                 end if  mask    2         if      mask    3         mask     xxx xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                               1  2  3     n    mynum               return  phone                 end if  mask    3         if      mask    4         mask      xxx  xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                                1   2  3     n    mynum               return  phone                 end if  mask    4         if      mask    5         mask      xxx  xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                                1   2  3     n    mynum               return  phone                 end if  mask    5         if      mask    6         mask      xxx  xxx xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                                1   2  3     n    mynum               return  phone                 end if  mask    6         if      mask    7         mask      xxx  xxx-xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                                1   2- 3     n    mynum               return  phone                 end if  mask    7         if      mask    8         mask      xxx -xxx-xxxx                      phone   preg replace       d 3     d    d 3     d    d 4                                1 - 2- 3     n    mynum               return  phone                 end if  mask    8         return false           Returns false if no conditions meet or input           end function format phone number   function validate phone number           function validate phone number    phone                                                                                                  Purpose    To determine if the passed string is a valid phone                             number following one of the establish formatting                                       styles for phone numbers   This function also breaks                                   a valid number into it s respective components of                                              3-digit area code                                                                              3-digit exchange code                                                                          4-digit subscriber number                                                              and validates the number against 10 digit US NANPA                                 guidelines                                                                                                                                                               format pattern                    d 3        d 3        lt     d 3                                                s   -      d 3    s    -    d 4   s                                                     e x ex ext        extension     s      d                                            d                  nanpa pattern                1        37 96   2-9  0-8  0-9    lt   11                                             2-9  0-9  2    lt   11   0-9  4    lt   555 01  0-9                                          0-9   1212                    Init array of variables to false          valid   array  format    gt   false                               nanpa    gt  false                               ext          gt  false                               all          gt  false              Check data against the format analyzer         if   preg match    format pattern   phone   matchset                    valid  format     true                           If formatted properly  continue           if  valid  format              if     valid  format                   return false            else                 Set array of new components              components     array    ac    gt   matchset 1     area code                                                              xc    gt   matchset 2     exchange code                                                              sn    gt   matchset 3    subscriber number                                                                                             components     array    ac    gt   matchset 1     area code                                                              xc    gt   matchset 2     exchange code                                                              sn    gt   matchset 3     subscriber number                                                              xn    gt   matchset 4    extension number                                                                                            Set array of number variants              numbers        array    original    gt   matchset 0                                            stripped    gt  substr preg replace    D         matchset 0    0  10                                                            Now let s check the first ten digits against NANPA standards             if preg match  nanpa pattern   numbers  stripped                        valid  nanpa     true                               If the NANPA guidelines have been met  continue             if    valid  nanpa                       if    empty    components  xn                             if   preg match        d  1 6       components  xn                                  valid  ext     true                             end if if preg match                    else                        valid  ext     true                         end if if   empty                    end if  valid nanpa                If the extension number is valid or non-existent  continue             if    valid  ext                        valid  all     true                     end if  valid ext                end if  valid         return  valid  all               end functon validate phone number   Notice I have this in a class lib  so thus the  self  validate phone number  call from the first function method   Notice line   32 of the  validate phone number  function where I added the               if     valid  format                   return false            else     to get me the false return needed if not valid phone number   Still need to test this against more data  but working on current data  with current format and I m using style  8  for this particular data batch   Also I commented out the  extension  logic as I was constantly getting errors from it  seeing I do not have any of that info in my data

User · Answer

Here s a simple function for formatting phone numbers with 7 to 10 digits in a more European  or Swedish   manner   function formatPhone  num         num   preg replace     0-9          num        len   strlen  num        if  len    7   num   preg replace     0-9  2    0-9  2    0-9  3        1  2  3    num       elseif  len    8   num   preg replace     0-9  3    0-9  2    0-9  3        1 -  2  3    num       elseif  len    9   num   preg replace     0-9  3    0-9  2    0-9  2    0-9  2        1 -  2  3  4    num       elseif  len    10   num   preg replace     0-9  3    0-9  2    0-9  2    0-9  3        1 -  2  3  4    num        return  num

User · Answer

this takes 7  10 and 11 digit  removes additional characters and adds dashes by going right to left through the string  change the dash to a space or dot    raw phone   preg replace    D         raw phone    temp   str split  raw phone    phone number       for   x count  temp -1  x gt  0  x--        if   x     count  temp  - 5     x     count  temp  - 8     x     count  temp  - 11             phone number    -     phone number             phone number    temp  x     phone number    echo  phone number

User · Answer

Try something like   preg replace    d 3       0-   str replace      null  trim  number    2     this would take a  number of 8881112222 and convert to 888-111-2222  Hope this helps

User · Answer

I see this being possible using either some regex  or a few substr calls  assuming the input is always of that format  and doesn t change length etc    something like   in     11234567890    output   substr  in 2 3   -  substr  in 6 3   -  substr  in 10 4     should do it

User · Answer

Please have a look at substr based function that can change formats  function phone string  in   string        FORMAT PHONE    1 3 3 4        result           position   0      foreach   FORMAT PHONE as  key   gt   item            result     substr  in   position   item            position     item            return     implode  -   result

User · Answer

This is for UK landlines without the Country Code  function format phone number  number         result   preg replace       d 2     d  0 7   d 4     d  0 7   d 4          1  2  3    number       return  result      Result   2012345678 becomes 20 1234 5678

User · Answer

This is a US phone formatter that works on more versions of numbers than any of the current answers    numbers   explode   n     111  222-3333   111  222-3333 1112223333 111 222-3333 111-222-3333  111 2223333  11234567890     1-8002353551     123-456-7890   -Hello   1 - 1234567890        foreach  numbers as  number        print preg replace       d 3     d  0 7   d 3     d  0 7   d 4           1   2- 3    number     n       And here is a breakdown of the regex   Cell   1 999- 555 0001               zero or more of anything  Cell   1     d 3       three digits  999     d  0 7   zero or up to 7 of something not a digit  -     d 3       three digits  555     d  0 7   zero or up to 7 of something not a digit       d 4       four digits  0001              zero or more of anything       Updated  March 11  2015 to use  0 7  instead of   7

User · Answer

Phone numbers are hard  For a more robust  international solution  I would recommend this well-maintained PHP port of Google s libphonenumber library    Using it like this    use libphonenumber NumberParseException  use libphonenumber PhoneNumber  use libphonenumber PhoneNumberFormat  use libphonenumber PhoneNumberUtil    phoneUtil   PhoneNumberUtil  getInstance      numberString     12123456789    try        numberPrototype    phoneUtil- gt parse  numberString   US         echo  Input                numberString     n       echo  isValid              phoneUtil- gt isValidNumber  numberPrototype     true     false       n       echo  E164                 phoneUtil- gt format  numberPrototype  PhoneNumberFormat  E164      n       echo  National             phoneUtil- gt format  numberPrototype  PhoneNumberFormat  NATIONAL      n       echo  International        phoneUtil- gt format  numberPrototype  PhoneNumberFormat  INTERNATIONAL      n     catch  NumberParseException  e           handle any errors     you will get the following output    Input   12123456789 isValid  true E164   12123456789 National   212  345-6789 International   1 212-345-6789   I d recommend using the E164 format for duplicate checks  You could also check whether the number is a actually mobile number or not  using PhoneNumberUtil  getNumberType     or whether it s even a US number  using PhoneNumberUtil  getRegionCodeForNumber      As a bonus  the library can handle pretty much any input  If you  for instance  choose to run 1-800-JETBLUE through the code above  you will get  Input  1-800-JETBLUE isValid  true E164   18005382583 National   800  538-2583 International   1 800-538-2583   Neato   It works just as nicely for countries other than the US  Just use another ISO country code in the parse   argument

User · Answer

Here s my USA-only solution  with the area code as an optional component  required delimiter for the extension  and regex comments   function formatPhoneNumber  s     rx           1   D        optional country code       d 3    D    optional area code       d 3   D     first three       d 4         last four         D         extension delimiter or EOL       d           optional extension  x   preg match  rx   s   matches   if  isset  matches 0    return false    country    matches 1    area    matches 2    three    matches 3    four    matches 4    ext    matches 5     out     three- four   if  empty  area    out     area- out   if  empty  country    out      country- out   if  empty  ext    out     x ext       check that no digits were truncated    if  preg replace    D         s     preg replace    D         out   return false  return  out      And here s the script to test it    numbers      3334444    2223334444    12223334444    12223334444x5555    333-4444     222 333-4444     1 222-333-4444    1-222-333-4444ext555    cell   222  333-4444     222  333-4444  cell        foreach  numbers as  number        print formatPhoneNumber  number    lt br gt  r n

User · Answer

Don t reinvent the wheel  Import this amazing library  https   github com giggsey libphonenumber-for-php   defaultCountry    SE      Based on the country of the user  phoneUtil   PhoneNumberUtil  getInstance     swissNumberProto    phoneUtil- gt parse  phoneNumber   defaultCountry    return  phoneUtil- gt format  swissNumberProto  PhoneNumberFormat  INTERNATIONAL     It is based on Google s library for parsing  formatting  and validating international phone numbers   https   github com google libphonenumber

User · Answer

It s faster than RegEx         input    0987654321      output   substr  input  -10  -7     -    substr  input  -7  -4     -    substr  input  -4    echo  output

User · Answer

Assuming that your phone numbers always have this exact format  you can use this snippet    from     11234567890    to   sprintf   s- s- s                 substr  from  2  3                 substr  from  5  3                 substr  from  8

User · Answer

Check Phone number   phone     385 99 1234 1234    str   preg match        d 1 3   s-   d 1 3   s-   d 1 4   s-   d 1 4       phone    if  str   return true   else  return false

User · Answer

Here   s my take    phone   11234567890    parts sscanf  phone   2c 3c 3c 4c    print   parts 1 - parts 2 - parts 3         123-456-7890   The sscanf function takes as a second parameter a format string telling it how to interpret the characters from the first string  In this case  it means 2 characters   2c   3 characters  3 characters  4 characters   Normally the sscanf function would also include variables to capture the extracted data  If not  the data is return in an array which I have called  parts   The print statement outputs the interpolated string   part 0  is ignored   I have used a similar function to format Australian phone numbers   Note that from the perspective of storing the phone number    phone numbers are strings stored data should not include formatting  such as spaces or hyphens

User · Answer

Another option - easily updated to receive a format from configuration    numbers   explode   n     111  222-3333   111  222-3333 1112223333 111 222-3333 111-222-3333  111 2223333  11234567890     1-8002353551     123-456-7890   -Hello   1 - 1234567890     foreach   numbers AS  number      echo comMember format  phoneNumber  number      lt br gt                                                                                      Format Phone Number public function phoneNumber   number       txt   preg replace     s -                 number      format      1  1     2   2  x   3    4  5    6  7   7       if  preg match          d 3      d     d 3      d     d 4      d  0 1          txt   matches          result    format      foreach   matches AS  k   gt   v           str   preg match          k                          k                  k    1      format   filterMatch         if   filterMatch             result   str replace   filterMatch 0     isset  filterMatch 3      strlen  v    str replace       k   v   filterMatch 1       filterMatch 2      strlen  v     v    isset  filterMatch 4           isset  filterMatch 3      filterMatch 3             result                      return  result        return  number

User · Answer

data     11234567890    if   preg match        d  d 3    d 3    d 4        data    matches            result    matches 1     -    matches 2     -     matches 3       return  result

User · Answer

This function will format international  10  digit   non-international  10 digit  or old school  7 digit  phone numbers  Any numbers other than 10   10 or 7 digits will remain unformatted   function formatPhoneNumber  phoneNumber         phoneNumber   preg replace     0-9        phoneNumber        if strlen  phoneNumber   gt  10             countryCode   substr  phoneNumber  0  strlen  phoneNumber -10            areaCode   substr  phoneNumber  -10  3            nextThree   substr  phoneNumber  -7  3            lastFour   substr  phoneNumber  -4  4             phoneNumber        countryCode       areaCode       nextThree  -   lastFour            else if strlen  phoneNumber     10             areaCode   substr  phoneNumber  0  3            nextThree   substr  phoneNumber  3  3            lastFour   substr  phoneNumber  6  4             phoneNumber        areaCode       nextThree  -   lastFour            else if strlen  phoneNumber     7             nextThree   substr  phoneNumber  0  3            lastFour   substr  phoneNumber  3  4             phoneNumber    nextThree  -   lastFour             return  phoneNumber

User · Answer

I know the OP is requesting a 123-456-7890 format  but  based on John Dul s answer  I modified it to return the phone number in parentheses format  e g   123  456-7890  This one only handles 7 and 10 digit numbers   function format phone string   raw number             remove everything but numbers      raw number   preg replace     D         raw number            split each number into an array      arr number   str split  raw number           add a dummy value to the beginning of the array     array unshift   arr number   dummy             remove the dummy value so now the array keys start at 1     unset  arr number 0            get the number of numbers in the number      num number   count  arr number           loop through each number backward starting at the end     for    x    num number   x  gt   0   x--              if    x      num number - 4                    before the fourth to last number               phone number    -     phone number                    else if    x      num number - 7  amp  amp   num number  gt  7                    before the seventh to last number                and only if the number is more than 7 digits               phone number           phone number                    else if    x      num number - 10                    before the tenth to last number               phone number          phone number                        concatenate each number  possibly with modifications  back on          phone number    arr number  x     phone number             return  phone number

[php] Formatting Phone Numbers in PHP

Examples related to php

Examples related to phone-number