5를 위한 Laravel 모범 사례, 팁 및 요령-PHP 튜토리얼-php.cn

Laravel Best Practices, Tips, and Tricks for 5

2025년이 다가옴에 따라 Laravel은 개발자에게 강력하고 효율적인 애플리케이션을 만들 수 있는 도구를 제공하면서 계속해서 웹 개발을 위한 최고의 선택이 되고 있습니다. 이 문서에서는 Laravel 9, 10 또는 11을 사용하는지 여부에 관계없이 코드 품질을 향상하고 작업 흐름을 간소화할 수 있는 주요 모범 사례, 팁 및 요령에 대해 설명합니다. 이러한 통찰력은 Laravel을 최대한 활용하고 개발 기술을 향상시키는 데 도움이 됩니다. , 초보자든 숙련된 개발자든 상관없습니다.

Laravel 및 패키지를 최신 상태로 유지

Laravel을 최신 상태로 유지하면 다음과 같은 몇 가지 주요 이점이 있습니다.

향상된 보안: 정기 릴리스에는 애플리케이션을 보호하는 중요한 보안 수정 사항이 포함되어 있습니다.
향상된 성능: 업데이트를 통해 종종 성능이 향상되어 로드 시간이 빨라지고 코드 효율성이 향상됩니다.
새로운 특징 및 기능: 최신 상태를 유지하여 개발 경험을 향상시키는 새로운 기능을 활용하세요.
호환성: 최신 공식 및 커뮤니티 패키지와 더 나은 호환성을 보장합니다.

패키지를 최신 상태로 유지하려면 정기적으로 작곡가 업데이트를 실행하는 것이 중요합니다. 이 간단한 방법은 패키지를 최신 기능과 보안 패치로 최신 상태로 유지하는 가장 좋은 방법 중 하나입니다.

업데이트를 주저한다면 코드가 충분히 테스트되지 않았다는 의미일 수 있습니다. 테스트 방식을 채택하면 주요 업데이트로 인해 코드가 손상되지 않고 Laravel의 개선 사항을 최대한 활용할 수 있습니다.

수동으로 업데이트하지 않으려면 이미 PHP 8.4 베타 버전이 통합된 환경 관리 도구인 ServBay를 사용하여 Laravel 및 다양한 패키지를 더 쉽게 업데이트할 수 있습니다.

강력한 테스트를 유지하여 심각한 오류를 예방하세요

자동화된 테스트는 광범위하지만 종종 과소평가되는 영역입니다. 그러나 이는 프로젝트 신뢰성을 보장하기 위한 가장 중요한 모범 사례 중 하나입니다.

강력한 테스트 스위트를 유지함으로써 얻을 수 있는 주요 이점은 다음과 같습니다.

버그 감소: 정기적인 테스트를 통해 문제를 조기에 발견하여 보다 안정적인 코드베이스를 얻을 수 있습니다.
더 행복한 고객: 신뢰할 수 있는 소프트웨어는 귀하의 제품을 신뢰할 수 있는 만족스러운 사용자를 낳습니다.
만족한 고용주: 잘 테스트된 프로젝트는 전문성과 품질에 대한 의지를 반영합니다.
자신감 있는 개발자: 포괄적인 테스트 모음을 사용하면 새로운 오류 발생에 대한 걱정 없이 변경할 수 있습니다. 휴식 후 프로젝트에 복귀하는 것이 덜 부담스러워집니다.

코드를 수정할 때 php artisan 테스트를 실행하여 손상된 기능을 식별하고 문제를 수정한 후 프로세스를 반복하세요!

자동화된 테스트는 프로젝트 안정성을 크게 향상시켜 경력을 크게 향상시킬 수 있습니다.

시작하는 데 도움이 되도록 Laracasts는 무료 테스트 과정을 제공합니다. PHPUnit(업계 표준) 및 Pest(PHP 테스트를 단순화하는 최신 테스트 프레임워크)에 대해 알아볼 수 있습니다. "Pest From Scratch" 코스를 적극 추천합니다.

기본 디렉토리 조직 따르기

Laravel과 같은 프레임워크를 사용해야 하는 이유를 생각해 본 적이 있나요?

프레임워크는 개발에 대한 체계적인 접근 방식을 제공하여 모든 팀 구성원이 일관성을 유지하고 공통 목표를 향해 노력할 수 있도록 합니다. 풍부하고 복잡하며 철저한 테스트를 거친 기능이 함께 제공되므로 세부 사항에 얽매이지 않고 프로젝트의 고유한 측면에 집중할 수 있습니다.

그렇다면 Laravel의 기본 프로젝트 구조를 따르는 것이 모범 사례로 간주됩니까? 전적으로! 이유는 다음과 같습니다.

편의성: Laravel의 규칙과 구조는 잘 문서화되어 있습니다. 몇 주 또는 몇 달 후에 프로젝트로 돌아오면 기본 설정의 명확성과 친숙함에 감사하게 될 것입니다.
팀 협업: 팀 구성원과 함께 작업할 때 모든 사람이 Laravel의 규칙을 이해하므로 협업이 더 쉬워집니다. 이렇게 공유된 지식을 활용하면 매 단계마다 바퀴를 재발명하는 대신 프로젝트를 추진할 수 있습니다.

복잡한 검증을 위해 사용자 정의 양식 요청 사용

Laravel의 사용자 정의 양식 요청은 유효성 검사를 처리하는 강력한 도구로, 몇 가지 주요 이점을 제공합니다.

검증 로직 재사용: 여러 컨트롤러에서 검증 규칙을 쉽게 재사용하여 코드를 DRY(반복하지 마세요)로 유지하세요.
컨트롤러 과대화 감소: 유효성 검사 코드를 전용 양식 요청 클래스로 오프로드하여 컨트롤러를 깔끔하게 유지하고 비즈니스 로직에 집중합니다.

사용자 정의 양식 요청 생성

맞춤 양식 요청을 만드는 방법은 간단합니다. 다음 Artisan 명령을 실행하세요:

php artisan make:request StorePostRequest

로그인 후 복사

그런 다음 컨트롤러에서 요청을 간단히 입력할 수 있습니다.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

사용자 정의 양식 요청 강화

맞춤 양식 요청에는 유효성 검사 이상의 추가 논리가 포함될 수도 있습니다. 예를 들어 prepareForValidation 메서드를 재정의하여 입력 데이터가 컨트롤러에 도달하기 전에 정규화할 수 있습니다.

public function prepareForValidation()
{
    $this->merge([
        'slug' => Str::slug($this->title),
    ]);
}

로그인 후 복사

이 예에서 메서드는 유효성 검사 프로세스가 발생하기 전에 제목에서 자동으로 슬러그를 생성합니다.

권한 관리

사용자 정의 양식 요청은 승인 논리도 처리할 수 있습니다. 정책 사용이 번거롭다면 양식 요청에 직접 간단한 승인 확인을 포함할 수 있습니다.

단일 작업 컨트롤러로 코드베이스 단순화

모범 사례를 따르더라도 컨트롤러가 다루기 어려워질 수 있습니다. 훌륭한 해결책은 Laravel에서 단일 작업 컨트롤러를 사용하는 것입니다. 이러한 컨트롤러는 표준 리소스 컨트롤러와 같은 여러 작업이 아닌 단일 작업을 처리하도록 설계되었습니다.

단일 작업 컨트롤러 만들기

단일 액션 컨트롤러를 생성하려면 다음 Artisan 명령을 사용하세요.

php artisan make:request StorePostRequest

로그인 후 복사

이 명령은 __invoke라는 하나의 작업만 포함하는 컨트롤러를 생성합니다. __invoke 매직 메소드에 대한 자세한 내용은 Laravel 문서를 참조하세요.

경로 정의

단일 작업 컨트롤러를 사용하면 경로 정의를 단순화할 수 있습니다. 경로에서 이를 사용하는 방법은 다음과 같습니다.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

주관적인 모범 사례

싱글 액션 컨트롤러를 사용하는 것은 주관적인 모범 사례입니다. 이 접근 방식이 프로젝트의 구조와 가독성 기본 설정에 적합한지 여부를 결정하는 것은 귀하와 귀하의 팀에 달려 있습니다.

미들웨어를 사용하여 코드 중복 방지

Laravel에서 미들웨어는 들어오는 요청을 필터링하거나 수정할 수 있는 강력한 도구입니다. 미들웨어를 활용하면 코드 중복을 방지하고 컨트롤러를 깔끔하고 관리하기 쉽게 유지할 수 있습니다. 다음은 몇 가지 일반적인 미들웨어 사용 사례입니다.

필수 권한 확인: 사용자에게 특정 경로에 액세스하는 데 필요한 권한이 있는지 확인하세요.
사용자 로케일 설정: 사용자가 선호하는 언어를 확인하고 이에 따라 애플리케이션의 로케일을 조정하세요.

Laravel은 인증, 속도 제한 등 일반적인 작업을 위한 다양한 내장 미들웨어를 제공합니다.

맞춤형 미들웨어 생성

맞춤형 미들웨어를 생성하려면 다음 Artisan 명령어를 사용하세요.

public function prepareForValidation()
{
    $this->merge([
        'slug' => Str::slug($this->title),
    ]);
}

로그인 후 복사

미들웨어에서 요청을 처리하는 논리를 정의할 수 있습니다. 다음은 사용자에게 충분한 토큰이 있는지 확인하는 미들웨어의 예입니다.

php artisan make:controller ShowPostController --invokable

로그인 후 복사

경로에 미들웨어 연결

미들웨어를 정의한 후에는 원하는 수의 경로에 연결할 수 있습니다. 이 모듈식 접근 방식은 코드를 깔끔하게 유지하고 컨트롤러의 중복을 줄이는 데 도움이 됩니다.

use App\Http\Controllers\ShowPostController;

// Single action controller route
Route::get('/posts/{post}', ShowPostController::class);

로그인 후 복사

승인을 위한 정책 사용

Laravel에서 인증 정책을 활용하는 것은 명확하고 유지 관리가 가능한 애플리케이션을 구축하는 데 중요합니다. 정책 사용의 세 가지 주요 이점은 다음과 같습니다.

컨트롤러 간 공유 인증 논리: 인증 규칙을 정책에 통합하면 일관성을 높이고 애플리케이션에서 중복 코드를 제거할 수 있습니다.
컨트롤러 복잡성 감소: 승인 논리를 정책으로 이동하면 컨트롤러가 기본 작업에 집중할 수 있으므로 코드가 더욱 깔끔하고 이해하기 쉬워집니다.
승인 코드에 대한 단순화된 액세스: 정책은 app/Policies 디렉토리에 있으므로 개발자가 필요할 때 승인 규칙을 쉽게 찾고 수정할 수 있습니다.

게시물 업데이트에 정책을 사용하는 실제 시나리오를 살펴보겠습니다.

php artisan make:request StorePostRequest

로그인 후 복사

마이그레이션이 최신 상태인지 확인

마이그레이션은 순수 PHP 코드를 사용하여 데이터베이스 스키마를 정의하는 방법입니다. 데이터베이스 구조를 관리하는 프로그래밍 방식을 제공하는 phpMyAdmin의 코드 대안으로 생각할 수 있습니다. 이 접근 방식은 모든 사람이 로컬 시스템에서 동일한 개발 환경을 복제하고 Git의 명확한 변경 내역을 유지할 수 있으므로 팀에 특히 유용합니다.

또한 마이그레이션을 통해 다른 환경에서 데이터베이스를 내보낼 필요 없이 새로운 환경(예: 스테이징 또는 프로덕션)에 프로젝트를 쉽게 배포할 수 있습니다. 그러나 일반적인 함정은 일부 개발자가 새 마이그레이션을 생성하는 대신 데이터베이스를 직접 변경한다는 것입니다. 이러한 관행은 Slack을 통해 데이터베이스 덤프를 요청해야 하는 다른 팀 구성원에게 불편을 줄 수 있습니다. 프로젝트를 향상시키고 일관성을 유지하려면 마이그레이션을 효과적으로 활용하는 것이 중요합니다.

충돌 방지를 위해 익명 마이그레이션 사용(Laravel 8 이상)

익명 이전은 클래스 이름 충돌을 방지하는 효과적인 솔루션입니다. 이 기능을 사용하면 오류 없이 "update_posts_table"이라는 이름의 여러 마이그레이션을 생성하여 개발 프로세스 중 마찰을 줄일 수 있습니다.

Laravel 9 이상에서는 다음 명령을 실행하면 익명 마이그레이션이 자동으로 생성됩니다.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

이러한 마이그레이션 구조는 다음과 같습니다.

public function prepareForValidation()
{
    $this->merge([
        'slug' => Str::slug($this->title),
    ]);
}

로그인 후 복사

흥미롭게도 Laravel 8에서는 익명 마이그레이션을 구현할 수도 있습니다. 이렇게 하려면 클래스 이름을 return new class로 바꾸고 끝에 세미콜론을 포함하면 됩니다. 이렇게 하면 이전 버전에서도 익명 마이그레이션의 이점을 누릴 수 있습니다.

롤백을 위한 down() 메서드를 올바르게 구현합니다.

down() 메소드는 php artisan migration:rollback 명령에서 데이터베이스 변경 사항을 되돌리는 데 사용됩니다. 일부 개발자는 구현하기로 선택하고 다른 개발자는 구현하지 않는 경우, 이를 사용하는 경우 down() 메서드가 올바르게 정의되었는지 확인하는 것이 중요합니다.

기본적으로 down() 메서드는 up() 메서드에서 수행된 작업을 반대로 수행해야 합니다. 기본적인 예는 다음과 같습니다.

php artisan make:request StorePostRequest

로그인 후 복사

down() 메소드를 사용하지 않으려면 간단히 삭제하면 됩니다.

Eloquent의 데이터베이스 테이블 명명 규칙을 따르세요.

Laravel의 테이블 명명 규칙을 준수하는 것은 팀에 큰 도움이 될 수 있는 간단한 모범 사례입니다. Artisan 명령어를 사용하면 프레임워크는 php artisan make:model Post --migration --factory와 같은 규칙을 자동으로 처리합니다.

어떤 이유로 인해 이러한 명령을 사용할 수 없는 경우 다음 빠른 가이드를 따르세요.

Post라는 모델의 경우 해당 테이블의 이름은 복수형을 사용하여 Posts로 지정해야 합니다. 예:
- 댓글 모델 → 댓글 테이블
- 응답 모델 → 응답 테이블
게시물과 댓글을 연결하는 피벗 테이블의 경우(예: comment_post):
- 두 이름 모두 단수형으로 사용하세요.
- 가나다순으로 정리하세요.

자세한 내용은 공식문서를 참고하세요.

즉시 로딩을 사용하여 N 1 문제 방지

더 많은 모범 사례를 다루겠습니다! N 1 문제에 직면했나요? Eager Loading은 이를 방지하는 효과적인 방법입니다.

예를 들어, 지연 로딩으로 인해 30개의 게시물과 작성자 목록을 표시하는 경우 Eloquent는 30개의 게시물에 대해 하나의 쿼리를 실행한 다음 각 작성자에 대해 추가로 30개의 쿼리를 실행합니다(즉, $post를 호출할 때마다) ->코드의 사용자인 경우 사용자 관계를 검색합니다.

해결책은 간단합니다. with() 메서드를 사용하여 쿼리 수를 31개에서 2개로 줄입니다.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

N 1 문제를 방지하려면 관계가 느리게 로드될 때마다 예외를 발생시키도록 애플리케이션을 구성할 수 있습니다. 이 제한은 로컬 환경에서만 시행되어야 합니다.

public function prepareForValidation()
{
    $this->merge([
        'slug' => Str::slug($this->title),
    ]);
}

로그인 후 복사

성능 문제와 오류를 피하기 위해 Eloquent의 Strict 모드를 사용하세요

Eloquent의 엄격 모드는 귀중한 디버깅 도구입니다. 다양한 시나리오에서 예외를 발생시켜 개발자가 개발 중에 잠재적인 문제를 식별하는 데 도움이 됩니다.

지연 로드 관계: 지연 로드는 특히 대규모 데이터세트를 처리할 때 성능 문제로 이어질 수 있습니다. 이 상황은 액세스할 때만 데이터베이스에서 관련 모델을 가져올 때 발생합니다. 엄격 모드에서는 관계가 지연 로드되면 예외가 발생하므로 즉시 로드를 사용하도록 권장됩니다.
채울 수 없는 속성 할당: Eloquent 모델의 $fillable 속성은 대량 할당 취약점을 방지합니다. 채울 수 없는 속성을 할당하려고 하면 예외가 발생하므로 개발자는 대량 할당을 처리할 때 주의해야 합니다.
존재하지 않는 속성에 액세스: 존재하지 않거나 데이터베이스에서 검색되지 않은 속성에 액세스하려고 하면 예측할 수 없는 동작이나 오류가 발생할 수 있습니다. 엄격 모드는 이러한 경우 예외를 발생시켜 개발자가 이러한 문제를 찾아 해결하는 데 도움을 줍니다.

엄격 모드를 활성화하려면 AppServiceProvider.php의 boot() 메서드에 다음 코드를 추가하세요.

php artisan make:request StorePostRequest

로그인 후 복사

새로운 방법을 사용하여 접근자와 변경자 정의

Laravel 9에서는 접근자와 변경자를 선언하는 새로운 방법을 도입했습니다. 지금 구현하는 방법은 다음과 같습니다.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

이 새로운 구문을 사용하면 접근자와 변경자를 보다 간결한 방식으로 정의할 수 있습니다. 계산 비용이 많이 드는 값을 캐시할 수도 있습니다.

public function prepareForValidation()
{
    $this->merge([
        'slug' => Str::slug($this->title),
    ]);
}

로그인 후 복사

반대로 이전 방법은 다음과 같습니다.

php artisan make:controller ShowPostController --invokable

로그인 후 복사

새로운 구문으로 전환하면 코드가 단순화되고 가독성이 향상됩니다.

dispatchAfterResponse()를 사용하여 장기 실행 작업 처리

시간이 많이 걸리는 작업(문의 양식 제출 후 이메일 전송 등)을 처리할 때 서버가 사용자에게 응답할 때까지 작업을 지연시켜 사용자 경험을 향상시킬 수 있습니다. 여기가 dispatchAfterResponse()가 작동하는 곳이며, 장기 실행 프로세스를 연기할 수 있게 해줍니다.

use App\Http\Controllers\ShowPostController;

// Single action controller route
Route::get('/posts/{post}', ShowPostController::class);

로그인 후 복사

또는 익명 기능을 사용하여 작업을 예약하려면 다음과 같이 할 수 있습니다.

php artisan make:middleware CheckTokens

로그인 후 복사

dispatchAfterResponse()를 사용하면 백그라운드 작업이 사용자 경험에 영향을 주지 않는 동안 사용자가 서버로부터 더 빠른 응답을 받을 수 있습니다.

대기열을 사용하여 장기 실행 작업 처리

사용자가 업로드한 이미지 처리 등 컴퓨팅 집약적인 작업을 처리할 때 이러한 작업을 즉시 실행하면 서버에 과부하가 걸리고 사용자 경험이 저하될 수 있습니다. 해결 방법은 다음과 같습니다.

서버 압박: 모든 사용자에 대해 실시간 처리 작업을 제출하면 서버에 부담을 줄 수 있습니다.
사용자 경험: 사용자는 로딩 화면을 쳐다보며 기다려야만 하고 좌절감을 느끼게 됩니다.

Laravel의 대기열 시스템을 사용하면 이러한 장기 실행 작업을 순서대로 또는 제어된 병렬 방식으로 실행하여 서버의 응답성을 유지하고 사용자가 기다릴 필요가 없도록 할 수 있습니다.

작업 관리를 용이하게 하려면 대기열 작업을 효율적으로 모니터링하고 제어하기 위한 사용자 인터페이스를 제공하는 Laravel Horizon을 사용하는 것이 좋습니다. 이렇게 하면 원활한 성능을 유지하면서 백그라운드에서 복잡한 프로세스를 처리할 수 있습니다.

각 테스트 전에 데이터베이스를 느리게 새로 고침

로컬 환경에서 테스트할 때는 테스트를 실행할 때마다 새로운 데이터베이스를 사용하는 것이 가장 좋습니다. Laravel은 각 테스트 전에 데이터베이스를 천천히 새로 고치는 방식으로 이를 처리하는 효율적인 방법을 제공합니다. 이는 테스트 클래스의 RefreshDatabase 특성을 사용하여 수행할 수 있습니다. 이렇게 하면 테스트가 실행될 때마다 데이터베이스가 깨끗한 상태가 되어 남은 데이터로 인해 발생할 수 있는 문제가 제거됩니다.

RefreshDatabase 사용

테스트 클래스에서 RefreshDatabase 특성을 사용하세요.

php artisan make:request StorePostRequest

로그인 후 복사

장점

일관성: 테스트가 실행될 때마다 데이터베이스 상태가 일관되도록 보장하여 상태 변경으로 인한 테스트 실패를 방지합니다.
격리: 각 테스트는 간섭 없이 독립적으로 실행되므로 테스트의 신뢰성이 향상됩니다.

민감한 정보를 안전하게 관리

민감한 정보를 관리할 때는 보안을 확보하는 것이 중요합니다. 다음은 몇 가지 모범 사례입니다.

환경 변수 사용

코드베이스가 아닌 .env 파일에 민감한 정보(API 키, 데이터베이스 자격 증명 등)를 저장하세요.

Laravel의 암호화 기능 사용

암호화가 필요한 데이터의 경우 Laravel의 암호화 기능을 활용하세요.

use App\Http\Requests\StorePostRequest;

class PostController
{
    public function store(StorePostRequest $request)
    {
        $validated = $request->validated();
        Post::create($validated);
        // Other logic...
    }
}

로그인 후 복사

정기적으로 키 업데이트

애플리케이션 키(APP_KEY)를 정기적으로 업데이트하고 업데이트 후 데이터를 다시 암호화하세요.

결론

이러한 모범 사례, 팁, 요령을 따르면 Laravel 애플리케이션의 품질과 보안을 크게 향상시킬 수 있습니다. 이러한 방법은 보다 효율적인 코드를 작성하는 데 도움이 될 뿐만 아니라 사용자에게 더 나은 경험을 제공합니다. 이러한 관행을 계속해서 배우고 적용하면 개발에서 더 큰 성공을 거두는 데 도움이 될 것입니다.

위 내용은 5를 위한 Laravel 모범 사례, 팁 및 요령의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!