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 7.1 以上
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 test
make 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
-
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 *