【自分用メモ】Laravel …
【自分用メモ】Laravel 7.30.4 新規開発時の準備でいつもやってることメモ
どんな記事?
何度かLaravelでシステムを開発する機会があったのに慣れない事ばかりで毎回苦戦していたので速攻準備出来るようにメモを残しておく。
目的
Laravel開発の時に何度も環境が変わることが想定されるのでその都度準備を素早く出来るようにこの記事を書きます。 また、何もわからない初心者でもなんとなく動くような設計にする予定です。 全然わかんねえよって人はコメントください。
下準備
Laravelのインストール
https://getcomposer.org/ Composerがインストールされていることが前提です。 インストール方法はWindowsの場合はダウンロードしてインストールするだけです。 Linux系の人の場合は https://bistro.site/post-2439/#toc_id_2 こっちに書きましたのでよろしくお願いします。
Composerが手に入ったら プロジェクトのディレクトリを作成したいディレクトリに移動して
composer create-project --prefer-dist laravel/laravel blog
通常このようにしてインストールします。 後は待っているだけでディレクトリが出来ます。
インストールが成功したら
php artisan serve
でローカルサーバーを立ち上げます。
通常
[code]
Laravel development server started: http://127.0.0.1:8000
[/code]
のような表示が出て
http://127.0.0.1:8000/
にアクセスすると
各種設定
データベースの作成
Windowsの方でXAMMP使ってる方・Linux系の方は http://localhost/phpmyadmin/ にアクセスします。 Linuxの方はLAMP環境とか整えてください。 わからない方は↓こちら https://bistro.site/post-2435/ データベースを作成したら.envの設定に移ります。
この記事では"bistrodb"という名前のデータベースを作成したことにします。
日本語と時間の指定
先に日本で使う場合の設定をしておきます。config/app.phpを編集します。
'timezone' => 'Asia/Tokyo', 'locale' => 'ja',
.envの設定
.envというファイルがプロジェクトのルートディレクトリにあるかと思います。
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=データベース名を入力します。 DB_USERNAME=データベースのユーザー名を入力します DB_PASSWORD=データベースのユーザーのパスワードをここに入力します
つまり
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=bistrodb DB_USERNAME=bistro DB_PASSWORD=bistropassword
こんな感じになります。
その後おまじないをかけておきます。 Laravel では .env ファイルに環境設定を等を記述し、 PHPから利用することになります。 キャッシュに .env の内容を保持しているため.envを書き換えてもPHP側に反映されない場合があるので キャッシュを削除するためのコマンドをプロジェクト内のルートディレクトリでターミナルを開き
php artisan config:cache
をしておくと確実です。
データベースに接続する場合
基本時にターミナルでDB弄らないんですよねえって方は読み飛ばしです。
php artisan tinker
で接続できます。 ここまでの手順でこの辺でエラーが出ることは特殊な環境でない限りあまりないと思います。 ここでエラーが出る場合おそらく.envがちゃんと設定されていない。
もうダメだ.env設定ちゃんとしてるのに全然動かねえわって方は プロジェクト内のルートディレクトリで
composer install
を行ってください。何故か動くことがほとんどです。 これについてはまだ知識が無い為、試してみて毎回ちゃんと動いたって経験談です。
DBのマイグレーション準備
まずマイグレーションってなんだよって話ですが、
マイグレーションとはデータベースのバージョンコントロールのような機能です。 アプリケーションデータベースのスキーマの更新をチームで簡単に共有できるようにしてくれます。 マイグレーションは基本的にLaravelのスキーマビルダとペアで使い、アプリケーションのデータベーススキーマの作成を楽にしてくれます。
何言ってるかわかりませんね。
要するに
- 複数人で開発する際、コマンドひとつでDBの設定をみんな同じ状態にできる
- DBのカラム変更等を手動ですると本来は残らない設定変更の履歴が、コードで残る
というメリットが有るため、DBの構造をコードで管理する、という方法です。
初めてデータベースを構築する場合や、 データベース構造を変更したくなった時にマイグレーションファイルを記述します。 マイグレーションファイルにはデータベースの構造を記述します。 データベースの構造を変更する場合もをどうやって変更するかを記述します。 これを利用することで数カ月後忘れている状態で見たときやチームで作る時に混乱を防ぐ事が出来ます。
絶対にマイグレーションファイルを使わなくてはいけないわけではないですが、 使うと便利です。面倒ですが勉強しましょう。 絶対に使わないという強い意志を持った方は読み飛ばし。
app/Providers/AppServiceProvider.phpに下のような部分があるので書き直します。
public function boot() { // }
↓
public function boot() { \Schema::defaultStringLength(191); }
理由
文字列の最大文字数を191文字にしておかないとマイグレーション時にエラーになるようです。
DBのマイグレーション
マイグレーションファイルは /database/migrations/ に予め準備されています。 中を覗いてみると
use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; class CreateUsersTable extends Migration { /** * Run the migrations. * * @return void */ public function up() { Schema::create('users', function (Blueprint $table) { $table->id(); $table->string('name'); $table->string('email')->unique(); $table->timestamp('email_verified_at')->nullable(); $table->string('password'); $table->rememberToken(); $table->timestamps(); }); } /** * Reverse the migrations. * * @return void */ public function down() { Schema::dropIfExists('users'); } }
のようなものが入っています。
これはusersというテーブルを作ってid,name.email,email_verified_at,password,remember_token,created_at,updated_atというカラムを作りますよー
という記述です。
なんとなく読んで見ればわかると思いますので割愛します。
早速マイグレーションしてみましょう。テーブルが出来るはずです。
php artisan migrate
データを作成する場合
Usersテーブルが出来たのでこの中にサンプルユーザーを作りたい場合もあると思います。 作りたくないよって人は読み飛ばし。
Seederの準備
Seederはその名の通り種ですね。
php artisan make:seeder UserSeeder
これでSeederが準備できます。 /database/seeds/ に UserSeeder.phpが生成されたと思います。 中身はこんな感じ
use Illuminate\Database\Seeder; class UserSeeder extends Seeder { /** * Run the database seeds. * * @return void */ public function run() { // } }
これを書き換えます。
use Illuminate\Database\Seeder; class UserSeeder extends Seeder { /** * Run the database seeds. * * @return void */ public function run() { DB::table('users')->insert([ 'name' => 'test', 'email' => 'test@test.test', 'password' => bcrypt('test') ]); } }
名前 : test email : test@test.test パスワード : test
で作成します。 パスワードはハッシュ化されますのでデータベースにはハッシュ化された文字列が入ります。
また、同ディレクトリ内に DatabaseSeeder.php というものがあると思います。 中身は
use Illuminate\Database\Seeder; class DatabaseSeeder extends Seeder { /** * Seed the application's database. * * @return void */ public function run() { // $this->call(UserSeeder::class); } }
となっていますので書き換え。
use Illuminate\Database\Seeder; class DatabaseSeeder extends Seeder { /** * Seed the application's database. * * @return void */ public function run() { $this->call(UserSeeder::class); } }
$this->call(UserSeeder::class);のコメントアウトを外します。 これで準備完了です。
サンプルデータを入れる
php artisan db:seed --class=UserSeeder
Usersテーブルにデータが入ってのが確認出来たら成功です。 ここまで準備できたら開発に取りかかれます。
データベースの操作
マイグレーションファイルの追加
データベースを操作するのにマイグレーションファイルを使うとスムーズ、というか記録が残ることで沢山のメリットがあることがわかりました。 Git管理する場合も楽だしね。
ユーザーに権限を付与することはよくあるパターンなのでここではその作業をメモしたいと思います。
マイグレーションファイルを追加するには
Usersテーブルに権限(ロールと呼びます)を追加するので、ターミナルから
php artisan make:migration add_column_role_users_table --table=users
とします。
/database/migrations/ に 2021_08_19_094806_add_column_role_users_table.php のようなファイルが追加されます。 ここに追加分を記述していきます。 中身は
use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; class AddColumnRoleUsersTable extends Migration { /** * Run the migrations. * * @return void */ public function up() { Schema::table('users', function (Blueprint $table) { // }); } /** * Reverse the migrations. * * @return void */ public function down() { Schema::table('users', function (Blueprint $table) { // }); } }
のようになっているので
use Illuminate\Database\Migrations\Migration; use Illuminate\Database\Schema\Blueprint; use Illuminate\Support\Facades\Schema; class AddColumnRoleUsersTable extends Migration { /** * Run the migrations. * * @return void */ public function up() { Schema::table('users', function (Blueprint $table) { $table->tinyInteger('role')->default(0)->after('password')->index('index_role')->comment('ロール'); }); } /** * Reverse the migrations. * * @return void */ public function down() { Schema::table('users', function (Blueprint $table) { $table->dropColumn('role'); }); } }
のように追記します。
up()とdown()両方に追記されています。 upメソッドは マイグレート(php artisan migrate)の時の処理、 downメソッドは ロールバック(php artisan migrate:rollback)の時の処理です。
up()に記述したのは意味は”カラム名「role」をTINYINT型でpasswordカラムの後に追加してインデックスを付与する。”です。
実際に追加してみる
ルートディレクトリをターミナルで開いたら
php artisan migrate
とします。
$ php artisan migrate Migrating: 2021_08_19_094806_add_column_role_users_table Migrated: 2021_08_19_094806_add_column_role_users_table (0.03 seconds)
権限(ロール)の設定
下準備
下準備せずにロールを設定しようとすると
RuntimeException In order to use the Auth::routes() method, please install the laravel/ui package.
というエラーが出ると思うので まずはlaravel/ui packageをインストールします。
これはLaravelの認証機能uiです。
composer require laravel/ui
Package manifest generated successfully. と表示されたらOKです。
Package phpunit/php-token-stream is abandoned, you should avoid using it. No replacement was suggested.
と出る場合はPHPUnit9に更新する必要があります。 今回はちょっと無視します。
vueの追加
php artisan ui vue --auth
Vue scaffolding installed successfully. と表示されたらOKです。
npmのインストール
npmから不足するパッケージをインストールします。
npm install
npm run dev
これで下準備は整いました。
ロールの追加
/App/Providers/AuthServiceProvider.php を開きます。 中身は、
namespace App\Providers; use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider; use Illuminate\Support\Facades\Gate; class AuthServiceProvider extends ServiceProvider { /** * The policy mappings for the application. * * @var array */ protected $policies = [ // 'App\Model' => 'App\Policies\ModelPolicy', ]; /** * Register any authentication / authorization services. * * @return void */ public function boot() { $this->registerPolicies(); // } }
となっています。 'App\Model’ => 'App\Policies\ModelPolicy’, のコメントアウトを外します。 また、
namespace App\Providers; use Illuminate\Foundation\Support\Providers\AuthServiceProvider as ServiceProvider; use Illuminate\Support\Facades\Gate; class AuthServiceProvider extends ServiceProvider { /** * The policy mappings for the application. * * @var array */ protected $policies = [ 'App\Model' => 'App\Policies\ModelPolicy', ]; /** * Register any authentication / authorization services. * * @return void */ public function boot() { $this->registerPolicies(); // 開発者のみ許可 Gate::define('system-only', function ($user) { return ($user->role == 1); }); // 管理者以上(管理者&システム管理者)に許可 Gate::define('admin-higher', function ($user) { return ($user->role > 0 && $user->role <= 5); }); // 一般ユーザ以上(全ロール)に許可 Gate::define('user-higher', function ($user) { return ($user->role > 0 && $user->role <= 10); }); } }
のように追記します。
403エラーページの作成
ロール制限がかかった場合403エラーページに遷移します。
このページはまだ作成されていませんので追加しておきます。 /resources/views/errors/403.blade.php を手動で作成します。 中身を
403 Forbidden 403 Forbidden
You do not have access.
のようにしておけば問題無いかと思います。
権限で表示/非表示を設定する
@can('system-only') {{-- ここはシステム管理者権限のみに表示されます --}} @elsecan('admin-higher') {{-- ここは管理者権限以上に表示されます --}} @elsecan('user-higher') {{-- ここは全権限に表示されます --}} @endcan
のように切り分けが可能になりました。
bladeに書き込んで動作テスト
welcome.blade.phpに
@can('system-only') システム管理者でログインしています。 @elsecan('admin-higher') 管理者でログインしています。 @elsecan('user-higher') 一般ユーザーでログインしています。 @endcan
等、記述して動作確認を行います。 データベースの「role」の数値を色々変えて試してみましょう。
Controllerの作成
コントローラーを作成するにはルートディレクトリでターミナルから
php artisan make:controller AdminController
のようにコマンドを打ちます。 Controller created successfully. と表示されれば成功です。
/app/Http/Controllers に、AdminController.phpが生成されたはずです。 中身は、
namespace App\Http\Controllers; use Illuminate\Http\Request; class AdminController extends Controller { // }
のようになっています。
namespace App\Http\Controllers; use Illuminate\Http\Request; class AdminController extends Controller { public function index() { return view('admin.index'); } }
のように変更するとhttp://127.0.0.1:8000/admin/で表示するための準備ができます。
Viewの作成
/resources/views/admin/index.blade.php を手動で作成します。
@extends('layouts/app') @section('title','管理者:') @section('content')管理者ページ
ここは管理者ページです
@endsection
のようにします。
Routeの作成
/routes/web.php を開きます。
use App\Http\Controllers\AdminController; Route::get('admin/', 'AdminController@index');
のように記述します。
※追記 Laravel8以上だと上のコードは動きません。Target class [AdminController] does not exist.になります。
Laravel8 は "class@method" の文字列形式を受け入れなくなりました。
use Illuminate\Support\Facades\Route; use App\Http\Controllers\AdminController; /* |-------------------------------------------------------------------------- | Web Routes |-------------------------------------------------------------------------- | | Here is where you can register web routes for your application. These | routes are loaded by the RouteServiceProvider within a group which | contains the "web" middleware group. Now create something great! | */ Route::get('/', function () { return view('welcome'); }); Route::get('admin/', [AdminController::class,'index']);
のようにする必要があります。 RouteServiceProvider.phpファイルからデフォルトの名前空間を削除されたようです。
あと、@extends('layouts/app')でlayoutを読み込んでいますが、 存在しないので読み込めなくなっていました。
ここまで準備ができたら http://127.0.0.1:8000/admin/ で表示できます。
続きはLaravel8の記事で。
ディスカッション
コメント一覧
まだ、コメントがありません