Download the PHP package aimanong/region without Composer
On this page you can find all versions of the php package aimanong/region. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package region
Aimanong · 省市区扩展
Aimanong 的官方扩展：中国省市区三级联动字段类型（
->region()）。
⚠️ 先看这条：内置数据只有 5 个省
这个包不包含完整的中国省市区数据。
内置的只有 5 个省（北京 / 上海 / 广东 / 浙江 / 四川，共 37 个节点），
作用是让字段能跑起来、能演示。
生产环境请通过 Region::useData() 注入完整数据集（约 3400 条）。
这组数字是跑出来的，不是估的：
count(Region::tree())= 5，展开全部节点 = 37。 写文档时我第一版写成「3 个省 / 约 16 条」（凭印象数的），差点发出去。为什么不在包里塞完整数据：那会让所有用户都背着一份可能过时的 行政区划表（每年都在变），且包体积翻几倍。 数据由使用方自己掌控版本，更合适。
安装
注册
扩展必须显式登记，框架不会自动发现 —— 加到 config/aimanong.php：
不登记的话
RegionExtension根本不会 boot，FieldType::fieldViewFor('region')会是 null，字段渲染不出来。
用法
三级联动（省 → 市 → 区）。
存进去的是什么
默认存名称路径（如 广东省/深圳市/南山区）。
想要编码路径（如 440000/440300/440305）就加 ->storeCode()：
⚠️ 这里原先写的是「提交的是编码（如
110108），不是名称」—— 是错的。storeCode()当时没有任何消费方：字段类设了 prop，前端视图从不读它， 于是无论加不加->storeCode()，库里存的都是名称路径。 不报错、也从界面上看不出来。 2026-10-16 补 region 门禁时发现并修好，同一天加了RegionPropConsumerTest防止再出现「声明了但没人消费」。另外：编辑器字段的两种路径都认得（按「首段是不是纯数字」判断）， 所以改默认值不会让历史数据打不开。
辅助函数
⚠️
region_name()返回的是从省到区县的完整路径（斜杠分隔）。 只要末级名称的话，得自己explode('/', $name)取最后一段。
数据源 API
⚠️
useData([])之后必须用reset()才能拿回内置数据。 因为tree()是$custom ?? builtin()，而空数组不是null，??不会回落 —— 传了空数组，内置数据就永久消失且无法恢复。 （这个坑是补单测时踩出来的：tearDown里用useData([])复位， 结果第一个用例之后全是空数据。真实场景里「配置读失败 / 缓存为空 / 远程返回[]」都会撞上它，症状是下拉框一个省都没有、且无报错。）
测试
RegionExtension 的注册链路（FieldType 注册、composer.json 里声明的
扩展类存在性）也在单测范围内；视图渲染由 scripts/setup-demo.sh 建的
demo + e2e 覆盖。
环境要求
- PHP ^8.2
aimanong/framework（会一并装上）
许可
Apache License 2.0 —— 允许免费商用，含明文专利授权。
