Download the PHP package jp3cki/gimei without Composer
On this page you can find all versions of the php package jp3cki/gimei. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package gimei
Gimei-PHP
gimei-php は日本人の名前や、日本の住所をランダムに返すライブラリ gimei を PHP 用ライブラリにポーティングしたものです。 テストデータの作成時などに使用します。
本家
https://github.com/willnet/gimei
使い方
必須環境
- PHP 8.2 以上
json拡張モジュール
準備
-
まだ設定していなければ Composer を使えるようにします。 具体的な方法は Download Composer を確認してください。
-
現在のあなたのソースコードで Composer を使用していなければ、次のコマンドを実行してください。
あなたのソースコード(プロジェクト)についていくつか質問されますので適当に答えてください。 完了すると
composer.jsonファイルが生成されます。 -
gimei-php を Composer 経由でインストールします。
-
開発時にのみ使用し、本番では使用しない場合
- 本番でも使用する場合
-
- これで利用の準備が整いました。
詳しくは Composer のウェブサイトか、Composer の解説サイトを参照してください。
なお、 Composer 経由でインストールしたライブラリ等を使用する際は、あなたのプログラムの最初の方で vendor/autoload.php を require または include してください。
名前をランダムに返す
男女どちらかの名前を等確率で返します。
下記のように男性/女性の名前を返すことを明示的に指定できます。
また、男女比を明示的に指定できます。(男性の割合を 0.0~1.0 で指定します)
名前のデータは gimei (オリジナル)プロジェクトの names.yml から JSON に変換して利用しています。
住所ランダムに返す
都道府県、区、市、町を組み合わせた住所情報を漢字、ひらがな、カタカナ、ローマ字で取得することができます。
(ほとんどの場合、実在しない住所が生成されます。例えば 東京都 名古屋市中村区 首里末吉町 など)
住所のデータは gimei (オリジナル)プロジェクトの addresses.yml から JSON に変換して利用しています。
CONTRIBUTING
- フォークします
- feature branch を作成します (
git checkout -b my-new-feature) ※master ブランチで作業しないでください。 - 依存関係の準備をします。(
make init) - ソースとテストを変更します。
- テストとコーディングチェックを行います。
make testmake check-style
- commit します (
git commit -m 'Add Feature' -a) - push します (
git push origin my-new-feature) - pull request を作成します。
名前や住所のデータを gimei に追従するには、
third-party/gimei-originalでgit pull origin masterする等して更新を取り込んでください。util/convert-data.phpを実行します。
とすればたぶん大丈夫です。
LICENSE
CHANGE LOG
-
v3.0.0 - 2026-08-10
- 最小要求バージョンを PHP 8.2 に更新
- 名前・住所データを本家 gimei v1.7.0 に更新
- 住所データの自治体変更に追従しました(富谷町→富谷市、浜松市の区再編、篠山市→丹波篠山市、那珂川町→那珂川市)
- ローマ字表記に対応しました(
$gimei->romaji,$addr->romaji等)- 本家に合わせ、名前のローマ字は「名 姓」の順、住所のローマ字は各要素を空白区切りで連結します
- 非互換:
DataUnit(NameUnit/AddressUnit)のコンストラクタが[漢字, かな, カナ, ローマ字]の4要素を要求するようになりました - 依存ライブラリアップデート(PHPUnit 11, PHPStan 2, PHP_CodeSniffer 4)
-
v2.0.1 - 2022-01-15
- 依存ライブラリアップデート
- phpdoc 等の更新
- phpcs, phpstan による検出箇所の更新
-
v2.0.0 - 2019-11-19
- 最小要求バージョンを PHP 7.1 に更新(内容に変更はありません)
-
v1.1.1 - 2015-08-19
- 依存ライブラリアップデート(内容に変更はありません)
-
v1.1.0 - 2015-07-23
Gimei::generateName()に男女比を指定できるようになりました
-
v1.0.3 - 2015-07-23
- 依存ライブラリアップデート(内容に変更はありません)
-
v1.0.2 - 2015-06-19
- 依存ライブラリアップデート(内容に変更はありません)
-
v1.0.1 - 2015-06-17
- 依存ライブラリアップデート(内容に変更はありません)
- v1.0.0 - 2015-06-13
- initial release
備考
- バージョンナンバーは セマンティック バージョニング に従います。
v1.0.0に対してv1.0.1は機能追加等を行わないただのバグ修正であることを示します。このリリースは常に適用が推奨されます。v1.1.0は機能追加を行っていますが既存の API に影響がないことを示します。このリリースは通常は適用が推奨されます。v2.0.0は API の互換性が損なわれたリリースであることを示します。CHANGE LOG を確認してください。
- composer のバージョン指定においては
^または~で安全に指定できます。
All versions of gimei with dependencies
ext-json Version *