백엔드 개발 PHP 튜토리얼 Laravel 11의 PHP 제네릭

Laravel 11의 PHP 제네릭

Oct 23, 2024 am 08:08 AM

PHP Generics in Laravel 11

Laravel을 사용하는 웹 애플리케이션 빌더이고 정적 코드 분석을 위해 PHPStan을 사용하는 경우 Laravel으로 업그레이드할 때 새로운 오류가 표시되기 시작합니다. 11.x.

PHPStan을 사용하여 새로 Laravel을 설치한 경우 ./vendor/bin/phpstan을 처음 실행하면 다음 오류가 발생합니다.

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------
로그인 후 복사
로그인 후 복사
로그인 후 복사

그래서 무엇이 바뀌었나요? Laravel 11에서 HasFactory 특성에는 이제 예약된 일반 태그 중 하나인 @template 태그가 있는 PHPDoc이 있습니다. 이미 짐작하셨겠지만 제네릭은 프레임워크의 많은 부분에서 사용되고 있습니다.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}
로그인 후 복사
로그인 후 복사
로그인 후 복사

권장되지는 않지만 phpstan.neon 파일에 다음 코드 줄을 추가하면 이 오류 범주를 무시할 수 있습니다.

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics
로그인 후 복사
로그인 후 복사

하지만 제네릭은 그다지 이해하기 어렵지 않으니 시작해 보세요!

제네릭이란 무엇입니까?

프로그래밍에서 제네릭은 여러 데이터 유형에 사용할 수 있는 코드를 작성할 수 있는 기능을 의미합니다. 각 데이터 유형에 대해 별도의 코드를 작성하는 대신 혼합 또는 객체와 같은 일반적인 유형을 사용하는 것과 달리 유형 안전성을 유지하면서 다양한 유형에서 작동할 수 있는 하나의 일반적인 코드 조각을 작성할 수 있습니다.

Laravel 10에서 IlluminateDatabaseConcernsBuildsQueries::first 메소드를 사용하면 IlluminateDatabaseEloquentBuilder 또는 null과 같이 이를 사용하는 클래스의 인스턴스인 일반 객체인 Model의 인스턴스를 반환할 수 있습니다.

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}
로그인 후 복사
로그인 후 복사

제네릭 구문

제네릭은 PHP에서 최우선적으로 지원되지 않습니다. 이를 사용하려면 PHPDocs 태그 @template, @template-covariant, @template-contravariant, @extends, @implements 및 @use.

일반 유형의 규칙은 유형 매개변수를 사용하여 정의됩니다. PHPDocs에서는 @template 태그로 주석을 답니다. 유형 매개변수 이름은 기존 클래스 이름을 사용하지 않는 한 무엇이든 될 수 있습니다. of 키워드를 사용하여 유형 매개변수 대신 사용할 수 있는 유형을 상한으로 제한할 수도 있습니다. 이를 제한된 유형 매개변수
라고 합니다.

<?php

namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}
로그인 후 복사
로그인 후 복사

PHP 제네릭의 유형

일반 기능

일반 함수는 일반 함수와 똑같지만 유형 매개변수가 있습니다. 이를 통해 일반적인 방법을 보다 일반적인 방식으로 사용할 수 있습니다.

IlluminateSupportValidatedInput::enum 메소드를 예로 들어보세요.

  • 유형 매개변수 TEnum을 정의합니다.

  • $enumClass 매개변수는 의사 유형 class-string이고 동일한 유형 매개변수 TEnum에 제한됩니다.

  • 반환 유형은 TEnum 또는 null일 수도 있습니다.

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------
로그인 후 복사
로그인 후 복사
로그인 후 복사

$request→validated()→enum('status', OrderStatus::class)를 호출하면 PHPStan은 OrderStatus 객체 또는 null을 얻는다는 것을 알게 됩니다!

일반 클래스

일반 클래스를 사용하면 유형 안전성을 보장하면서 모든 데이터 유형에서 작동할 수 있는 클래스를 만들 수 있습니다. 특정 유형에 대한 자리 표시자로 클래스를 정의할 수 있으며, 나중에 클래스가 인스턴스화될 때 대체될 수 있습니다.

Laravel 소스 코드의 좋은 예는 IlluminateDatabaseEloquentBuilder 클래스입니다.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}
로그인 후 복사
로그인 후 복사
로그인 후 복사

유형 매개변수 TModel은 IlluminateDatabaseEloquentModel의 모든 하위 클래스에 정의되고 바인딩됩니다. make 메소드의 반환 유형으로 동일한 유형 매개변수가 사용됩니다.

또 다른 예로는 상태에 따라 주문을 필터링하는 로컬 범위가 있는 주문 모델이 있는 경우입니다. 범위 메소드는 TModel 유형을 지정해야 합니다

parameters:
    ignoreErrors:
        -
            identifier: missingType.generics
로그인 후 복사
로그인 후 복사

ℹ️ info: BelongsTo 및 HasOne과 같은 IlluminateDatabaseEloquentRelations 네임스페이스의 모든 Eloquent 관계 클래스는 이제 일반 클래스입니다.

일반 인터페이스

일반 인터페이스는 크게 다르지 않습니다. IlluminateContractsSupportArrayable은 일반 인터페이스의 예입니다

/**
 * Execute the query and get the first result.
 *
 * @param  array|string  $columns
 * @return \Illuminate\Database\Eloquent\Model|object|static|null
 */
public function first($columns = ['*'])
{
    return $this->take(1)->get($columns)->first();
}
로그인 후 복사
로그인 후 복사

인터페이스는 배열 키 유형의 TKey(int 또는 문자열일 수 있음)와 TValue라는 두 가지 유형 매개변수를 정의합니다. 이 두 매개변수는 toArray 함수의 반환 유형을 정의하는 데 사용됩니다. 예는 다음과 같습니다.

<?php

namespace Illuminate\Database\Eloquent;

/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 *
 */
class Builder implements BuilderContract
{
}
로그인 후 복사
로그인 후 복사

사용자 클래스는 Arrayable 인터페이스를 구현하고 Tkey 유형을 int로, TValue를 문자열로 지정합니다.

일반 특성

이 게시물 시작 부분의 오류에서 IlluminateDatabaseEloquentFactoriesHasFactory 특성을 발견했습니다. 좀 더 자세히 살펴보겠습니다:

/**
 * @template TEnum
 *
 * @param string $key
 * @param class-string<TEnum> $enumClass
 * @return TEnum|null
 */
public function enum($key, $enumClass)
{
    if ($this->isNotFilled($key) ||
        ! enum_exists($enumClass) ||
        ! method_exists($enumClass, 'tryFrom')) {
        return null;
    }
    return $enumClass::tryFrom($this->input($key));
}
로그인 후 복사

HasFactory는 IlluminateDatabaseEloquentFactoriesFactory의 하위 클래스에 바인딩된 유형 매개변수 TFactory를 정의합니다. 그러면 해당 오류를 어떻게 수정할 수 있나요?

특성을 사용할 때 TFactory 유형을 지정해야 합니다. 따라서 HasFactory 특성의 use 문은 PHPDocs @use:
로 주석을 달아야 합니다.

<?php

namespace Illuminate\Database\Eloquent;
/**
 * @template TModel of \Illuminate\Database\Eloquent\Model
 */
class Builder implements BuilderContract
{
    /**
     * @param  array  $attributes
     * @return TModel
     */
    public function make(array $attributes = [])
    {
        return $this->newModelInstance($attributes);
    }
}
로그인 후 복사

일반성 보존

클래스 확장, 인터페이스 구현, 특성 사용 시 하위 클래스의 일반성을 유지할 수 있습니다.

일반성을 유지하는 방법은 하위 클래스 위에 동일한 유형 매개변수를 정의하고 이를 @extends, @implements 및 @use 태그에 전달하는 방식으로 구현됩니다.

일루미네이트DatabaseConcernsBuildsQueries 일반 특성을 예로 사용하겠습니다.

유형 매개변수 TValue를 정의합니다:

 ------ -----------------------------------------------------------------------------------
  Line   app\Models\User.php
 ------ -----------------------------------------------------------------------------------
  13     Class App\Models\User uses generic trait
         Illuminate\Database\Eloquent\Factories\HasFactory but does not specify its types:
         TFactory
 ------ -----------------------------------------------------------------------------------
로그인 후 복사
로그인 후 복사
로그인 후 복사

IlluminateDatabaseEloquentBuilder 클래스는 이 특성을 사용하지만 TModel 매개변수 유형을 전달하여 일반성을 유지합니다. 이제 TModel 유형을 지정하고 결과적으로 BuildsQueries 특성에 TValue를 지정하는 것은 클라이언트 코드에 맡겨졌습니다.

/**
 * @template TFactory of \Illuminate\Database\Eloquent\Factories\Factory
 */
trait HasFactory
{
    ...
}
로그인 후 복사
로그인 후 복사
로그인 후 복사

최종 생각

결론적으로, PHP는 다른 프로그래밍 언어와 동일한 방식으로 제네릭을 기본적으로 지원하지 않지만 PHPStan과 같은 고급 유형 힌트 및 도구를 도입하면 개발자가 코드에 제네릭과 유사한 기능을 구현할 수 있습니다. . PHPDocs, 매개변수화된 클래스 및 인터페이스를 활용하면 코드 재사용성과 유지 관리성을 향상시키는 보다 유연하고 유형이 안전한 애플리케이션을 만들 수 있습니다. PHP가 계속 발전함에 따라 유형 안전성과 정적 분석에 대한 커뮤니티의 관심이 높아지면서 제네릭 구현을 위한 보다 강력한 솔루션이 탄생할 가능성이 높습니다. 이러한 관행을 수용하면 코딩 기술이 향상될 뿐만 아니라 시간이 흘러도 변함없는 고품질 소프트웨어 개발에 기여합니다.

위 내용은 Laravel 11의 PHP 제네릭의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.

핫 AI 도구

Undresser.AI Undress

Undresser.AI Undress

사실적인 누드 사진을 만들기 위한 AI 기반 앱

AI Clothes Remover

AI Clothes Remover

사진에서 옷을 제거하는 온라인 AI 도구입니다.

Undress AI Tool

Undress AI Tool

무료로 이미지를 벗다

Clothoff.io

Clothoff.io

AI 옷 제거제

Video Face Swap

Video Face Swap

완전히 무료인 AI 얼굴 교환 도구를 사용하여 모든 비디오의 얼굴을 쉽게 바꾸세요!

뜨거운 도구

메모장++7.3.1

메모장++7.3.1

사용하기 쉬운 무료 코드 편집기

SublimeText3 중국어 버전

SublimeText3 중국어 버전

중국어 버전, 사용하기 매우 쉽습니다.

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

SublimeText3 Mac 버전

SublimeText3 Mac 버전

신 수준의 코드 편집 소프트웨어(SublimeText3)

JWT (JSON Web Tokens) 및 PHP API의 사용 사례를 설명하십시오. JWT (JSON Web Tokens) 및 PHP API의 사용 사례를 설명하십시오. Apr 05, 2025 am 12:04 AM

JWT는 주로 신분증 인증 및 정보 교환을 위해 당사자간에 정보를 안전하게 전송하는 데 사용되는 JSON을 기반으로 한 개방형 표준입니다. 1. JWT는 헤더, 페이로드 및 서명의 세 부분으로 구성됩니다. 2. JWT의 작업 원칙에는 세 가지 단계가 포함됩니다. JWT 생성, JWT 확인 및 Parsing Payload. 3. PHP에서 인증에 JWT를 사용하면 JWT를 생성하고 확인할 수 있으며 사용자 역할 및 권한 정보가 고급 사용에 포함될 수 있습니다. 4. 일반적인 오류에는 서명 검증 실패, 토큰 만료 및 대형 페이로드가 포함됩니다. 디버깅 기술에는 디버깅 도구 및 로깅 사용이 포함됩니다. 5. 성능 최적화 및 모범 사례에는 적절한 시그니처 알고리즘 사용, 타당성 기간 설정 합리적,

PHP 8.1에서 열거 (열거)는 무엇입니까? PHP 8.1에서 열거 (열거)는 무엇입니까? Apr 03, 2025 am 12:05 AM

PHP8.1의 열거 기능은 명명 된 상수를 정의하여 코드의 명확성과 유형 안전성을 향상시킵니다. 1) 열거는 정수, 문자열 또는 객체 일 수 있으며 코드 가독성 및 유형 안전성을 향상시킬 수 있습니다. 2) 열거는 클래스를 기반으로하며 Traversal 및 Reflection과 같은 객체 지향적 특징을 지원합니다. 3) 열거는 유형 안전을 보장하기 위해 비교 및 ​​할당에 사용될 수 있습니다. 4) 열거는 복잡한 논리를 구현하는 방법을 추가하는 것을 지원합니다. 5) 엄격한 유형 확인 및 오류 처리는 일반적인 오류를 피할 수 있습니다. 6) 열거는 마법의 가치를 줄이고 유지 관리를 향상 시키지만 성능 최적화에주의를 기울입니다.

세션 납치는 어떻게 작동하며 PHP에서 어떻게 완화 할 수 있습니까? 세션 납치는 어떻게 작동하며 PHP에서 어떻게 완화 할 수 있습니까? Apr 06, 2025 am 12:02 AM

세션 납치는 다음 단계를 통해 달성 할 수 있습니다. 1. 세션 ID를 얻으십시오. 2. 세션 ID 사용, 3. 세션을 활성 상태로 유지하십시오. PHP에서 세션 납치를 방지하는 방법에는 다음이 포함됩니다. 1. 세션 _regenerate_id () 함수를 사용하여 세션 ID를 재생산합니다. 2. 데이터베이스를 통해 세션 데이터를 저장하십시오.

확실한 원칙과 PHP 개발에 적용되는 방법을 설명하십시오. 확실한 원칙과 PHP 개발에 적용되는 방법을 설명하십시오. Apr 03, 2025 am 12:04 AM

PHP 개발에서 견고한 원칙의 적용에는 다음이 포함됩니다. 1. 단일 책임 원칙 (SRP) : 각 클래스는 하나의 기능 만 담당합니다. 2. Open and Close Principle (OCP) : 변경은 수정보다는 확장을 통해 달성됩니다. 3. Lisch의 대체 원칙 (LSP) : 서브 클래스는 프로그램 정확도에 영향을 미치지 않고 기본 클래스를 대체 할 수 있습니다. 4. 인터페이스 격리 원리 (ISP) : 의존성 및 사용되지 않은 방법을 피하기 위해 세밀한 인터페이스를 사용하십시오. 5. 의존성 반전 원리 (DIP) : 높고 낮은 수준의 모듈은 추상화에 의존하며 종속성 주입을 통해 구현됩니다.

PHP에서 늦은 정적 결합을 설명하십시오 (정적 : :). PHP에서 늦은 정적 결합을 설명하십시오 (정적 : :). Apr 03, 2025 am 12:04 AM

정적 바인딩 (정적 : :)는 PHP에서 늦은 정적 바인딩 (LSB)을 구현하여 클래스를 정의하는 대신 정적 컨텍스트에서 호출 클래스를 참조 할 수 있습니다. 1) 구문 분석 프로세스는 런타임에 수행됩니다. 2) 상속 관계에서 통화 클래스를 찾아보십시오. 3) 성능 오버 헤드를 가져올 수 있습니다.

REST API 디자인 원칙은 무엇입니까? REST API 디자인 원칙은 무엇입니까? Apr 04, 2025 am 12:01 AM

RESTAPI 설계 원칙에는 자원 정의, URI 설계, HTTP 방법 사용, 상태 코드 사용, 버전 제어 및 증오가 포함됩니다. 1. 자원은 명사로 표현되어야하며 계층 구조로 유지해야합니다. 2. HTTP 방법은 Get이 자원을 얻는 데 사용되는 것과 같은 의미론을 준수해야합니다. 3. 404와 같이 상태 코드는 올바르게 사용해야합니다. 자원이 존재하지 않음을 의미합니다. 4. 버전 제어는 URI 또는 ​​헤더를 통해 구현할 수 있습니다. 5. 증오는 응답으로 링크를 통한 클라이언트 작업을 부팅합니다.

PHP에서 예외를 효과적으로 처리하는 방법 (시도, 잡기, 마지막으로, 던지기)? PHP에서 예외를 효과적으로 처리하는 방법 (시도, 잡기, 마지막으로, 던지기)? Apr 05, 2025 am 12:03 AM

PHP에서는 시도, 캐치, 마지막으로 키워드를 통해 예외 처리가 이루어집니다. 1) 시도 블록은 예외를 던질 수있는 코드를 둘러싸고 있습니다. 2) 캐치 블록은 예외를 처리합니다. 3) 마지막으로 블록은 코드가 항상 실행되도록합니다. 4) 던지기는 수동으로 예외를 제외하는 데 사용됩니다. 이러한 메커니즘은 코드의 견고성과 유지 관리를 향상시키는 데 도움이됩니다.

PHP의 익명 클래스는 무엇이며 언제 사용할 수 있습니까? PHP의 익명 클래스는 무엇이며 언제 사용할 수 있습니까? Apr 04, 2025 am 12:02 AM

PHP에서 익명 클래스의 주요 기능은 일회성 객체를 만드는 것입니다. 1. 익명 클래스를 사용하면 이름이없는 클래스가 코드에 직접 정의 될 수 있으며, 이는 임시 요구 사항에 적합합니다. 2. 클래스를 상속하거나 인터페이스를 구현하여 유연성을 높일 수 있습니다. 3. 사용할 때 성능 및 코드 가독성에주의를 기울이고 동일한 익명 클래스를 반복적으로 정의하지 마십시오.

See all articles