naknakaii / countries
该包是一个用户友好的Laravel包,提供国家列表及其代码、国旗、电话号码长度和简码。它简化了访问国家相关信息的流程,使开发者更容易将其集成到他们的应用程序中。
Requires
- php: >=8.0.0
- laravel/framework: >=9.0.0 <13.0.0
README
该包是一个用户友好的Laravel包,提供国家列表及其代码、国旗、电话号码长度和简码。它简化了访问国家相关信息的流程,使开发者更容易将其集成到他们的应用程序中。
安装
要安装包,请使用以下命令
composer require nakanakaii/countries
此外,将旗帜发布到您的应用程序的公共文件夹中。
php artisan vendor:publish --tag=countries-flags
最后,您可以在代码中导入它
use Nakanakaii\Countries\Countries;
使用
获取所有国家
要获取所有国家的列表,请使用以下代码
Countries::all()
all()
方法返回一个包含以下信息的国家对象数组
name
:国家的名称。code
:国家的ISO 3166-1 alpha-2代码。flag
:国家的国旗作为表情符号。minLength
:电话号码的最小长度。maxLength
:电话号码的最大长度。shortcode
:国家的简码或缩写。
按名称获取特定国家
要按名称查找特定国家,请使用 findByName()
方法
Countries::findByName('United Arab Emirates')
findByName()
方法接受国家名称作为参数,并返回匹配提供的名称的国家对象。
按代码获取特定国家
要按代码查找特定国家,请使用 findByCode()
方法
Countries::findByCode('AE')
findByCode()
方法接受国家代码(ISO 3166-1 alpha-2代码)作为参数,并返回匹配提供的代码的国家对象。
按拨号代码获取特定国家
要按拨号代码查找特定国家,请使用 findByDialCode()
方法
Countries::findByDialCode('971')
findByDialCode()
方法接受国家拨号代码作为参数,并返回匹配提供的拨号代码的国家对象。
按代码获取特定国家的验证规则
要按代码获取特定国家的验证规则,请使用 getPhoneValidatorByCode()
方法
Countries::getPhoneValidatorByCode('AE')
按拨号代码获取特定国家的验证规则
要按拨号代码获取特定国家的验证规则,请使用 getPhoneValidatorByDialCode()
方法
Countries::getPhoneValidatorByDialCode('971')
getPhoneValidatorByDialCode()
方法接受国家拨号代码作为参数,并返回该国家的电话号码验证规则。
注意:getPhoneValidatorByCode() 和 getPhoneValidatorByDialCode() 方法返回的验证规则是正则表达式,可用于电话号码验证。
请随意探索该包并根据您的应用程序需求使用提供的方法。
故障排除和数据校正
如果您遇到任何问题或有任何建议,或发现任何不正确或缺失的数据,请随时在GitHub上 打开问题。