PHPackages                             cuongnd88/jutility - 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. [Utility & Helpers](/categories/utility)
4. /
5. cuongnd88/jutility

ActiveLibrary[Utility & Helpers](/categories/utility)

cuongnd88/jutility
==================

Laravel Japanese Utility

1.4(4y ago)41861MITPHP

Since Jun 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/cuongnd88/jutility)[ Packagist](https://packagist.org/packages/cuongnd88/jutility)[ RSS](/packages/cuongnd88-jutility/feed)WikiDiscussions master Synced 6d ago

READMEChangelog (9)DependenciesVersions (10)Used By (0)

Laravel Japanese Utility
========================

[](#laravel-japanese-utility)

This package provides a convenient way to retrieve Japanese Utility such as Japanese Postal Code, Japanese Localization, CSV

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

[](#installation)

1-Install `cuongnd88/jutility` using Composer.

```
$ composer require cuongnd88/jutility
```

2-You can modify the configuration by copying it to your local config directory:

```
php artisan vendor:publish --provider="Cuongnd88\Jutility\JutilityServiceProvider"
```

You select the utility by adding `--tag` option:

```
php artisan vendor:publish --provider="Cuongnd88\Jutility\JutilityServiceProvider" --tag=public
```

There are 3 options:

*`--tag=public` is to publish the JPostal Utility via javascript.*

*`--tag=config` is to publish the JPostal Utility via php/laravel.*

*`--tag=lang` is to publish the Japanese Localization Utility.*

Sample Usage
------------

[](#sample-usage)

### JPostal Utility via Javascript

[](#jpostal-utility-via-javascript)

With the JPostal utility, you can achieve Japanese postal data by postal code. You just need implementing like below

`resources/views/user/jpostal.blade.php`

```
. . . .

        {{ __('Post code') }}

        {{ __('Info') }}

. . . .

    JPostal.init();

```

`JPostal.capture(zip, response)`:

*`zip` : is a string value that you can assign a value contains id or class sign in identifing zip code. For example: `.zip` or `#zip`.*

*`response` is a array or function that you get the data (prefecture, city, area and street). If the array only has one item, it resturns data with comma sign. The array has 4 elements, so it returns seperated data corresponding to prefecture, city, area and street. If the resposne is a function, it will callback .*

*`MEMO` you can use id and class signs for zip and response parameters. You can enter both postal code formats (NNN-NNNN or NNNNNNN).*

```

```

```

    JPostal.init();

    $( "#zip" ).keyup(function() {
        JPostal.capture('#zip', function(data){
            console.log(data);
        });
    });

```

The JPostal provides functions to select a city correspond to a prefecture

*`JPostal.innerPrefecturesHtml(callback)` .*

*`JPostal.nnerCityHtmlByPref(prefTag, callback)` .*

```
. . . .

        {{ __('Prefecture') }}

        {{ __('City') }}

. . . .

    JPostal.init();

    JPostal.innerPrefecturesHtml(function(prefectures){
        let selectTag = 'Prefecture';
        for (const [key, value] of Object.entries(prefectures)) {
            selectTag += `${value}`;
        }
        $('#selectPrefecture').append(selectTag);
    });

    $("#selectPrefecture").change(function(){
        JPostal.innerCityHtmlByPref('#selectPrefecture', function(cities){
            let selectTag = 'City';
            for (const item in cities) {
                const {id, name} = cities[item];
                selectTag += `${name}`;
            }
            $('#selectCity').append(selectTag);
        });
    });

```

### JPostal Utility via PHP/Laravel

[](#jpostal-utility-via-phplaravel)

There are several functions to assist you get Japanese postal code:

*`jpostal_pref($code = null)`: Get Japanese prefectures by code .*

```
dump(jpostal_pref(47));
```

*`jpostal_pref_city($prefCode, $city = null)`: Get Japanese city by prefecture code .*

```
dump(jpostal_pref_city(47));
dump(jpostal_pref_city(1, '01101));
```

*`jpostal_code($code)`: Get Japanese postal data by code .*

```
    dump(jpostal_code('1200000'));
    dump(jpostal_code('120-0000'));
```

*`jlang($key)`: Use translation strings as keys are stored as JSON files in the resources/lang/{$currentLocale}/ directory .*

```
    dump(jlang('Add Team Member'));
```

### Japanese Localization Utility

[](#japanese-localization-utility)

The `cuongnd88/jutility` package provides a convenient way to retrieve strings in Japanese languages. The default language for your application is stored in the `config/app.php` configuration file. You may modify this value to suit the needs of your application.

```
. . . .
    'locale' => 'ja',
. . . .
```

Language strings are stored in files within the resources/lang directory.

```
/resources
    /lang
        /en
            messages.php
        /ja
            messages.php
```

### CSV

[](#csv)

The CSV utility support to read, validate and get the CSV file. You have to set the valitor in `config/csv.php`. Please refer to the defaut:

```
return [
    /*
    |--------------------------------------------------------------------------
    | UTF-8 Bom
    |--------------------------------------------------------------------------
    |
    | The UTF-8 BOM is a sequence of bytes at the start of a text stream (0xEF, 0xBB, 0xBF)
    | that allows the reader to more reliably guess a file as being encoded in UTF-8.
    | Suitable for exporting Japanese data
    |
    */
    'utf-8-bom' => false,

    /*
    |--------------------------------------------------------------------------
    | Validator Support
    |--------------------------------------------------------------------------
    |
    | This is a sample defines how to validate CSV data:
    | - `user.header` is to identify the format of CSV file, that compare the standard header to the CSV header.
    | The "Invalid Header" message of Exception is threw if there is an error
    |
    | - `user.validator` is based on Laravel Validator. If you have multiple user tables or models you may configure multiple
    |       + `user.validator.rules`: set the Laravel validation rules
    |       + `user.validator.messages`: customize the Laravel default error messages
    |       + `user.validator.attributes`: customize the validation attributes
    */
    'user' => [
        'header' => [
            'fname' => 'First Name',
            'lname' => 'Last Name',
            'email' => 'Email',
        ],
        'validator' => [
            'rules' => [
                'fname' => 'required',
                'lname' => 'required',
                'email' => 'required|email',
            ],
            'messages' => [],
            'attributes' => [],
        ],
    ],
];
```

The `CSV` is a facade that provides access to an object from the container. You just need to import the `CSV` facade near the top of the file.

```
. . . .
use Cuongnd88\Jutility\Facades\CSV;

class UserController extends Controller
{
    . . . .
    public function postCSV(Request $request)
    {
        $csv = CSV::read(
                    $request->csv,
                    config('csv.user.header'),
                    config('csv.user.validator')
                )->filter();
        dump($csv);
    }
}
. . . .
```

*`read($file, array $standardHeader = [], $validatorConfig = null)`: read CSV file, return CSV object .*

*`filter()`: filter CSV data, return an array `['validated' => [...], 'error' => [...]]`.*

*`get()`: get CSV data (including validated and error data) except CSV header line, return an array.*

*`validatorErrors()`: get validated errors, return an array .*

```
    public function postCSV(Request $request)
    {
        $csv = CSV::read(
                    $request->csv,
                    config('csv.user.header'),
                    config('csv.user.validator')
                );
        $data = $csv->get();
        dump($data);
        $errorList = $csv->validatorErrors();
        dump($errorList);
    }
```

*`MEMO`: the CSV returns an array data (or error list), the index array is line number of CSV file.*

*`save(string $fileName, array $data, $header = null)`: export data to CSV file .*

```
    public function downloadCSV()
    {
        $data = User::all()->toArray();
        $header = ['ID','Fullname','Email','Mobile number', 'Email verified data time', 'Created date time', 'Updated date time'];
        CSV::save('user-data', $data, $header);
    }
```

Demo
----

[](#demo)

This is demo soure code.

[JPostal Utility](https://github.com/cuongnd88/lara-colab/blob/master/alpha/resources/views/user/jpostal.blade.php)

[CSV Utility](https://github.com/cuongnd88/lara-colab/blob/master/alpha/app/Http/Controllers/User/UserController.php)

###  Health Score

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity17

Limited adoption so far

Community8

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 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

9

Last Release

1777d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/8dfc050aef777dd165bc3f60e724e4b53471854fcb3b522c103c936bd56e6643?d=identicon)[ngodinhcuong](/maintainers/ngodinhcuong)

---

Top Contributors

[![cuongnd-nta](https://avatars.githubusercontent.com/u/68364059?v=4)](https://github.com/cuongnd-nta "cuongnd-nta (16 commits)")

---

Tags

japan-postjapan-post-codejapan-zip-codejapanese-localizationlaravelmodule-patternphp

### Embed Badge

![Health badge](/badges/cuongnd88-jutility/health.svg)

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

###  Alternatives

[apen/additional_reports

Useful information in the reports module : xclass, ajax, cliKeys, eID, general status of the system (encoding, DB, php vars...), hooks, compare local and TER extension (diff), used content type, used plugins, ExtDirect... It can really help you during migration or new existing project (to have a global reports of the system).

14157.8k](/packages/apen-additional-reports)

PHPackages © 2026

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