README

Laravel WorldCountries 是一个Laravel捆绑包，提供有用的全球信息，包括所有国家名称、时区、ISO国家代码、国家的STD代码等。

此包仅提供世界195个左右国家的国家名称数据，包括大洲名称、海洋名称、联邦属地名称、世界奇迹名称、ISO代码和ISO信息、时区和时区信息，以及货币和货币代码和符号信息。

还提供按国家划分的州和按州划分的城市信息。

Note: As of now the support for database option is not there, It will be implemented soon.
      (See this area for new updates.)

**请注意，始终使用此包的最新版本，并且必须仅使用Laravel 5及以上版本，因为此包可能无法正确与Laravel的旧版本配合工作。

安装

打开终端，进入根目录，并运行以下命令

composer require someshwer/world-countries

包将被安装。

将Someshwer\WorldCountries\WorldDataServiceProvider::class类添加到config/app.php文件中的providers数组中。

Ex:-

'providers' => [
    ...,
    ...,
    Someshwer\WorldCountries\WorldDataServiceProvider::class,
]

现在将别名添加到config/app.php文件中的aliases数组中。

Ex:- 

'aliases' => [
     ...,
     ...,
     'World' => Someshwer\WorldCountries\Facades\World::class,
]

您可以通过发布配置来开始。

$ php artisan vendor:publish --provider="Someshwer\WorldCountries\WorldDataServiceProvider"

就这样！您已完成包的安装...

使用方法

接下来，按照以下方式使用此包

1. World::countries();

它返回世界上的所有国家名称。

2. World::searchCountry('xx');

其中参数'xx'是搜索字符串。您可以通过搜索字符串搜索国家。如果没有提供搜索字符串，则将返回所有国家名称。

3. World::continents();

它返回所有大洲名称。

4. World::oceans();

它返回世界上的所有海洋名称。

5. World::unionTerritories();

它返回世界上的所有联邦属地名称。

6. World::wonders();

它返回世界上的所有奇迹名称。

7. World::isoCodes();

它返回世界上的所有国家ISO代码。您还可以为ISO代码获取分页结果。如果要在config/world.php配置文件中分页ISO代码，则只需将'iso'选项设置为TRUE。您还可以设置每页要显示的记录数。只需查看config/world.php文件中可用的配置选项。

使用分页时，您必须从请求URL中给出页码。例如：您正在调用iso代码，如World::isoCodes().对于分页，您必须发送参数为World::isoCodes($request->get('page'))，URL应如下所示：https://:8000/isoCodes?page=3。

8. World::regions();

它返回ISO代码的所有地区名称。

9. World::isoInfoByCountryName('country_name');

其中参数'country_name'是国家名称。您可以通过国家名称搜索ISO信息。如果未提供国家名称或提供的国家名称与参数不匹配，则在两种情况下都将返回空数组。

10. World::isoInfoByCode('country_code');

其中参数'country_code'是国家代码。您可以通过国家代码搜索ISO信息。如果未提供国家代码或提供的国家代码与参数不匹配，则在两种情况下都将返回空数组。

11. World::isoCodesByRegion('region');

其中参数'region'是地区名称。您可以通过地区名称搜索ISO信息。如果未提供地区名称或提供的地区名称与参数不匹配，则在两种情况下都将返回空数组。

12. World::searchIsoCodes('xx');

参数“xx”代表搜索字符串。您可以通过任何搜索字符串搜索ISO信息。如果未提供搜索字符串或提供的搜索字符串与参数不匹配，在这两种情况下都会返回空数组。

13. World::timezones();

返回世界上所有时区信息。

14. World::timezoneRegions();

返回世界上所有时区地区的名称。

15. World::timezonesByRegion('region_name');

返回提供地区的所有时区信息。如果提供的地区名称不匹配或地区名称为空，在这种情况下将返回空数组。

16. World::searchTimezone('xx');

您可以通过国家名称或时区名称搜索时区。参数“xx”代表搜索字符串。您可以通过任何搜索字符串搜索时区。如果未提供搜索字符串或提供的搜索字符串与参数不匹配，在这两种情况下都会返回空数组。

17. World::currencies();

返回世界上几乎所有货币的名称及其信息，例如国家名称、国家代码、货币代码和货币符号。

18. World::searchCurrency('xx');

您可以通过国家名称或货币名称搜索货币。参数“xx”代表搜索字符串。您可以通过任何搜索字符串搜索货币。如果未提供搜索字符串或提供的搜索字符串与参数不匹配，在这两种情况下都会返回空数组。

19. World::currencyByCountryName('country_name');

您可以通过国家名称搜索货币。如果提供的国家名称参数为空或与数据库文件中的任何值不匹配，在这种情况下将返回空数组。

20. World::currencyByCountryCode('country_code');

您可以通过国家代码搜索货币。如果提供的国家代码参数为空或与数据库中的任何值不匹配，在这种情况下将返回空数组作为响应。

21. World::currencyByCurrencyName('currency_name');

您可以通过货币名称搜索货币。如果提供的货币名称参数为空或与数据库文件中的任何值不匹配，在这种情况下将返回空数组。

22. World::currencyByCountryCode('currency_code');

您可以通过货币代码搜索货币。如果提供的货币代码参数为空或与数据库中的任何值不匹配，在这种情况下将返回空数组作为响应。

23. World::stdCodes();

返回所有国家的 STD 代码。

24. World::searchStdCodes('xx');

您可以通过搜索字符串搜索 STD 代码。如果提供的搜索字符串参数为空或与数据库中的任何值不匹配，在这种情况下将返回空数组作为响应。

25. World::stdCodeByCountryName('country_name');

您可以通过国家名称搜索 STD 代码。如果提供的国家名称参数为空或与数据库中的任何值不匹配，在这种情况下将返回空数组作为响应。

26. World::stdCodeByCountryCode('country_code');

您可以通过国家代码搜索 STD 代码。如果提供的国家代码参数为空或与数据库中的任何值不匹配，在这种情况下将返回空数组作为响应。

27. World::states();

返回所有州及其所在国家的名称。您还可以获取州的分页结果。如果您想要州的分页，请在config/world.php配置文件中将'states'选项设置为TRUE。您还可以设置每页显示的记录数。只需查看config/world.php文件中的可用配置选项。

当您使用分页时，您必须从请求URL中给出页码。例如：您正在调用states如World::states()。对于分页，您必须发送参数World::states($request->get('page'))，并且URL应该是这样的：https://:8000/states?page=3。

28. World::searchStates('search_key');

您可以通过任何搜索字符串搜索州。如果提供的搜索键参数为空或与数据库中的任何值不匹配，将返回空数组作为响应。

29. World::countriesForStates('country_code');

此功能返回所有国家名称，如果您想根据国家搜索州。

30. World::getStatesByCountry('country_name');

您可以通过国家名称搜索州。如果提供的参数国家名称为null，或者与数据库中的任何值不匹配，则返回空数组作为响应。

31. World::cities();

它返回所有城市名称以及它们所属的州和国家。您还可以获取城市的分页结果。如果您想要城市的分页，只需在config/world.php配置文件中将'cities'选项设置为TRUE。您还可以设置每页显示的记录数。只需查看config/world.php文件中的配置选项。

当您使用分页时，您必须在请求URL中提供页码。例如：您正在调用cities如World::cities()。对于分页，您必须发送参数为World::cities($request->get('page'))，URL应为如https://:8000/cities?page=3。

对于分页：URL必须类似于https://:8000/cities?page=3，调用cities()函数必须为"return World::cities($request->get('page'));"。否则，分页可能无法正常工作。

32. World::searchCities('search_key');

您可以通过任何搜索字符串搜索城市。如果提供的搜索键参数为null，或者与数据库中的任何值不匹配，则返回空数组作为响应。

33. World::statesForCities();

如果您想根据州搜索城市，它将返回所有州名称。

34. World::countriesForCities();

如果您想根据国家搜索城市，它将返回所有国家名称。

35. World::getCitiesByStateName('state_name');

您可以通过州搜索城市。如果提供的州名称参数为null，或者与数据库中的任何值不匹配，则返回空数组作为响应。

36. World::getCitiesByCountryName('country_name');

您可以通过国家搜索城市。如果提供的国家名称参数为null，或者与数据库中的任何值不匹配，则返回空数组作为响应。

somehelper / my-world

维护者

详细信息

README

安装

使用方法