node.js 无法直接调用 php 数据库逻辑，需通过 http 接口协作；推荐 php 暴露 rest api（pdo 预处理+json 响应），node.js 用 fetch 请求并严格校验状态码、响应类型与 json 结构，配合 typescript 类型守卫和契约测试保障稳定性。
Node.js 不能直接调用 PHP 的数据库连接逻辑，所谓“Node.js 连 PHP”本质是进程间协作，不是语言内联互通。最可行、最轻量的方案是让 PHP 暴露 HTTP 接口，Node.js 用 fetch 或 axios 请求；其次是通过文件或 Redis 共享查询结果，但实时性和一致性难保障。
PHP 必须提供 REST 接口（不是直接 include 或 exec）
常见误区是尝试用 child_process.exec('php query.php') 执行 PHP 脚本并解析 stdout —— 这在简单场景能跑通，但一旦涉及错误处理、连接池复用、SQL 注入防护、字符编码（如中文乱码）、超时控制，就迅速失控。
- PHP 端应使用现代框架（如 Slim、Laravel Zero）或至少原生
$_GET/$_POST+ PDO 预处理，返回 JSON - 必须设置响应头：
header('Content-Type: application/json; charset=utf-8'); - 禁止拼接 SQL：
$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");，而非"WHERE id = ".$_GET['id'] - 接口路径建议统一前缀，如
/api/v1/users，避免暴露.php后缀（可通过 Nginx 重写隐藏）
Node.js 请求时要处理 PHP 接口的典型失败点
PHP 接口看似返回 200，实际可能是 HTML 错误页（如 500 页面被 PHP 输出）、JSON 格式错误（多了一个逗号、UTF-8 BOM）、或字段名大小写不一致（PHP 默认下划线命名，Node.js 常用驼峰），这些都会导致 res.json() 抛错。
- 始终检查
res.status是否在 200–299 范围，不要只依赖ok - 用
res.headers.get('content-type')?.includes('json')初步判断响应类型 - 捕获
JSON.parse异常，打印原始res.text()内容辅助调试 - 若 PHP 返回
{"code":0,"data":[...]}，Node.js 不要假设data总存在，需做res.data?.length >= 0类型守卫
别忽略跨域与部署耦合问题
开发时 localhost:3000 访问 localhost:8000 的 PHP 接口，会触发 CORS；上线后若 Node.js 和 PHP 不在同一台机器，还要考虑网络延迟、DNS 解析、防火墙策略。
立即学习“PHP免费学习笔记（深入）”；
- PHP 接口必须明确设置 CORS 头：
header('Access-Control-Allow-Origin: https://your-node-app.com');，生产环境禁用* - Node.js 中避免硬编码 PHP 地址，用环境变量：
process.env.PHP_API_BASE_URL || 'http://localhost:8000' - 加一层简单的重试逻辑（如 408/502/503 时 retry 1 次），比让前端反复刷新更实用
- 如果 PHP 接口响应慢（>500ms），Node.js 不应同步阻塞等待，而应设
signal: AbortSignal.timeout(3000)
真正的难点不在“怎么连”，而在“连上之后如何信任对方的数据结构和稳定性”。PHP 接口一旦变更字段或状态码，Node.js 很可能静默失败；建议用 TypeScript 定义 PHP 返回的 interface，并在 CI 中对 PHP 接口做契约测试（比如用 Postman Collection + Newman 验证 JSON Schema）。
