addressing下载 - addressing源码下载

addressing

其他源码

v2.2.2

下载

寻址

PHP 8.0+ 寻址库，由 CLDR 和 Google 的地址数据提供支持。

操纵邮政地址，旨在识别精确的收件人位置以用于运输或计费目的。

特征：

国家/地区，提供 250 多个语言环境的翻译。由 CLDR v46 提供支持。
200 多个国家/地区的地址格式
60个国家的细分（行政区域、地区、附属地区）
相关的拉丁语和当地细分名称（例如：冲绳/冲縄県）
HTML 或纯文本格式。
通过 symfony/validator 进行验证
区域

地址格式和细分最初是由 Google 的地址数据服务生成的，现在由图书馆拥有和维护。

另请查看 commerceguys/intl 以了解 CLDR 支持的语言/货币/数字格式。

数据模型

地址接口表示邮政地址，具有以下字段的 getter：

国家代码
行政区
地点（城市）
附属地点
邮政编码
排序代码
地址第一行
地址行2
地址行 3
组织
名字（名字）
附加名（中间名/父名）
姓氏（姓氏）

字段名称遵循 OASIS 可扩展地址语言 (xAL) 标准。

该接口不对可变性做出任何假设。实现应用程序可以扩展接口以提供设置器，或者实现使用 PSR-7 样式和* 变元或依赖于 AddressBuilder 的值对象。提供了一个默认地址值对象，可以用作示例，或由 Doctrine 映射（最好作为可嵌入的）。

地址格式提供以下信息：

使用哪些字段以及按什么顺序
哪些字段是必填的
实际邮寄时哪些字段需要大写（方便邮件自动排序）
行政区域（州、省、教区等）、地点（城市/邮政城镇/区等）、附属地点（社区、郊区、区等）和邮政编码（邮政编码或邮政编码）的标签代码）
用于验证邮政编码的正则表达式模式

国家提供以下信息：

国名。
数字和三字母国家代码。
官方货币代码（如果已知）。
该国家/地区跨越的时区。

该细分提供以下信息：

细分代码（用于表示包裹/信封上的细分，例如 CA 代表加利福尼亚州）
细分名称（在下拉列表中向用户显示）
如果该国家/地区使用非拉丁文字（例如俄罗斯的西里尔字母），则为本地代码和名称。
邮政编码模式（如果与地址格式中的不同）。

细分是分层的，最多可以有三个级别：行政区域 -> 地区 -> 附属地区。

 use CommerceGuys  Addressing  AddressFormat  AddressFormatRepository ;
use CommerceGuys  Addressing  Country  CountryRepository ;
use CommerceGuys  Addressing  Subdivision  SubdivisionRepository ;

$ countryRepository = new CountryRepository ();
$ addressFormatRepository = new AddressFormatRepository ();
$ subdivisionRepository = new SubdivisionRepository ();

// Get the country list (countryCode => name), in French.
$ countryList = $ countryRepository -> getList ( ' fr-FR ' );

// Get the country object for Brazil.
$ brazil = $ countryRepository -> get ( ' BR ' );
echo $ brazil -> getThreeLetterCode (); // BRA
echo $ brazil -> getName (); // Brazil
echo $ brazil -> getCurrencyCode (); // BRL
print_r ( $ brazil -> getTimezones ());

// Get all country objects.
$ countries = $ countryRepository -> getAll ();

// Get the address format for Brazil.
$ addressFormat = $ addressFormatRepository -> get ( ' BR ' );

// Get the subdivisions for Brazil.
$ states = $ subdivisionRepository -> getAll ([ ' BR ' ]);
foreach ( $ states as $ state ) {
    $ municipalities = $ state -> getChildren ();
}

// Get the subdivisions for Brazilian state Ceará.
$ municipalities = $ subdivisionRepository -> getAll ([ ' BR ' , ' CE ' ]);
foreach ( $ municipalities as $ municipality ) {
    echo $ municipality -> getName ();
}

格式化程序

地址根据地址格式进行格式化，采用 HTML 或文本格式。

默认格式化程序

设置显示地址的格式，始终添加本地化的国家/地区名称。

 use CommerceGuys  Addressing  Address ;
use CommerceGuys  Addressing  Formatter  DefaultFormatter ;
use CommerceGuys  Addressing  AddressFormat  AddressFormatRepository ;
use CommerceGuys  Addressing  Country  CountryRepository ;
use CommerceGuys  Addressing  Subdivision  SubdivisionRepository ;

$ addressFormatRepository = new AddressFormatRepository ();
$ countryRepository = new CountryRepository ();
$ subdivisionRepository = new SubdivisionRepository ();
$ formatter = new DefaultFormatter ( $ addressFormatRepository , $ countryRepository , $ subdivisionRepository );
// Options passed to the constructor or format() allow turning off
// html rendering, customizing the wrapper element and its attributes.

$ address = new Address ();
$ address = $ address
    -> withCountryCode ( ' US ' )
    -> withAdministrativeArea ( ' CA ' )
    -> withLocality ( ' Mountain View ' )
    -> withAddressLine1 ( ' 1098 Alta Ave ' );

echo $ formatter -> format ( $ address );

/** Output:
<p translate="no">
<span class="address-line1">1098 Alta Ave</span><br>
<span class="locality">Mountain View</span>, <span class="administrative-area">CA</span><br>
<span class="country">United States</span>
</p>
**/

邮政标签格式化程序

根据格式要求处理大写字段（以促进自动邮件分类）。

需要指定始发国家/地区代码，以便区分国内和国际邮件。如果是国内邮件，则根本不显示国家/地区名称。如果是国际邮件：

邮政编码以目的地的邮政编码前缀作为前缀。
国家/地区名称将以当前区域设置和英语添加到格式化的地址中。这符合万国邮政联盟的建议，以避免过境国遇到困难。

 use CommerceGuys  Addressing  Address ;
use CommerceGuys  Addressing  Formatter  PostalLabelFormatter ;
use CommerceGuys  Addressing  AddressFormat  AddressFormatRepository ;
use CommerceGuys  Addressing  Country  CountryRepository ;
use CommerceGuys  Addressing  Subdivision  SubdivisionRepository ;

$ addressFormatRepository = new AddressFormatRepository ();
$ countryRepository = new CountryRepository ();
$ subdivisionRepository = new SubdivisionRepository ();
// Defaults to text rendering. Requires passing the "origin_country"
// (e.g. 'FR') to the constructor or to format().
$ formatter = new PostalLabelFormatter ( $ addressFormatRepository , $ countryRepository , $ subdivisionRepository , [ ' locale ' => ' fr ' ]);

$ address = new Address ();
$ address = $ address
    -> withCountryCode ( ' US ' )
    -> withAdministrativeArea ( ' CA ' )
    -> withLocality ( ' Mountain View ' )
    -> withAddressLine1 ( ' 1098 Alta Ave ' );

echo $ formatter -> format ( $ address , [ ' origin_country ' => ' FR ' ]);

/** Output:
1098 Alta Ave
MOUNTAIN VIEW, CA 94043
ÉTATS-UNIS - UNITED STATES
**/

验证器

地址验证依赖于 Symfony Validator 库。

执行的检查：

所有必填字段均已填写。
该国家/地区格式未使用的所有字段均为空。
所有细分都是有效的（值与预定义的细分相匹配）。
邮政编码有效（国家和分区级别模式）。

 use CommerceGuys  Addressing  Address ;
use CommerceGuys  Addressing  Validator  Constraints  AddressFormatConstraint ;
use CommerceGuys  Addressing  Validator  Constraints  CountryConstraint ;
use Symfony  Component  Validator  Validation ;

$ address = new Address ( ' FR ' );

$ validator = Validation :: createValidator ();
// Validate the country code, then validate the rest of the address.
$ violations = $ validator -> validate ( $ address -> getCountryCode (), new CountryConstraint ());
if (! $ violations -> count ()) {
  $ violations = $ validator -> validate ( $ address , new AddressFormatConstraint ());
}

区域

区域是通常用于运输或税收目的的领土分组。例如，与某个区域关联的一组运费，仅当客户的地址属于该区域时，这些费率才可用。

区域可以匹配国家/地区、分区（州/省/直辖市）、邮政编码。邮政编码也可以使用范围或正则表达式来表示。

区域示例：

加利福尼亚州和内华达州
比利时、荷兰、卢森堡
德国和一组奥地利邮政编码 (6691、6991、6992、6993)
没有特定邮政编码的奥地利 (6691, 6991, 6992, 6993)

 use CommerceGuys  Addressing  Address ;
use CommerceGuys  Addressing  Zone  Zone ;

// Create the German VAT zone (Germany and 4 Austrian postal codes).
$ zone = new Zone ([
    ' id ' => ' german_vat ' ,
    ' label ' => ' German VAT ' ,
    ' territories ' => [
        [ ' country_code ' => ' DE ' ],
        [ ' country_code ' => ' AT ' , ' included_postal_codes ' => ' 6691, 6991:6993 ' ],
    ],
]);

// Check if the provided austrian address matches the German VAT zone.
$ austrianAddress = new Address ();
$ austrianAddress = $ austrianAddress
    -> withCountryCode ( ' AT ' )
    -> withPostalCode ( ' 6992 ' );
echo $ zone -> match ( $ austrianAddress ); // true