如何解决PHPStan报CakePHP FunctionsBuilder未定义date_format方法的问题

以下是几种无需修改vendor目录的PHPStan报错抑制方案：

1. 单行注释临时抑制 #

直接在报错代码行附近添加PHPStan专属注释，精准忽略当前错误：

// @phpstan-ignore-next-line
$query->select(function (FunctionsBuilder $fn) {
    return $fn->date_format($fn->field('created'), '%Y-%m-%d');
});

或者在行尾添加注释：

$fn->date_format($fn->field('created'), '%Y-%m-%d'); // @phpstan-ignore-line

2. 全局配置批量抑制 #

在项目根目录的phpstan.neon（或phpstan.neon.dist）配置文件中，添加全局忽略规则，匹配date_format方法的报错：

parameters:
    ignoreErrors:
        - '#Call to an undefined method Cake\\Database\\FunctionsBuilder::date_format\(\)#'

该方案适合项目中大量使用该自定义函数的场景，一次性解决所有相关报错。

3. 编写PHPStan扩展（进阶优雅方案） #

通过自定义PHPStan扩展，让PHPStan识别date_format方法，而非单纯忽略错误：

1. 创建扩展类文件src/PHPStan/FunctionsBuilderExtension.php：

<?php
namespace App\PHPStan;

use Cake\Database\FunctionsBuilder;
use PHPStan\Reflection\ClassReflection;
use PHPStan\Reflection\MethodReflection;
use PHPStan\Reflection\MethodsClassReflectionExtension;
use PHPStan\Type\MixedType;

class FunctionsBuilderExtension implements MethodsClassReflectionExtension
{
    public function hasMethod(ClassReflection $classReflection, string $methodName): bool
    {
        return $classReflection->getName() === FunctionsBuilder::class && $methodName === 'date_format';
    }

    public function getMethod(ClassReflection $classReflection, string $methodName): MethodReflection
    {
        return new class($classReflection, $methodName) implements MethodReflection {
            public function __construct(private ClassReflection $classReflection, private string $methodName) {}
            public function getDeclaringClass(): ClassReflection { return $this->classReflection; }
            public function getName(): string { return $this->methodName; }
            public function getPrototype(): MethodReflection { return $this; }
            public function isStatic(): bool { return false; }
            public function isPrivate(): bool { return false; }
            public function isPublic(): bool { return true; }
            public function getParameters(): array { return []; }
            public function isVariadic(): bool { return false; }
            public function getReturnType(): \PHPStan\Type\Type { return new MixedType(); }
            public function getDocComment(): ?string { return null; }
            public function getVariadicParameter(): ?\PHPStan\Reflection\ParameterReflection { return null; }
            public function isDeprecated(): bool { return false; }
            public function getDeprecatedDescription(): ?string { return null; }
            public function isFinal(): bool { return false; }
            public function isInternal(): bool { return false; }
            public function getThrowType(): ?\PHPStan\Type\Type { return null; }
            public function hasSideEffects(): bool { return false; }
            public function getTemplateTypeMap(): \PHPStan\Reflection\TemplateTypeMap { return new \PHPStan\Reflection\TemplateTypeMap(); }
            public function getActiveTemplateTypeMap(): \PHPStan\Reflection\TemplateTypeMap { return new \PHPStan\Reflection\TemplateTypeMap(); }
        };
    }
}

2. 在phpstan.neon中注册扩展：

services:
    -
        class: App\PHPStan\FunctionsBuilderExtension
        tags:
            - phpstan.broker.methodsClassReflectionExtension

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