찾다
백엔드 개발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));
}
</tenum>

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으로 문의하세요.
PHP는 사용자 세션을 어떻게 식별합니까?PHP는 사용자 세션을 어떻게 식별합니까?May 01, 2025 am 12:23 AM

phpidifiesauser의 sssessionusessessioncookiesandssessionids.1) whensession_start () iscalled, phpgeneratesauniquessessionStoredInacookienamedPhpsSessIdonSeuser 'sbrowser.2) thisidallowsphptoretrievessessionDataTromServer.

PHP 세션을 확보하기위한 모범 사례는 무엇입니까?PHP 세션을 확보하기위한 모범 사례는 무엇입니까?May 01, 2025 am 12:22 AM

PHP 세션의 보안은 다음 측정을 통해 달성 할 수 있습니다. 1. Session_REGENEREAT_ID ()를 사용하여 사용자가 로그인하거나 중요한 작업 일 때 세션 ID를 재생합니다. 2. HTTPS 프로토콜을 통해 전송 세션 ID를 암호화합니다. 3. 세션 _save_path ()를 사용하여 세션 데이터를 저장하고 권한을 올바르게 설정할 보안 디렉토리를 지정하십시오.

PHP 세션 파일은 기본적으로 어디에 저장됩니까?PHP 세션 파일은 기본적으로 어디에 저장됩니까?May 01, 2025 am 12:15 AM

phpsessionfilesarestoredInTheRectorySpecifiedBysession.save_path, 일반적으로/tmponunix-likesystemsorc : \ windows \ temponwindows.tocustomizethis : 1) austession_save_path () toSetacustomDirectory, verlyTeCustory-swritation;

PHP 세션에서 데이터를 어떻게 검색합니까?PHP 세션에서 데이터를 어떻게 검색합니까?May 01, 2025 am 12:11 AM

toretrievedatafromAphPsession, startSessionstart_start () andaccessvariblesinthe $ _sessionArray.forexample : 1) startthessession : session_start (). 2) retrievedata : $ _ session [ 'username']; echo "Welcome,". $ username;

세션을 사용하여 쇼핑 카트를 구현할 수있는 방법은 무엇입니까?세션을 사용하여 쇼핑 카트를 구현할 수있는 방법은 무엇입니까?May 01, 2025 am 12:10 AM

세션을 사용하여 효율적인 쇼핑 카트 시스템을 구축하는 단계에는 다음이 포함됩니다. 1) 세션의 정의와 기능을 이해합니다. 세션은 요청에 따라 사용자 상태를 유지하는 데 사용되는 서버 측 스토리지 메커니즘입니다. 2) 쇼핑 카트에 제품 추가와 같은 기본 세션 관리를 구현합니다. 3) 제품 수량 관리 및 삭제 지원 고급 사용으로 확장; 4) 세션 데이터를 지속하고 보안 세션 식별자를 사용하여 성능 및 보안을 최적화합니다.

PHP에서 인터페이스를 어떻게 생성하고 사용합니까?PHP에서 인터페이스를 어떻게 생성하고 사용합니까?Apr 30, 2025 pm 03:40 PM

이 기사는 PHP의 인터페이스를 생성, 구현 및 사용하는 방법을 설명하여 코드 구성 및 유지 관리에 대한 이점에 중점을 둡니다.

crypt ()와 password_hash ()의 차이점은 무엇입니까?crypt ()와 password_hash ()의 차이점은 무엇입니까?Apr 30, 2025 pm 03:39 PM

이 기사에서는 PHP의 암호 해싱에 대한 Crypt ()와 Password_hash ()의 차이점에 대해 논의하여 최신 웹 애플리케이션에 대한 구현, 보안 및 적합성에 중점을 둡니다.

PHP의 크로스 사이트 스크립팅 (XSS)을 어떻게 방지 할 수 있습니까?PHP의 크로스 사이트 스크립팅 (XSS)을 어떻게 방지 할 수 있습니까?Apr 30, 2025 pm 03:38 PM

기사는 입력 유효성 검사, 출력 인코딩 및 OWASP ESAPI 및 HTML 청정기와 같은 도구를 통해 PHP의 크로스 사이트 스크립팅 (XSS) 방지에 대해 논의합니다.

See all articles

핫 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 얼굴 교환 도구를 사용하여 모든 비디오의 얼굴을 쉽게 바꾸세요!

뜨거운 도구

SublimeText3 중국어 버전

SublimeText3 중국어 버전

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

스튜디오 13.0.1 보내기

스튜디오 13.0.1 보내기

강력한 PHP 통합 개발 환경

PhpStorm 맥 버전

PhpStorm 맥 버전

최신(2018.2.1) 전문 PHP 통합 개발 도구

드림위버 CS6

드림위버 CS6

시각적 웹 개발 도구

SecList

SecList

SecLists는 최고의 보안 테스터의 동반자입니다. 보안 평가 시 자주 사용되는 다양한 유형의 목록을 한 곳에 모아 놓은 것입니다. SecLists는 보안 테스터에게 필요할 수 있는 모든 목록을 편리하게 제공하여 보안 테스트를 더욱 효율적이고 생산적으로 만드는 데 도움이 됩니다. 목록 유형에는 사용자 이름, 비밀번호, URL, 퍼징 페이로드, 민감한 데이터 패턴, 웹 셸 등이 포함됩니다. 테스터는 이 저장소를 새로운 테스트 시스템으로 간단히 가져올 수 있으며 필요한 모든 유형의 목록에 액세스할 수 있습니다.