每一个开发者都可能遇到过这样的场景：在构建一个电商网站、用户注册系统或是任何需要地理位置信息的应用时，你都需要提供一个让用户选择国家和地区的下拉菜单。起初，你可能会想，这不就是几个数组嘛，手动写进去就好了。但随着业务的扩展，你需要支持更多国家，甚至要精确到州、省、市，手动维护这些列表简直是一场噩梦：
数据量庞大且易错： 全球有近200个国家，每个国家又有几十个甚至上百个州/省，手动录入这些数据不仅耗时耗力，还极易引入拼写错误或遗漏。更新维护困难： 国家名称、行政区划有时会发生变化，手动更新意味着你需要不断地关注这些信息，并修改代码。国际化与标准化： 如何确保国家和地区名称的英文拼写准确无误？如何统一使用 ISO 编码作为后台标识？这些都是手动维护难以解决的挑战。代码冗余与耦合： 如果在多个地方都需要这些数据，你可能会复制粘贴相同的数组，导致代码冗余，难以管理。
composer在线学习地址：学习地址
幸好，Laravel 强大的生态系统总能为我们提供优雅的解决方案。今天，我就要向大家介绍一个能彻底解决这个痛点的 Composer 包——dougsisk/laravel-country-state。
引入 dougsisk/laravel-country-state：告别手动维护的时代
dougsisk/laravel-country-state 是一个专为 Laravel 11.0+ 设计的实用工具，它提供了一个简洁的 API 来获取国家和地区（州/省）的英文名称列表，并支持 ISO 编码。得益于 Composer 强大的包管理能力，安装这个库简直是小菜一碟：
首先，通过 Composer 将其添加到你的 Laravel 项目中：
composer require dougsisk/laravel-country-state安装完成后，如果你使用的是 Laravel 11.0+ 并且开启了包自动发现功能，那么你无需进行任何额外配置。否则，你可能需要在 config/app.php 文件的 providers 数组中手动添加服务提供者：
// config/app.php'providers' => [ // ... DougSiskCountryStateCountryStateServiceProvider::class,],为了更好地控制和定制国家地区数据，你可以发布其配置文件到你的项目中：
php artisan vendor:publish --provider="DougSiskCountryStateCountryStateServiceProvider" --tag="config"这会在 config 目录下生成一个 country-state.php 文件，你可以在其中进行一些配置，例如：
// config/country-state.phpreturn [ // 预加载指定国家的州/省数据，提高性能 'preloadCountryStates' => ['CA', 'MX', 'US'], // 限制只返回指定国家的列表 'limitCountries' => ['CA', 'MX', 'US']];通过 preloadCountryStates，你可以预先加载常用国家的州/省数据，避免每次请求时都去加载所有数据。而 limitCountries 则允许你根据业务需求，只显示部分国家，这对于只服务特定区域的应用来说非常实用。
轻松使用：获取国家与地区列表
dougsisk/laravel-country-state 提供了一个方便的 Facade 接口 CountryState，让你可以轻松访问国家和地区数据。别忘了在你的文件中导入这个 Facade：
表单大师AI
一款基于自然语言处理技术的智能在线表单创建工具，可以帮助用户快速、高效地生成各类专业表单。
74 查看详情
use CountryState;获取所有国家列表：
$countries = CountryState::getCountries();/*$countries 的示例输出（部分）：[ "AD" => "Andorra", "AE" => "United Arab Emirates", "AF" => "Afghanistan", // ... "US" => "United States", // ...]*/getCountries() 方法返回一个关联数组，键是国家的两字母 ISO 编码，值是国家的英文名称。这对于构建 标签的 value 和 text 都非常方便。
获取指定国家的州/省列表：
如果你需要获取某个国家的所有州或省份列表，只需传入该国家的两字母 ISO 编码即可：
$states = CountryState::getStates('US'); // 获取美国的所有州/*$states 的示例输出（部分）：[ "AL" => "Alabama", "AK" => "Alaska", "AZ" => "Arizona", // ... "WY" => "Wyoming"]*/同样，返回的也是一个关联数组，键是州/省的两字母 ISO 编码，值是其英文名称。这使得在表单中实现国家-地区级联选择变得异常简单。
总结与实际应用效果
有了 dougsisk/laravel-country-state，我们再也不用为国家地区的下拉列表而烦恼了。它的优势显而易见：
节省开发时间： 无需手动创建和维护庞大的数据数组，一行代码即可获取所需数据。保证数据准确性： 依赖标准化的 ISO 编码和预定义的英文名称，减少了人为错误。提高代码可维护性： 将国家地区数据管理封装到库中，使你的业务逻辑代码更清晰、更专注于核心功能。无缝集成 Laravel： 作为 Laravel 包，它与框架完美结合，使用 Facade 接口，简单直观。
尽管该库的维护者提到其底层国家/地区数据包可能更新不频繁，但在绝大多数场景下，它依然能提供稳定且足够准确的数据，并且其易用性远超手动维护。对于需要快速构建带有国家地区选择功能的 Laravel 应用来说，dougsisk/laravel-country-state 绝对是一个值得推荐的利器。
下次当你需要处理国家或地区选择器时，不妨尝试一下 dougsisk/laravel-country-state，你会发现开发效率和代码质量都能得到显著提升！
以上就是告别手动维护国家地区列表的烦恼：使用dougsisk/laravel-country-state轻松搞定Laravel表单！的详细内容，更多请关注创想鸟其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/271194.html
微信扫一扫 
支付宝扫一扫 
