PHPackages                             szwss/china-address - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. szwss/china-address

ActiveLibrary

szwss/china-address
===================

一个关于 Laravel 的 中国行政区: 省份 城市 区县 乡镇 四级联动数据表生成,地址管理.数据来源于权威机构:民政部和国家统计局,keywords:china,province,city,area,town,address

1.0.4(6y ago)287PHP

Since Jun 6Pushed 6y agoCompare

[ Source](https://github.com/szwss/china-address)[ Packagist](https://packagist.org/packages/szwss/china-address)[ RSS](/packages/szwss-china-address/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (0)

中国城市区划
------

[](#中国城市区划)

### 说明

[](#说明)

1. 一个关于 Laravel 的 中国行政区: 省份 城市 区县 乡镇 四级联动数据表生成,数据来源于权威机构:民政部和国家统计局. 民政部、国家统计局： 中华人民共和国民政部-中华人民共和国行政区划代码 中华人民共和国国家统计局-统计用区划和城乡划分代码 中华人民共和国国家统计局-统计用区划代码和城乡划分代码编制规则

### 本项目已更新至：

[](#本项目已更新至)

2018年统计用区划代码和城乡划分代码（截止时间：2018-10-31，发布时间：2019-01-31）

### 使用

[](#使用)

发布migration文件 并填充数据

```
composer require szwss/china-address

```

```
artisan vendor:publish --provider="Szwss\ChinaAddress\ChinaAddressServiceProvider"

```

```
php artisan migrate

php artisan address:seed

```

创建Address model

```
php artisan make:model Address -c

```

Address model 中 使用 AddressTrait

```
namespace App;

use Illuminate\Database\Eloquent\Model;
use Szwss\ChinaAddress\AddressTrait;

class Address extends Model
{
    use AddressTrait;

    public $timestamps = false;

    protected $primaryKey = 'code';

    protected $fillable = ['code', 'name', 'parent_code'];

    public function getRouteKeyName()
    {
        return 'code';
    }

}

```

### trait 方法

[](#trait-方法)

parent() 父级地址

children() 子地址

getFullPath($joiner) 获取完整的地址字符串,$joiner可选参数,地址字符串的拼接符,默认为' '

allChildren() 获取所有的用户,包含各级的children

待完善...

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity12

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity63

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~1 days

Total

5

Last Release

2528d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/a63480f65749892bfa6ead709efea1981a54f334f70fe8dd09a5c80d1bfd40db?d=identicon)[szwss](/maintainers/szwss)

---

Top Contributors

[![szwss](https://avatars.githubusercontent.com/u/584808?v=4)](https://github.com/szwss "szwss (5 commits)")

---

Tags

addresscityprovinceareaChinatown

### Embed Badge

![Health badge](/badges/szwss-china-address/health.svg)

```
[![Health](https://phpackages.com/badges/szwss-china-address/health.svg)](https://phpackages.com/packages/szwss-china-address)
```

###  Alternatives

[salibhdr/typhoon-iran-cities

A laravel package for importing all regions such as provinces, counties, cities, city districts, rural districts and villages of iran into database accurately

6121.0k](/packages/salibhdr-typhoon-iran-cities)[woenel/prpcmblmts

Philippines region, province, cities/municipalities and barangays Laravel migration and table seeder.

2818.3k](/packages/woenel-prpcmblmts)[tomatophp/filament-locations

Database Seeds for Countries / Cities / Areas / Languages / Currancy with ready to use resources for FilamentPHP

2320.8k6](/packages/tomatophp-filament-locations)[nevadskiy/laravel-geonames

Populate your database using the GeoNames service.

2715.1k](/packages/nevadskiy-laravel-geonames)[matriphe/laraciproid

Indonesia city and province data migration and seeder for Laravel.

232.5k](/packages/matriphe-laraciproid)[parsilver/thailand-provinces-php

Thailand address database

121.5k1](/packages/parsilver-thailand-provinces-php)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)