torann/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)

Installation

• Address Format on Packagist
• Address Format on GitHub

Composer

From the command line run:, _(*3)

$ composer require torann/address-format

Usage

Formatting

format(array $data, $html = false), _(*4)

Arguments:, _(*5)

• $data - An array of address elements
• $html - When set to true the address elements will be wrapped with span tags.

NOTE: The wrapping span tags contain itemprop attributes that adhere to the PostalAddress schema., _(*6)

Usage:, _(*7)

$address = \Torann\AddressFormat\Address::format([
    'recipient' => 'Jane Doe',
    'organization' => 'Whitworth Institute Inc.',
    'street_address' => '20341 Whitworth Institute',
    'street_address_2' => '405 N. Whitworth',
    'locality' => 'Seattle',
    'admin_area' => 'WA',
    'postal_code' => '98052',
    'country_iso' => 'US',
]);

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

Jane Doe
Whitworth Institute Inc.
20341 Whitworth Institute
405 N. Whitworth
Seattle, WA 98052

NOTE: The country_iso attribute is used to determine the address's format. The default is set to US., _(*9)

Custom Country Formats

This allows you to set your own formats., _(*10)

setFormats(array $countries), _(*11)

Arguments:, _(*12)

• $countries - An array of country ISO codes and corresponding formats values.

Usage:, _(*13)

\Torann\AddressFormat\Address::setFormats([
    'GB' => '%N%n%O%n%A%n%C%n%Z %R',
    'US' => '%N%n%O%n%A%n%C, %S %Z %R',
]);

Available Attributes

Change Log

v1.0.0

• First release