升级PHP到8.1后Drupal GraphQL模块出现废弃函数警告求助

问题根源 #

PHP 8.0及以上版本对接口方法的返回类型校验更严格，Drupal\graphql\Plugin\TypePluginManagerAggregator类实现了IteratorAggregate接口，但类中的getIterator()方法既没有声明符合接口要求的返回类型Traversable，也未添加#[\ReturnTypeWillChange]属性，因此触发废弃函数警告。

临时修复（快速解决） #

直接修改/code/web/modules/contrib/graphql/src/Plugin/TypePluginManagerAggregator.php文件，二选一即可：

方案1：声明正确的返回类型 #

在方法头部添加返回类型声明，同时确保引入Traversable类：

use Traversable;

// ...

public function getIterator(): Traversable {
  return $this->manager->getIterator();
}

方案2：添加抑制警告属性 #

给getIterator()方法添加#[\ReturnTypeWillChange]属性，临时屏蔽警告：

#[\ReturnTypeWillChange]
public function getIterator() {
  return $this->manager->getIterator();
}

长期修复方案 #

• 检查GraphQL模块的官方更新，官方通常已修复PHP 8.x的兼容性问题，直接升级到最新稳定版即可
• 升级前务必备份代码与数据库，避免引发其他兼容性问题

内容的提问来源于stack exchange，提问作者Jasbir