PHP怎么处理百度智能云CFC_PHP百度云函数计算平台【介绍】-php教程-PHP中文网

PHP在百度智能云函数计算（CFC）中仅支持7.2版本，不支持8.x系列；必须使用handler函数作为入口，兼容7.2语法与扩展，适用于轻量无状态任务。

php怎么处理百度智能云cfc_php百度云函数计算平台【介绍】

PHP 在百度智能云函数计算（CFC）中支持有限，实际使用前必须确认运行时版本和限制条件。

CFC 当前明确支持的 PHP 运行时只有 php 7.2，且不支持任何其他 PHP 版本（如 8.x、8.1、8.2 等）。官方文档未提及后续扩展计划，截至 2026 年 4 月仍维持该现状。

`php 7.2` 是唯一可用的 PHP 运行时

CFC 控制台创建函数时，“运行时”下拉菜单中仅出现 php 7.2 选项，选其他语言或版本会直接报错或不可见
尝试上传含 php 8.0 语法（如属性类型声明、match 表达式）的代码会导致冷启动失败，日志中出现类似 Parse error: syntax error 的错误
php 7.2 已于 2020 年 11 月停止官方支持，缺少现代 PHP 的安全补丁和函数（如 str_contains()、get_debug_type()）

建议做法：

所有代码必须兼容 php 7.2 语法和扩展
避免依赖 Composer 包中要求 PHP ≥7.3 的组件（例如 Laravel 9+、Symfony 6+）
若需 JSON 处理，用 json_encode() 和 json_last_error()，不要假设 JSON_THROW_ON_ERROR 常量存在（它在 7.3+ 引入）

PHP 函数入口必须是 `handler` 函数

CFC 不执行 index.php 或自动加载 public/index.php，而是强制调用一个名为 handler 的全局函数：

函数签名固定为：function handler($event, $context) { ... }
$event 是触发事件的原始数据（如 HTTP 请求体、BOS 事件、定时器 payload），类型为 array 或 string，需自行判断
$context 包含运行时信息（$context['requestId']、$context['functionName']、$context['memoryLimitInMB'] 等），但没有 $_SERVER 或 $_GET

常见错误：

百度文档解析vlm-parser

调用百度PaddleOCR‑VL大模型API，支持PDF、Word、PPT、图片等多格式文档解析，精准识别印刷体、手写体、表格、公式、图表、印章等复杂元素，支持100+语言，可处理不规则布局和跨页长文档。触发词：文档解析、VLM解析、大模型OCR、PaddleOCR、多模态文档、手写识别、公式识别、复杂版面。

下载

直接写 echo "hello" 不会返回 HTTP 响应（Web 函数需手动构造 JSON 返回）
忘记 return 导致函数返回 null，HTTP 触发器返回 502 错误
把 handler 写成类方法或匿名函数，CFC 启动时抛出 Function handler not found

正确示例（HTTP 触发器）：

function handler($event, $context) {
    $body = json_encode(['message' => 'ok', 'time' => date('c')]);
    return [
        'isBase64Encoded' => false,
        'statusCode' => 200,
        'headers' => ['Content-Type' => 'application/json'],
        'body' => $body
    ];
}

错误不会自动转为 HTTP 状态码，必须显式处理

PHP 运行时捕获异常后，CFC 默认返回 502（Bad Gateway）并附带堆栈，但不区分业务错误与系统错误。

throw new Exception("not found") 和 trigger_error("config missing", E_USER_ERROR) 都导致同样错误响应
没有类似 Laravel 的异常渲染层，也无 set_exception_handler 的可靠钩子（部分版本中会被忽略）
日志中能看到完整错误，但调用方无法感知语义（比如 404 vs 500）

稳妥做法：

所有逻辑包裹在 try/catch 中
对已知业务异常（如参数缺失、资源不存在），返回明确的 statusCode 和结构化 body
避免在 handler 外定义全局 error_handler，CFC 的错误捕获机制优先级更高，容易覆盖失效

PHP 在 CFC 中本质是“受限的脚本执行环境”，不是完整 Web Server。如果你需要路由、中间件、ORM 或现代 PHP 特性，应该考虑迁移到自定义运行时（如 node.js 22 + Express）或直接使用百度云的 BCC（云服务器）部署。CFC 的 PHP 支持只适合轻量、一次性、无状态的胶水逻辑，比如解析 BOS 文件、清洗消息队列内容、简单回调通知。