Laravelをインストールして、「さあ、アプリをつくるぞ～ヾ(≧▽≦)ﾉ」とその前に。。。
実際にアプリを作成するにはデータベース設定やバリデーションのエラー時に表示する文章等、ルーチンワーク的な設定をする機会が多いので、分かりやすくまとめてみたいと思い記事にしました。
Laravelをインストールした際に個人的にやっている設定なので参考までに
composer経由でLaravelをインストールする
composer create-project laravel/laravel=5.5.* --prefer-dist PROJECT_NAME
バージョンの設定は「5.5.*」のところで設定できます。例えば「5.6」の最新版をインストールしたい場合は「5.6.*」という感じで記入してください。
プロジェクトの名前は「PROJECT_NAME」のところで名前を決められます。この名前がそのままインストールされるフォルダの名前になります。
「 .env 」ファイルの設定
インストールしたフォルダを開いて「.env」ファイルを編集しましょう。
「 config/app.php 」ファイルの設定
このファイルは実行環境にあった設定をすることでデータベースを使用できたりエラーメッセージの言語を変更したりできます。
「 config/database.php 」ファイルの設定
ファイル名のとおりデータベースに関する設定をするファイルです。接続するデータベース環境をdatabase.phpに書き込んでいきましょう。
言語ファイルの設置
Laravelドキュメントの日本語翻訳サイト https://readouble.com/laravel/ から、バリデーション等に使用できる言語ファイルをコピーして、指定のフォルダにペーストします。バリデーションでエラーになった際はデフォルトで英文が表示されますが、この言語ファイルと「config/app.php」設定を組み合わせることにより日本語表示が可能になります。
「resources/lang」に「ja」フォルダを新規に作成して以下のファイルを作成してください。
resources/lang/ja/auth.php
<?php
return [
/*
|--------------------------------------------------------------------------
| 認証言語行
|--------------------------------------------------------------------------
|
| 以下の言語行は認証時にユーザーに対し表示する必要のある
| 様々なメッセージです。アプリケーションの必要に合わせ
| 自由にこれらの言語行を変更してください。
|
*/
'failed' => 'ログイン情報が登録されていません。',
'throttle' => 'ログインに続けて失敗しています。:seconds秒後に再度お試しください。',
];
resources/lang/ja/pagination.php
<?php
return [
/*
|--------------------------------------------------------------------------
| ペジネーション言語行
|--------------------------------------------------------------------------
|
| 以下の言語行はペジネーターライブラリーによりシンプルなペジネーション
| リンクを生成するために使用されます。アプリケーションに合うように、
| 自由に変更してください。
|
*/
'previous' => '« 前',
'next' => '次 »',
];
resources/lang/ja/passwords.php
<?php
return [
/*
|--------------------------------------------------------------------------
| パスワードリセット言語行
|--------------------------------------------------------------------------
|
| 以下の言語行は既存のパスワードを無効にしたい場合に、無効なトークンや
| 新しいパスワードが入力された場合のように、パスワードの更新に失敗した
| 理由を示すデフォルトの文言です。
|
*/
'password' => 'パスワードは最低６文字で、確認項目と一致している必要があります。',
'reset' => 'パスワードをリセットしました。',
'sent' => 'パスワードリセットメールを送信しました。',
'token' => 'このパスワードリセットトークンは無効です。',
'user' => "メールアドレスに一致するユーザーは存在していません。",
];
resources/lang/ja/validation.php
<?php
return [
/*
|--------------------------------------------------------------------------
| バリデーション言語行
|--------------------------------------------------------------------------
|
| 以下の言語行はバリデタークラスにより使用されるデフォルトのエラー
| メッセージです。サイズルールのようにいくつかのバリデーションを
| 持っているものもあります。メッセージはご自由に調整してください。
|
*/
'accepted' => ':attributeを承認してください。',
'active_url' => ':attributeが有効なURLではありません。',
'after' => ':attributeには、:dateより後の日付を指定してください。',
'after_or_equal' => ':attributeには、:date以前の日付を指定してください。',
'alpha' => ':attributeはアルファベットのみがご利用できます。',
'alpha_dash' => ':attributeはアルファベットとダッシュ(-)及び下線(_)がご利用できます。',
'alpha_num' => ':attributeはアルファベット数字がご利用できます。',
'array' => ':attributeは配列でなくてはなりません。',
'before' => ':attributeには、:dateより前の日付をご利用ください。',
'before_or_equal' => ':attributeには、:date以前の日付をご利用ください。',
'between' => [
'numeric' => ':attributeは、:minから:maxの間で指定してください。',
'file' => ':attributeは、:min kBから、:max kBの間で指定してください。',
'string' => ':attributeは、:min文字から、:max文字の間で指定してください。',
'array' => ':attributeは、:min個から:max個の間で指定してください。',
],
'boolean' => ':attributeは、trueかfalseを指定してください。',
'confirmed' => ':attributeと、確認フィールドとが、一致していません。',
'date' => ':attributeには有効な日付を指定してください。',
'date_format' => ':attributeは:format形式で指定してください。',
'different' => ':attributeと:otherには、異なった内容を指定してください。',
'digits' => ':attributeは:digits桁で指定してください。',
'digits_between' => ':attributeは:min桁から:max桁の間で指定してください。',
'dimensions' => ':attributeの図形サイズが正しくありません。',
'distinct' => ':attributeには異なった値を指定してください。',
'email' => ':attributeには、有効なメールアドレスを指定してください。',
'exists' => '選択された:attributeは正しくありません。',
'file' => ':attributeにはファイルを指定してください。',
'filled' => ':attributeに値を指定してください。',
'gt' => [
'numeric' => ':attributeには、:valueより大きな値を指定してください。',
'file' => ':attributeには、:value kBより大きなファイルを指定してください。',
'string' => ':attributeは、:value文字より長く指定してください。',
'array' => ':attributeには、:value個より多くのアイテムを指定してください。',
],
'gte' => [
'numeric' => ':attributeには、:value以上の値を指定してください。',
'file' => ':attributeには、:value kB以上のファイルを指定してください。',
'string' => ':attributeは、:value文字以上で指定してください。',
'array' => ':attributeには、:value個以上のアイテムを指定してください。',
],
'image' => ':attributeには画像ファイルを指定してください。',
'in' => '選択された:attributeは正しくありません。',
'in_array' => ':attributeには:otherの値を指定してください。',
'integer' => ':attributeは整数で指定してください。',
'ip' => ':attributeには、有効なIPアドレスを指定してください。',
'ipv4' => ':attributeには、有効なIPv4アドレスを指定してください。',
'ipv6' => ':attributeには、有効なIPv6アドレスを指定してください。',
'json' => ':attributeには、有効なJSON文字列を指定してください。',
'lt' => [
'numeric' => ':attributeには、:valueより小さな値を指定してください。',
'file' => ':attributeには、:value kBより小さなファイルを指定してください。',
'string' => ':attributeは、:value文字より短く指定してください。',
'array' => ':attributeには、:value個より少ないアイテムを指定してください。',
],
'lte' => [
'numeric' => ':attributeには、:value以下の値を指定してください。',
'file' => ':attributeには、:value kB以下のファイルを指定してください。',
'string' => ':attributeは、:value文字以下で指定してください。',
'array' => ':attributeには、:value個以下のアイテムを指定してください。',
],
'max' => [
'numeric' => ':attributeには、:max以下の数字を指定してください。',
'file' => ':attributeには、:max kB以下のファイルを指定してください。',
'string' => ':attributeは、:max文字以下で指定してください。',
'array' => ':attributeは:max個以下指定してください。',
],
'mimes' => ':attributeには:valuesタイプのファイルを指定してください。',
'mimetypes' => ':attributeには:valuesタイプのファイルを指定してください。',
'min' => [
'numeric' => ':attributeには、:min以上の数字を指定してください。',
'file' => ':attributeには、:min kB以上のファイルを指定してください。',
'string' => ':attributeは、:min文字以上で指定してください。',
'array' => ':attributeは:min個以上指定してください。',
],
'not_in' => '選択された:attributeは正しくありません。',
'not_regex' => ':attributeの形式が正しくありません。',
'numeric' => ':attributeには、数字を指定してください。',
'present' => ':attributeが存在していません。',
'regex' => ':attributeに正しい形式を指定してください。',
'required' => ':attributeは必ず指定してください。',
'required_if' => ':otherが:valueの場合、:attributeも指定してください。',
'required_unless' => ':otherが:valuesでない場合、:attributeを指定してください。',
'required_with' => ':valuesを指定する場合は、:attributeも指定してください。',
'required_with_all' => ':valuesを指定する場合は、:attributeも指定してください。',
'required_without' => ':valuesを指定しない場合は、:attributeを指定してください。',
'required_without_all' => ':valuesのどれも指定しない場合は、:attributeを指定してください。',
'same' => ':attributeと:otherには同じ値を指定してください。',
'size' => [
'numeric' => ':attributeは:sizeを指定してください。',
'file' => ':attributeのファイルは、:sizeキロバイトでなくてはなりません。',
'string' => ':attributeは:size文字で指定してください。',
'array' => ':attributeは:size個指定してください。',
],
'string' => ':attributeは文字列を指定してください。',
'timezone' => ':attributeには、有効なゾーンを指定してください。',
'unique' => ':attributeの値は既に存在しています。',
'uploaded' => ':attributeのアップロードに失敗しました。',
'url' => ':attributeに正しい形式を指定してください。',
/*
|--------------------------------------------------------------------------
| Custom バリデーション言語行
|--------------------------------------------------------------------------
|
| "属性.ルール"の規約でキーを指定することでカスタムバリデーション
| メッセージを定義できます。指定した属性ルールに対する特定の
| カスタム言語行を手早く指定できます。
|
*/
'custom' => [
'属性名' => [
'ルール名' => 'カスタムメッセージ',
],
],
/*
|--------------------------------------------------------------------------
| カスタムバリデーション属性名
|--------------------------------------------------------------------------
|
| 以下の言語行は、例えば"email"の代わりに「メールアドレス」のように、
| 読み手にフレンドリーな表現でプレースホルダーを置き換えるために指定する
| 言語行です。これはメッセージをよりきれいに表示するために役に立ちます。
|
*/
'attributes' => [],
];