torann/address-format

一个PHP库,用于解析街道地址到本地化格式

1.0.0 2016-10-12 19:52 UTC

This package is auto-updated.

Last update: 2024-09-22 16:13:24 UTC


README

Build Status Latest Stable Version Total Downloads Patreon donate button Donate weekly to this project using Gratipay Donate to this project using Flattr Donate to this project using Paypal

一个PHP库,用于将街道地址解析为本地化格式。地址格式基于Google的libaddressinput提供的格式。

安装

Composer

在命令行运行

$ composer require torann/address-format

用法

格式化

format(array $data, $html = false)

参数

  • $data - 地址元素的数组
  • $html - 当设置为true时,地址元素将被span标签包裹。

注意:包裹的span标签包含遵循PostalAddress模式的itemprop属性。

用法

$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',
]);

上述代码将生成以下内容

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

注意:使用country_iso属性来确定地址的格式。默认设置为US

自定义国家格式

这允许您设置自己的格式。

setFormats(array $countries)

参数

  • $countries - 包含国家ISO代码和相应格式值的数组。

用法

\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',
]);

可用属性

变更日志

v1.0.0

  • 首次发布