Typo3 v10自定义扩展开发调用rpc.php出现Class not found报错求助

数据老陈

2026-9-25

问题根因

你直接对外暴露扩展内的独立PHP文件作为接口调用，请求时没有触发TYPO3的核心初始化流程，自动加载器未注册，自然无法加载TYPO3核心的Environment等类，才会抛出类未找到的致命错误。

推荐解决方案（官方标准实现，兼容性、安全性更高）

使用TYPO3 v10及以上版本支持的自定义中间件实现接口能力：

在你的扩展目录下新建Configuration/RequestMiddlewares.php，注册自定义接口的路由规则，示例配置：

return [
    'frontend' => [
        'gpi/rpc-endpoint' => [
            'target' => \GlobalizationPartnersInternational\Gpi\Middleware\RpcMiddleware::class,
            'path' => '/api/gpi-rpc',
        ]
    ]
];

新建对应的中间件类，把你原来rpc类里的业务逻辑迁移到中间件的process方法中，此时TYPO3核心已完成初始化，所有核心类都可以正常调用。
前端jQuery调用的接口地址改为你注册的中间件路径即可，比如http://localhost/typo3/api/gpi-rpc。

临时兼容方案（不推荐，安全风险较高）

如果你要保留原有的独立rpc.php文件结构，可在文件最开头手动引入TYPO3引导文件完成核心初始化，添加代码如下（注意根据你的文件实际路径调整层级）：

<?php
// 加载TYPO3核心引导文件，路径需要根据你rpc.php的位置调整，下面的示例适配你给出的文件路径
require_once dirname(__DIR__, 4) . '/vendor/autoload.php';
\TYPO3\CMS\Core\Core\Bootstrap::init();

namespace GlobalizationPartnersInternational\Gpi\Models\Tsc;

class rpc{
    // 原有逻辑不变
}