🦸🏿‍♂️ Gato GraphQL이 이제 PHP 8.0에서 7.1로 트랜스파일됩니다

예전에 PHP 코드를 트랜스파일하는 기법에 대해 글을 쓴 적이 있습니다.

PHP 코드를 트랜스파일하면 개발 시에는 최신 PHP 기능을 사용하면서도, 프로덕션 배포 시에는 코드를 구 버전 PHP로 변환하여 플러그인을 릴리스할 수 있어 더 많은 사용자를 대상으로 할 수 있습니다.

지난 몇 주 동안 Gato GraphQL 플러그인을 위해 이 프로세스를 더욱 정교하게 다듬었습니다.

이제 플러그인의 요구 PHP 버전이 PHP 8.0으로 업그레이드되었음을 기쁘게 알려드립니다.

PHP 최소 버전 8.0으로 업그레이드

이제 플러그인이 PHP 8.0을 전제로 사용할 수 있게 되면서, 코드베이스 전체의 모든 PHP 클래스에 있는 모든 프로퍼티에 타입을 추가하는 작업을 완료할 수 있었습니다. 유니온 타입도 포함됩니다.

훌륭합니다!

아래는 플러그인 개발 시 사용할 수 있는 모든 새로운 PHP 8.0 기능의 요약입니다.

PHP 8.0 신기능

Gato GraphQL을 개발할 때 다음 PHP 8.0 기능을 사용할 수 있습니다.

각각의 예시와 플러그인 개발에서 어떻게 사용되는지, 그리고 graphql-api.zip을 생성할 때 어떻게 트랜스파일되는지 살펴보겠습니다.

유니온 타입

코드 예시:

interface CustomPostTypeAPIInterface
{
  public function createCustomPost(array $data): string | int | null | Error;
}

트랜스파일 후:

interface CustomPostTypeAPIInterface
{
  public function createCustomPost(array $data)
}

`mixed` 유사 타입

코드 예시:

interface CMSServiceInterface
{
  public function getOption(string $option, mixed $default = false): mixed;
}

트랜스파일 후:

interface CMSServiceInterface
{
  public function getOption(string $option, $default = false);
}

객체에서의 `::class` 매직 상수

코드 예시:

foreach ($directiveResolvers as $directiveResolver) {
  $directiveResolverName = $directiveResolver->getDirectiveName();
  $this->directiveNameClasses[$directiveResolverName][] = $directiveResolver::class;
}

트랜스파일 후:

foreach ($directiveResolvers as $directiveResolver) {
  $directiveResolverName = $directiveResolver->getDirectiveName();
  $this->directiveNameClasses[$directiveResolverName][] = get_class($directiveResolver);
}

`match` 표현식

코드 예시:

public function getSchemaFieldType(TypeResolverInterface $typeResolver, string $fieldName): ?string
{
  $ret = match($fieldName) {
    'accessControlLists' => TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID),
    'cacheControlLists' => TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID),
    'fieldDeprecationLists' => TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID),
    'schemaConfigurations' => TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID),
    default => parent::getSchemaFieldType($typeResolver, $fieldName),
  };
  return $ret;
}

트랜스파일 후:

public function getSchemaFieldType(TypeResolverInterface $typeResolver, string $fieldName): ?string
{
  switch ($fieldName) {
    case 'accessControlLists':
      $ret = TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID);
      break;
    case 'cacheControlLists':
      $ret = TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID);
      break;
    case 'fieldDeprecationLists':
      $ret = TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID);
      break;
    case 'schemaConfigurations':
      $ret = TypeCastingHelpers::makeArray(SchemaDefinition::TYPE_ID);
      break;
    default:
      $ret = parent::getSchemaFieldType($typeResolver, $fieldName);
      break;
  }
  return $ret;
}

타입만으로 `catch` 예외 처리

코드 예시:

try {
  // ...
} catch (InvalidArgumentException) {
  return sprintf(
    '<p>%s</p>',
    \__('Oops, the documentation for this module is not available', 'graphql-api')
  );
}

트랜스파일 후:

try {
  // ...
} catch (InvalidArgumentException $exception) {
  return sprintf(
    '<p>%s</p>',
    \__('Oops, the documentation for this module is not available', 'graphql-api')
  );
}

Null 안전 연산자

코드 예시:

public function getSchemaDirectiveDeprecationDescription(TypeResolverInterface $typeResolver): ?string
{
  return $this->getSchemaDefinitionResolver($typeResolver)?->getSchemaDirectiveDeprecationDescription($typeResolver);
}

트랜스파일 후:

public function getSchemaDirectiveDeprecationDescription(TypeResolverInterface $typeResolver): ?string
{
  return $this->getSchemaDefinitionResolver($typeResolver) ? $this->getSchemaDefinitionResolver($typeResolver)->getSchemaDirectiveDeprecationDescription($typeResolver) : null;
}

클래스 생성자 프로퍼티 프로모션

코드 예시:

abstract class AbstractEndpointResolver
{
  function __construct(protected EndpointHelpers $endpointHelpers)
  {
  }
}

트랜스파일 후:

 abstract class AbstractEndpointResolver
 {
  /**
   * @var \GraphQLAPI\GraphQLAPI\Services\Helpers\EndpointHelpers
   */
  protected $endpointHelpers;
 
  function __construct(EndpointHelpers $endpointHelpers)
  {
    $this->endpointHelpers = $endpointHelpers;
  }
}

매개변수 목록과 클로저 `use` 목록의 후행 쉼표

코드 예시:

public function resolveFieldTypeResolverClass(TypeResolverInterface $typeResolver, string $fieldName): ?string
{
    switch ($fieldName) {
        case 'accessControlLists':
            return CustomPostTypeResolver::class;
    }
 
    return parent::resolveFieldTypeResolverClass(
        $typeResolver,
        $fieldName,
    );
}

트랜스파일 후:

public function resolveFieldTypeResolverClass(TypeResolverInterface $typeResolver, string $fieldName): ?string
{
    switch ($fieldName) {
        case 'accessControlLists':
            return CustomPostTypeResolver::class;
    }
 
    return parent::resolveFieldTypeResolverClass($typeResolver, $fieldName);
}

🦸🏿‍♂️ Gato GraphQL이 이제 PHP 8.0에서 7.1로 트랜스파일됩니다

뉴스레터 구독하기