dougsisk/laravel-country-state

Laravel 的国家与州辅助工具。

4.3 2024-02-02 15:45 UTC

This package is auto-updated.

Last update: 2024-08-31 00:52:05 UTC


README

Latest Stable Version Total Downloads License

用于在 Laravel 6.0+ 中列出英语国家与州的辅助工具。

4.0 版本中的变更

  • 需要 PHP 7.4+ 或 8.0+

安装

使用 Composer 需求此包

composer require dougsisk/laravel-country-state

如果已启用自动包发现,此包将自动由 Laravel 发现。如果您的自动包发现未启用,您需要将以下服务提供者添加到您的 config/app.php 配置文件中

DougSisk\CountryState\CountryStateServiceProvider::class,

使用发布命令将包配置复制到本地配置

php artisan vendor:publish --provider="DougSisk\CountryState\CountryStateServiceProvider" --tag="config"

配置

默认情况下,辅助工具将为美国预加载州。您可以通过 preloadCountryStates 配置选项更改此设置

'preloadCountryStates' => ['CA', 'MX', 'US']

如果您不想返回每个国家,您可以使用 limitCountries 配置选项定义国家

'limitCountries' => ['CA', 'MX', 'US']

使用方法

您现在可以使用 CountryState 门面来访问国家和州。

记得导入命名空间以在文件中访问门面

use CountryState;

获取国家数组

$countries = CountryState::getCountries();

数组键将是国家的 2 位字母 ISO 代码,值将是国家的英语名称。您还可以将 3 位字母 ISO 键作为参数设置以接收国家名称的翻译(有限支持)。

要获取一个国家的州数组,只需传递国家的 2 位字母 ISO 代码

$states = CountryState::getStates('US');

数组键将是州的 2 位字母 ISO 代码,值将是州的英语名称。

许可证

此库可在 MIT 许可证 下使用。