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上 打开问题。