🦸🏿‍♂️ Gato GraphQL теперь транспилируется с PHP 8.0 до 7.1

Некоторое время назад я написал о том, что такое транспиляция PHP-кода:

Транспиляция PHP-кода позволяет использовать новейшие возможности PHP при разработке, но выпускать плагин с кодом, конвертированным в более старую версию PHP для продакшена, чтобы охватить более широкую аудиторию пользователей.

Последние несколько недель я занимался дальнейшей доработкой этого процесса для плагина Gato GraphQL.

Рад сообщить, что отныне минимально требуемая версия PHP была повышена до PHP 8.0:

Обновление до минимальной версии PHP 8.0

Поскольку плагин теперь может рассчитывать на PHP 8.0, мне удалось завершить добавление типов ко всем свойствам во всех PHP-классах кодовой базы, включая union types.

Превосходно!

Вот краткое описание всех новых возможностей PHP 8.0, доступных при разработке плагина.

Новые возможности PHP 8.0

При разработке Gato GraphQL теперь доступны следующие возможности PHP 8.0:

Рассмотрим пример каждой из них: как они используются в плагине при разработке и во что транспилируются при генерации graphql-api.zip.

Union types

Пример кода:

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-safe оператор

Пример кода:

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

Подпишитесь на нашу рассылку