PHPStan无法识别CodeIgniter 4内置函数，该如何解决？

问题根源 #

CodeIgniter 4的lang等全局函数是框架启动时通过引导文件动态注册的，而PHPStan作为静态分析工具，不会执行框架的初始化流程，因此无法识别这类动态加载的函数。你之前通过ignoreErrors规避错误只是临时方案，并非根本解决方法。

两种有效解决方式 #

方式一：使用官方PHPStan扩展（推荐）

CodeIgniter 4官方提供了专门的PHPStan扩展，已经内置了所有框架全局函数、类的类型定义，能彻底解决这类静态分析报错：

1. 安装扩展：

   composer require --dev codeigniter4/phpstan-codeigniter4
   

2. 在你的phpstan.neon配置文件中启用扩展：

   includes:
     - vendor/codeigniter4/phpstan-codeigniter4/extension.neon
   

方式二：手动添加函数存根文件

如果不想依赖第三方扩展，可以自己创建函数存根（Stub）来告诉PHPStan函数的签名：

1. 在项目根目录创建ci4-functions.stub.php文件，写入lang函数的定义（仅需签名，无需实现）：

   <?php
   /**
    * 返回指定的语言行内容
    *
    * @param string $line 语言键名
    * @param array $args 替换参数
    * @param string|null $locale 目标语言区域
    * @return string
    */
   function lang(string $line, array $args = [], ?string $locale = null): string {}
   

2. 在phpstan.neon中配置加载这个存根文件：

   parameters:
     stubFiles:
       - ci4-functions.stub.php
   

补充说明 #

PHPStorm不报错是因为它有专门的CodeIgniter插件，内置了框架所有函数、类的元信息，能自动识别这些全局函数，而PHPStan需要显式的类型定义才能识别。

内容的提问来源于stack exchange，提问作者D.B.