PHP 마스터하기: 유형 힌트 기술

사진 제공: ???? ??? Unsplash

어떤 사람들은 유형 힌트를 기능의 성배로 간주합니다. 모든 프로그래밍 언어가 가지고 있어야 하는 것 중 하나입니다. 오랫동안 PHP에는 이러한 시스템이 없었지만 현재는 대부분의 개발자가 널리 채택하고 있습니다.

그렇지만 PHP의 유형 시스템은 다른 언어만큼 멀리 가지 않습니다. 많은 사람들이 Generics라고 알려진 것을 구현합니다. 이는 구조와 컬렉션 간에 유형을 적용하는 기능입니다. 예를 들어, Java에서는 배열이 문자열 배열과 같은 특정 유형의 항목만 포함하도록 지정할 수 있습니다.

언젠가는 PHP에도 이 기능이 탑재될 수 있지만 그때까지는 실제로 몇 가지 다른 기술을 사용하여 이 문제를 해결할 수 있습니다. 더 나은 설명이 부족하여 이를 소프트 타입 힌트 및 런타임 힌트

라고 합니다.

힌트 입력

첫 번째이자 가장 확실한 유형 힌트는 PHP 7에 도입된 힌트이며 계속해서 PHP에 추가되고 있습니다. 유형 힌트 상수는 PHP 8.3에서만 추가되었습니다.

유형 힌트는 메서드나 함수에 매개변수로 전달해야 하는 내용이나 해당 메서드가 반환할 내용을 전달하는 데 유용합니다. 유형 힌트는 이미 설정된 유형 힌트로 클래스를 확장하면 이를 재정의할 수 없음을 의미하므로 함께 사용하는 모든 클래스의 시그니처에 영향을 미칩니다.

유형을 최대한 활용하는 클래스의 예는 다음과 같습니다.

<?php class Foo
{
    public function bar(array $strings): \Closure
    {
       return function (string $string) use ($strings): bool {
           return in_array($string, $strings);
       };
    }
}

물론 이전에 언급한 것처럼 배열을 모두 동일한 유형으로 지정할 수 없고 대신 array 를 사용해야 하기 때문에 유형 힌트에는 제한이 있습니다. 또한 숫자를 양수로만 제한하거나 특정 범위 내로 제한할 수도 없습니다.

PHP의 기본 유형 내에서 익명 함수를 설명할 방법이 없기 때문에 또 다른 하나는 클로저일 수 있습니다. 대신 Closure 또는 callable 을 사용해야 합니다. 호출 가능은 유형으로도 사용할 수 없는 경우가 많습니다.

다행히도 유형 힌트를 사용하여 이러한 더 복잡한 시나리오를 설명할 수 있는 방법이 아직 남아 있습니다.

소프트 유형 힌트

다음 종류의 유형 힌트는 PHPDocs를 통해 제공됩니다. 메소드가 전달되거나 잘못된 유형을 반환하는 경우 기본 유형은 런타임 중에 예외를 발생시키지만 PHPDoc 유형 힌트는 애플리케이션 런타임에 영향을 미치지 않습니다.

대신, 소프트 유형 힌트는 해당 유형을 감지해 주는 VS Code 또는 PHPStorm과 같은 IDE를 사용할 때 순전히 도움이 됩니다. 다른 사용 사례는 PHPStan 및 Rector와 같은 정적 분석 도구를 사용하는 것입니다.

소프트 유형을 사용하는 가장 큰 장점은 매개변수, 속성 등의 유형을 더 정확하게 설명할 수 있다는 것입니다. 예를 들어 이전 수업을 수강하면 사용된 배열이나 클로저를 더 쉽게 이해할 수 있습니다. .

<?php class Foo
{
    /**
     * @param string[] $strings
     * @return \Closure(string): bool
     */
    public function bar(array $strings): \Closure
    {
       return function (string $string) use ($strings): bool {
           return in_array($string, $strings);
       };
    }
}

모든 유형 사용이 올바른지 확인하는 가장 좋은 방법은 PHPStan을 설치하는 것입니다. 거기에서 최소한 레벨 5를 사용해야 할 것입니다. 그런 다음 유형 힌트가 올바른지 확인하는 지속적인 통합 단계를 통해 이를 시행할 수 있습니다.

올바른 소프트 유형 힌트를 사용하려는 경우 실제로 사용할 수 있는 목록이 있습니다. 더 좋은 점은 확실하지 않고 빠른 테스트를 실행하려는 경우 PHPStan에 따라 힌트를 제공하는 모든 유형이 올바른지 테스트하는 데 사용할 수 있는 PHPStan 도구가 있다는 것입니다.

런타임 힌트

유형을 지원하는 다음 방법은 런타임 힌트를 사용하는 것입니다. 이것이 실제로 의미하는 것은 매개변수에서 유형을 확인하기 위해 자체 코드를 실행하는 것입니다. 예를 들어, 배열에 특정 유형의 객체만 포함되어 있는지 확인할 수 있습니다. 그렇지 않으면 InvalidArgumentException이 발생합니다.

<?php /**
 * @param string[] $foo
 */
function bar(array $foo) {
    foreach ($foo as $string) {
        if (! is_string($string)) {
            throw new \InvalidArgumentException('foo contains non-string value');
        }
    }

    // rest of the code
}

그런데 이 기술을 방어 프로그래밍이라고도 합니다. 코드 예제를 보면 꽤 번거롭습니다. 단순히 배열이 올바른지 확인하는 데는 많은 코드가 필요합니다. 그래서 우리는 종종 라이브러리를 사용합니다. 이 경우에는 webmozart/assert 입니다.

composer require webmozart/assert

이제 이 패키지가 설치되었으므로 이를 간단한 한 줄로 줄일 수 있습니다.

<?php use Webmozart\Assert;

/**
 * @param string[] $foo
 */
function bar(array $foo) {
    Assert::allStrings($foo);
}

이 라이브러리의 가장 큰 장점 중 하나는 PHPStan에 Assert 확장을 추가하면 코드를 분석할 때 유형 적용에 도움이 된다는 것입니다.

결론

결론적으로, PHP의 유형 힌트 마스터링은 깔끔하고 유지 관리가 가능하며 안정적인 코드를 작성하려는 개발자에게 필수적인 기술입니다. PHP의 유형 시스템에는 여전히 제네릭과 같은 다른 언어에서 볼 수 있는 일부 기능이 부족하지만 기본 유형 힌트, PHPDoc 주석 또는 런타임 검사를 통해 더 엄격한 유형 지정을 적용할 수 있는 여러 전략이 있습니다. PHPStan과 같은 도구와 Assert와 같은 라이브러리를 활용하면 복잡한 시나리오에서도 유형 안전성을 보장하는 데 도움이 될 수 있습니다. 이러한 기술을 개발 워크플로에 통합하면 PHP의 동적 특성을 자신감 있고 정확하게 처리할 수 있는 능력을 더 잘 갖추게 될 것입니다.

저는 Laravel과 함께 일하고 있는 영국의 소프트웨어 개발자 Peter Fox입니다. 제 기사를 읽어주셔서 감사합니다. https://articles.peterfox.me에서 읽을 내용이 더 많이 있습니다. 저는 이제 GitHub에서도 후원을 받고 있습니다. 제가 이와 같은 기사를 더 많이 쓸 수 있도록 격려하고 싶다면 소액의 일회성 기부를 고려해 보세요.

위 내용은 PHP 마스터하기: 유형 힌트 기술의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!