PHP无法直接调用原生TensorFlow模型，仅支持通过FFI加载TensorFlow Lite（.tflite）模型，且需满足PHP≥8.1、启用ext-ffi、安装libtensorflowlite_c.so v2.15.0+；推荐采用FastAPI等HTTP服务方式调用Python推理，更稳定可控。
别装 tf.so 或 pecl install tensorflow —— 这些扩展在 PHP 8.1+ 上基本不可用，且只支持已淘汰的 TF 1.x，模型加载会直接失败。
PHP 直接调用 TensorFlow C API（FFI 方式）行不行？
可以，但仅限于 TensorFlow Lite 模型，且必须满足三个硬条件：PHP ≥ 8.1、ext-ffi 启用、系统已安装 libtensorflowlite_c.so v2.15.0+。原生 TensorFlow（非 Lite）的 C API 没有稳定公开接口，FFI 绑定极易因 ABI 变更崩溃。
常见错误现象：FFI\IOException: cannot resolve symbol 'TfLiteInterpreterCreate' 或预测结果全为零 —— 多半是动态库版本不匹配或模型未正确量化。
- 模型必须是
.tflite格式，且推荐用 INT8 量化（FP32 在 PHP 环境下内存占用高、推理慢） -
FFI::cdef()中的 struct 声明必须与你本地tensorflow/lite/c/c_api.h完全一致，不能抄网上过时示例 - 输入 tensor 的 shape 和 data type 必须严格匹配模型签名，
TfLiteInterpreterGetInputTensor()后要手动调用TfLiteTensorCopyFromBuffer()，漏掉这步就永远得不到正确输出
为什么 exec("python predict.py") 容易卡死或返回空？
因为 PHP 默认不处理子进程的 stdio 编码和缓冲区，尤其当 Python 脚本 print 了中文、用了 logging、或模型加载耗时超过默认超时，shell_exec() 就会静默截断或阻塞。
立即学习“PHP免费学习笔记（深入）”；
- 必须显式设置
env和cwd，避免 Python 找不到numpy或模型路径解析错误 - 用
proc_open()替代shell_exec()，才能分别捕获stdout、stderr并设timeout - Python 端必须用
sys.stdout.buffer.write(json.dumps(...).encode("utf-8"))，不能依赖 print() 自动 flush - PHP 接收后要检查
$return_code，不是只看$output !== false
用 FastAPI 启服务是不是太重？
不重。一个最小 FastAPI + TensorFlow Keras 服务，Docker 镜像约 480MB，启动后常驻内存 320MB 左右，比反复 fork Python 子进程更省资源、更可控。
关键点在于模型只加载一次，且可复用连接：
- Python 服务启动时加载模型，
@app.post("/predict")里不做load_model() - PHP 用
curl_init()复用 handle，设置CURLOPT_TCP_KEEPALIVE避免频繁握手 - 务必校验响应头
Content-Type: application/json和状态码，file_get_contents()对 500 错误会返回空字符串，不是false - 模型路径写绝对路径，比如
/opt/models/resnet50.tflite，不要用__DIR__ . "/model.tflite"
真正容易被忽略的是错误传播链：PHP 发起请求 → FastAPI 解析 JSON → TensorFlow 输入预处理 → 模型 infer → 输出后处理 → 返回 JSON。其中任意一环出错（比如输入 shape 不对、dtype 不匹配、输出没 .tolist()），都会变成 500 或空响应，而日志分散在两个进程里。调试时得同时看 PHP error_log 和 uvicorn 的 stderr 输出。
