Fat-Free Framework中POST API请求无法接收数据问题排查

核心问题梳理 #

从你提供的代码来看，问题集中在请求发送端的格式错误和控制器的方法调用逻辑错误两方面，具体如下：

一、请求发送代码的错误 #

1. 变量名不匹配：定义了$dataContainers数组，但调用http_build_query($data)时使用了未定义的$data变量，导致发送内容为空。
2. Content-Type与发送格式不符：请求头声明了Content-Type: application/json，但实际发送的是http_build_query生成的URL编码字符串，而非JSON格式。
3. URL路径错误：file_get_contents('/api/packer/containers')使用相对路径会尝试读取本地文件，而非发送HTTP请求到API接口，需改为完整URL（如http://localhost/api/packer/containers）。
4. 屏蔽错误信息：@file_get_contents会抑制所有错误，无法排查请求失败的具体原因，应去掉@符号。

修复后的请求代码：

$dataContainers = [
    'type' => 1, 
    'units' => 1, 
    'container' => 1,
];

// 将数组转为JSON字符串，匹配Content-Type
$jsonContent = json_encode($dataContainers);

$options = ['http' => [
    'method' => 'POST',
    'header' => 'Content-Type: application/json; charset=utf-8',
    'content' => $jsonContent,
    'timeout' => 10, // 添加超时便于调试
],];

$context = stream_context_create($options);

// 使用完整URL，去掉@以显示错误信息
$response = file_get_contents('http://localhost/api/packer/containers', false, $context);

// 打印响应和错误详情
var_dump($response);
var_dump(error_get_last());

二、控制器代码的错误 #

1. 方法调用错误：路由配置指定调用setContainers方法，但你把处理逻辑写在__construct构造函数中，Fat-Free Framework不会将构造函数作为路由处理方法执行。
2. 响应输出错误：控制器方法中使用return json_encode($post)无法自动输出响应，需直接echo内容；同时推荐使用框架的HEADERS设置方法，而非原生header()函数。

修复后的控制器代码：

class PackerApiController
{
    public function setContainers($f3, $params)
    {
        // 通过框架获取原始请求体并解析为JSON
        $post = json_decode($f3->get('BODY'), true);
        
        // 使用框架设置响应头
        $f3->set('HEADERS.Cache-Control', 'no-cache, must-revalidate');
        $f3->set('HEADERS.Expires', 'Mon, 26 Jul 1997 05:00:00 GMT');
        $f3->set('HEADERS.Content-Type', 'application/json; charset=utf-8');
        
        // 输出JSON响应
        echo json_encode($post);
    }
}

三、路由配置 #

你的路由配置是正确的，无需修改：

POST /api/packer/containers = App\Controller\Packer\PackerApiController->setContainers

内容的提问来源于stack exchange，提问作者Jarosław Bielawski