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