使用PHPUnit运行TYPO3扩展单元测试出现LF常量未定义错误如何解决

• LF是TYPO3核心预定义的全局常量，默认值为"\n"，该常量仅在TYPO3系统引导流程完成后才会被注册，不存在于PHP原生环境中。
• 你看到的报错不是PHPUnit mock代码本身使用了LF，而是被mock的原类\TYPO3\CMS\Core\Page\PageRenderer的源码内部直接引用了LF常量。当PHPUnit执行getMock()方法时，会先加载原类的定义，此时PHP检测到类代码中使用了未定义的常量，就会抛出报错，报错触发时机和你调试时看到的断点行只是类加载的执行节点，和该行代码本身逻辑无关。
• 多环境均触发报错的原因和系统换行规则无关，只要运行测试的PHP环境没有提前注册TYPO3的核心常量，都会触发该错误。

方案1：使用TYPO3官方测试引导（推荐） #

TYPO3官方提供的测试框架已经处理了所有核心常量的预定义逻辑，你只需要在项目的phpunit.xml配置文件中指定官方引导文件即可，参考配置示例：

<?xml version="1.0"?>
<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:noNamespaceSchemaLocation="https://schema.phpunit.de/9.5/phpunit.xsd"
         bootstrap="vendor/typo3/testing-framework/Resources/Core/Build/UnitTestsBootstrap.php">
    <php>
        <env name="TYPO3_PATH_ROOT" value="./"/>
        <env name="TYPO3_PATH_WEB" value="./public"/>
    </php>
    <testsuites>
        <testsuite name="Extension Test Suite">
            <directory>Tests/Unit</directory>
        </testsuite>
    </testsuites>
</phpunit>

确认你的项目已经通过composer安装了typo3/testing-framework依赖即可。

方案2：手动预定义常量（临时适配） #

如果你不需要完整引入TYPO3测试框架，可以在测试执行的最早期阶段提前定义缺失的常量，两种实现方式可选：

1. 在单元测试类的setUp()方法开头添加常量定义代码：

protected function setUp(): void
{
    // 提前定义TYPO3核心换行常量
    defined('LF') ?: define('LF', chr(10));
    defined('CR') ?: define('CR', chr(13));
    defined('CRLF') ?: define('CRLF', CR . LF);
    
    parent::setUp();
    // 其余初始化逻辑
}

2. 自己编写一个简易的测试引导文件，在phpunit.xml中指定该引导文件，将常量定义代码放在引导文件中，全局生效。

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