PHPackages                             codexwp/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. codexwp/address

ActiveProject

codexwp/address
===============

A simple package for managing address (zip code, prefecture, city, town etc).

1.1.5(2y ago)122MITPHP

Since Jan 18Pushed 2y ago1 watchersCompare

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

READMEChangelog (6)DependenciesVersions (14)Used By (0)

Address API
===========

[](#address-api)

A simple laravel package for managing address like prefecture, city, town and postal code for Japan. And divisions, districts and upazilas for Bangladesh. (jQuery is required for html integration)

### Supported Countries

[](#supported-countries)

1. Japan
2. Bangladesh

Installation
------------

[](#installation)

### 1. Using Composer

[](#1-using-composer)

Run the following commands-

```
composer require "codexwp/address"
php artisan cwp:address_install --country={all/jp/bd}
```

### 2. Using Package

[](#2-using-package)

At first, create a folder like "packages" in your project. Then you can create sub folder like "packages/codexwp/address". Then put "src" folder of this package.

Secondly, update your project composer.json file like the following

```
    "autoload": {
        "psr-4": {
            "Cwp\\Address\\" : "packages/codexwp/address/src"
        }
    },
```

Thirdly, open config/app.php file and add the following lines to the provider section

```
\Cwp\Address\Providers\AddressProvider::class,
```

Finally, discover and install the package.

```
composer dump-autoload
php artisan cwp:address_install --country={all/jp/bd}
```

Available APIs
--------------

[](#available-apis)

```
//Japan
1.  / address_api / jp / {code} / location
2.  / address_api / jp / {code} / location_list
3.  / address_api / jp / prefectures
4.  / address_api / jp / {pref_name} / cities
5.  / address_api / jp / {pref} / {city_name} / towns
6.  / address_api / jp /{pref} / {city} / {town} /code

//Bangladesh
1.  / address_api / bd / divisions
2.  / address_api / bd / {division_name} / districts
3.  / address_api / bd / {division_name} / {district_name} / upazilas
```

Usages
------

[](#usages)

### Library Service

[](#library-service)

You can use the available methods in your laravel project. Just call the class and method from your controller.

JP - "/src/Library/JpAddressService.php"

BD - "/src/Library/BdAddressService.php"

### Html Integration

[](#html-integration)

Auto update select list(cities) after change of another select input (prefecture).

1. Copy and include the "src/resources/js/address.js" file in html page.
2. Check the example code in "example" folder

###  Health Score

23

—

LowBetter than 27% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity49

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 95.8% 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 ~0 days

Total

13

Last Release

846d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/676c10b797d87ead6a3e582e5d11d549020d74078519cc57ae031088bf97f46a?d=identicon)[codexwp](/maintainers/codexwp)

---

Top Contributors

[![saiful-actself](https://avatars.githubusercontent.com/u/152135316?v=4)](https://github.com/saiful-actself "saiful-actself (23 commits)")[![codexwp](https://avatars.githubusercontent.com/u/47324136?v=4)](https://github.com/codexwp "codexwp (1 commits)")

### Embed Badge

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

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

PHPackages © 2026

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