dougsisk / laravel-country-state
Laravel 的国家与州辅助工具。
4.3
2024-02-02 15:45 UTC
Requires
- php: ^7.4|^8.0
- illuminate/support: ^6.0|^7.0|^8.0|^9.0|^10.0|^11.0
- rinvex/countries: ^7.3|^8.0
Requires (Dev)
- orchestra/testbench: ^4.0|^5.0|^6.0|^7.0|^8.0|^9.0
- phpunit/phpunit: ^8.0|^9.0|^10.0|^11.0
README
用于在 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 许可证 下使用。