# Laravel 빠른 참조 *Artisan, 라우팅, Eloquent, Blade, 미들웨어, 인증* > Source: Laravel Documentation (laravel.com/docs) · MIT ## Artisan ### 주요 명령어 | Command | Description | |---------|-------------| | `php artisan serve` | 개발 서버 시작 | | `php artisan make:model Name -m` | 마이그레이션과 함께 모델 생성 | | `php artisan make:controller NameController` | 컨트롤러 클래스 생성 | | `php artisan make:middleware Name` | 미들웨어 클래스 생성 | | `php artisan migrate` | 대기 중인 마이그레이션 실행 | | `php artisan migrate:rollback` | 마지막 마이그레이션 배치 롤백 | | `php artisan db:seed` | 데이터베이스 시더 실행 | | `php artisan tinker` | 앱을 위한 대화형 REPL | | `php artisan route:list` | 등록된 모든 라우트 목록 | | `php artisan cache:clear` | 애플리케이션 캐시 지우기 | | `php artisan config:clear` | 캐시된 설정 지우기 | | `php artisan queue:work` | 큐에 쌓인 잡 처리 시작 | ## 라우팅 ### 기본 라우트 ``` Route::get('/users', [UserController::class, 'index']); Route::post('/users', [UserController::class, 'store']); Route::put('/users/{id}', [UserController::class, 'update']); Route::delete('/users/{id}', [UserController::class, 'destroy']); ``` ### 라우트 파라미터 및 그룹 ``` Route::get('/user/{id}', function (int $id) { return User::findOrFail($id); }); Route::prefix('api')->middleware('auth')->group(function () { Route::get('/profile', [ProfileController::class, 'show']); }); ``` ### 라우트 기능 | Command | Description | |---------|-------------| | `->name('route.name')` | URL 생성을 위한 이름 있는 라우트 | | `->where('id', '[0-9]+')` | 파라미터에 정규식 제약 | | `Route::resource()` | RESTful 리소스 라우트 (7개) | | `Route::apiResource()` | API 리소스 (create/edit 뷰 없음) | | `Route::fallback()` | 매칭되지 않는 라우트의 catch-all | ## 컨트롤러 ### 리소스 컨트롤러 ``` class PostController extends Controller { public function index() { return view('posts.index', ['posts' => Post::all()]); } public function store(Request $request) { $validated = $request->validate(['title' => 'required|max:255']); Post::create($validated); return redirect()->route('posts.index'); } } ``` ### 리소스 메서드 | Command | Description | |---------|-------------| | `index()` | GET /resource -- 전체 목록 | | `create()` | GET /resource/create -- 폼 표시 | | `store()` | POST /resource -- 새 항목 저장 | | `show($id)` | GET /resource/{id} -- 단일 표시 | | `edit($id)` | GET /resource/{id}/edit -- 편집 폼 | | `update($id)` | PUT /resource/{id} -- 업데이트 | | `destroy($id)` | DELETE /resource/{id} -- 삭제 | ## Blade 템플릿 ### 레이아웃 및 섹션 ``` {{-- layouts/app.blade.php --}} @yield('content') {{-- pages/home.blade.php --}} @extends('layouts.app') @section('content')

Home

@endsection ``` ### 디렉티브 | Command | Description | |---------|-------------| | `{{ $var }}` | HTML 이스케이프 후 출력 | | `{!! $html !!}` | 이스케이프 없이 원본 출력 | | `@if / @elseif / @else` | 조건 블록 | | `@foreach ($items as $item)` | 컬렉션 반복 | | `@forelse / @empty` | 비어있을 때 대체 블록이 있는 반복 | | `@include('partial')` | 다른 Blade 뷰 포함 | | `@component / @slot` | 재사용 가능한 Blade 컴포넌트 | | `@csrf` | CSRF 토큰 히든 필드 | | `@auth / @guest` | 인증 상태 확인 | | `@error('field')` | 유효성 검사 오류 표시 | ## Eloquent ORM ### 모델 기본 ``` class Post extends Model { protected $fillable = ['title', 'body', 'user_id']; public function user() { return $this->belongsTo(User::class); } } ``` ### 쿼리 ``` Post::all(); // all records Post::find(1); // by primary key Post::where('status', 'published')->get(); Post::where('views', '>', 100)->orderBy('created_at', 'desc')->first(); ``` ### CRUD 작업 ``` $post = Post::create(['title' => 'New', 'body' => '...']); $post->update(['title' => 'Updated']); $post->delete(); Post::destroy([1, 2, 3]); // delete by IDs ``` ### 관계 | Command | Description | |---------|-------------| | `hasOne` | 일대일 (User -> Phone) | | `hasMany` | 일대다 (Post -> Comments) | | `belongsTo` | hasOne/hasMany의 역방향 | | `belongsToMany` | 피벗 테이블을 이용한 다대다 | | `hasManyThrough` | 중간 모델을 통한 has-many | ## 마이그레이션 ### 테이블 생성 ``` Schema::create('posts', function (Blueprint $table) { $table->id(); $table->foreignId('user_id')->constrained()->cascadeOnDelete(); $table->string('title'); $table->text('body')->nullable(); $table->timestamps(); }); ``` ### 컬럼 타입 | Command | Description | |---------|-------------| | `$table->id()` | 자동 증가 BIGINT 기본 키 | | `$table->string('col', 100)` | 선택적 길이를 가진 VARCHAR | | `$table->text('col')` | TEXT 컬럼 | | `$table->integer('col')` | INTEGER 컬럼 | | `$table->boolean('col')` | BOOLEAN 컬럼 | | `$table->json('col')` | JSON 컬럼 | | `$table->timestamp('col')` | TIMESTAMP 컬럼 | | `$table->timestamps()` | created_at 및 updated_at | | `$table->softDeletes()` | 소프트 삭제용 deleted_at | ## 미들웨어 ### 커스텀 미들웨어 ``` class EnsureAdmin { public function handle(Request $request, Closure $next) { if (! $request->user()?->is_admin) { abort(403); } return $next($request); } } ``` ### 등록 및 사용 ``` // bootstrap/app.php ->withMiddleware(function (Middleware $middleware) { $middleware->alias(['admin' => EnsureAdmin::class]); }) // In routes Route::get('/admin', fn() => '...')->middleware('admin'); ``` ### 내장 미들웨어 | Command | Description | |---------|-------------| | `auth` | 인증 필요 | | `guest` | 인증된 경우 리다이렉트 | | `throttle:60,1` | 요청 속도 제한 (분당 60회) | | `verified` | 이메일 인증 필요 | | `signed` | 서명된 URL 유효성 검사 | ## 인증 ### Auth 헬퍼 ``` Auth::check(); // is user logged in? Auth::user(); // current User model Auth::id(); // current user ID Auth::attempt(['email' => $e, 'password' => $p]); Auth::logout(); ``` ### 스타터 킷 | Command | Description | |---------|-------------| | `Laravel Breeze` | 최소한의 인증 스캐폴딩 (Blade 또는 Inertia) | | `Laravel Jetstream` | 풀 기능 (팀, 2FA, API 토큰) | | `Sanctum` | SPA / 모바일 API 토큰 인증 | | `Passport` | 완전한 OAuth2 서버 구현 | ### 라우트 보호 ``` Route::middleware('auth')->group(function () { Route::get('/dashboard', [DashController::class, 'index']); }); ``` ## 유효성 검사 ### 컨트롤러 유효성 검사 ``` $validated = $request->validate([ 'title' => 'required|string|max:255', 'email' => 'required|email|unique:users', 'age' => 'nullable|integer|min:0', ]); ``` ### Form Request ``` class StorePostRequest extends FormRequest { public function rules(): array { return [ 'title' => 'required|max:255', 'body' => 'required|min:10', ]; } } ``` ### 주요 규칙 | Command | Description | |---------|-------------| | `required` | 필드가 있고 비어있지 않아야 함 | | `string \| integer \| boolean` | 타입 유효성 검사 | | `min:N \| max:N` | 최소/최대 길이 또는 값 | | `email` | 유효한 이메일 형식 | | `unique:table,column` | DB 테이블에서 고유해야 함 | | `exists:table,column` | DB 테이블에 존재해야 함 | | `in:a,b,c` | 나열된 값 중 하나여야 함 | | `confirmed` | _confirmation 필드와 일치해야 함 | | `date \| after:date` | 날짜 유효성 검사 | ## 주요 패턴 ### API 응답 ``` return response()->json(['data' => $users], 200); return response()->json(['error' => 'Not found'], 404); ``` ### 환경 변수 및 설정 ``` env('APP_KEY'); // read .env value config('app.name'); // read config value config(['app.debug' => true]); // set at runtime ``` ### 유용한 헬퍼 | Command | Description | |---------|-------------| | `route('name', $params)` | 이름 있는 라우트의 URL 생성 | | `redirect()->route('name')` | 이름 있는 라우트로 리다이렉트 | | `back()->withErrors()` | 유효성 오류와 함께 뒤로 리다이렉트 | | `abort(404)` | HTTP 예외 던지기 | | `collect($array)` | 배열로 Collection 생성 | | `now()` | 현재 Carbon 날짜시간 | | `cache()->remember()` | TTL로 값을 캐시 |