TYPO3扩展开发自定义rpc.php调用核心类提示Class not found如何解决

问题原因 #

你直接访问独立的rpc.php文件时，没有加载TYPO3的自动加载机制与核心运行上下文，因此无法识别TYPO3核心类、自定义扩展类，最终触发Class not found错误。

可行解决方案 #

方案1：遵循TYPO3规范开发（推荐） #

不要使用独立的PHP文件作为入口，将你的RPC逻辑整合到TYPO3标准的控制器中，TYPO3会自动完成类加载与上下文初始化：

• 如果是供后端调用的逻辑，可以注册为后端模块控制器
• 如果是供外部接口调用的逻辑，可以注册为前端插件控制器或者TYPO3中间件
• 如果是命令行调用的逻辑，可以注册为CLI命令控制器

方案2：独立文件手动加载TYPO3上下文 #

如果必须保留rpc.php作为独立入口，需要在文件开头手动引入TYPO3的引导流程，代码示例如下：

<?php
// 定义TYPO3运行模式，BE代表后端上下文
define('TYPO3_MODE', 'BE');

// 引入TYPO3根目录的composer自动加载文件，路径根据你实际的文件层级调整
$classLoader = require __DIR__ . '/../../vendor/autoload.php';

// 启动TYPO3核心引导
\TYPO3\CMS\Core\Core\Bootstrap::init($classLoader)
    ->get(\TYPO3\CMS\Core\Core\SystemEnvironmentBuilder::class)
    ->defineBaseConstants();

其他需要修正的问题 #

1. 自动加载配置：你的自定义类需要添加符合PSR-4规范的命名空间，同时在扩展的composer.json中配置自动加载规则，示例配置：

{
  "autoload": {
    "psr-4": {
      "你的扩展命名空间\\": "Classes/"
    }
  }
}

配置完成后执行composer dump-autoload更新自动加载缓存，同时清除TYPO3后台缓存。

2. 代码语法修正：你现有代码存在多处逻辑错误：

• ->execute改为->execute()，execute是方法需要加括号调用
• where条件需要使用参数绑定避免SQL注入，示例：

->where(
  $queryBuilder->expr()->eq('config_name', $queryBuilder->createNamedParameter('tsc_Endpoint'))
)

• GeneralUtility::makeInstance(JsonRpc::class)->__construct($client)写法错误，makeInstance会自动调用构造方法，不需要手动执行__construct，直接传参即可：

$server = GeneralUtility::makeInstance(JsonRpc::class, $client);

• 代码中用到的GpiClient、JsonRpc类需要添加对应的use引入，或者写全限定类名。

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