adamlc/address-format

A PHP library to parse street addresses to localized formats

Address Format

, _(*1)

A PHP library to parse street addresses to localized formats. The address formats are based on the formats supplied by Google's libaddressinput., _(*2)

I have written a few basic unit tests, but they could probably be improved. Feel free to submit a pull request if you improve them!, _(*3)

Composer

To install AddressFormat as a Composer package add this to your composer.json:, _(*4)

"adamlc/address-format": "~1.3"

Run composer update, _(*5)

Formatting a Street Address

//Create an address formatter instance
$address_formatter = new Adamlc\AddressFormat\Format;

//Set a locale using a two digit ISO country code.
$address_formatter->setLocale('GB');

//Set the address parts / attributes
$address_formatter['ADMIN_AREA'] = 'London';
$address_formatter['LOCALITY'] = 'Greenwich';
$address_formatter['RECIPIENT'] = 'Joe Bloggs';
$address_formatter['ORGANIZATION'] = 'Novotel London';
$address_formatter['POSTAL_CODE'] = 'SE10 8JA';
$address_formatter['STREET_ADDRESS'] = '173-185 Greenwich High Road';
$address_formatter['COUNTRY'] = 'United Kingdom';

//Get the address in localised format
$html = true; // Optional - return the address in HTML <br> instead of \n new lines

echo $address_formatter->formatAddress($html);

The above code will produce the following:, _(*6)

Joe Bloggs
Novotel London
173-185 Greenwich High Road
Greenwich
London
SE10 8JA

Note: Look in the i18n directory to view the meta data for the locales., _(*7)

The following attributes are available:, _(*8)

ADMIN_AREA
LOCALITY
RECIPIENT
ORGANIZATION
DEPENDENT_LOCALITY
POSTAL_CODE
SORTING_CODE
STREET_ADDRESS
COUNTRY, _(*9)