Node.js 无法直接调用 PHP 函数，必须通过 IPC 协作：常用 child_process.spawn 启动 CLI 脚本（需可执行权限、JSON 输出）；高并发宜用长连接子进程池或 HTTP 桥接（php -S）；须严控输出、编码、错误码与超时，否则生产环境易崩溃。
Node.js 无法直接调用 PHP 函数，因为两者运行在完全隔离的运行时环境中，没有共享内存或原生函数导出机制。必须通过进程间通信（IPC）间接协作。
用 child_process.spawn 启动 PHP CLI 脚本最常用
这是最轻量、低延迟的方式，适合短时任务（如数据校验、模板渲染、调用已有 PHP 工具类）。
- PHP 脚本必须以
#!/usr/bin/env php开头或显式用php命令执行，且需有可执行权限（chmod +x） - 参数通过
argv传入，结果建议用echo json_encode($result)输出，Node.js 用stdout.on('data')接收并JSON.parse - 错误不要只依赖
stderr：PHP 脚本里需主动exit(1)，Node.js 监听close事件的code和signal判断是否异常退出 - 避免在循环中频繁 spawn：PHP 解释器启动开销大，可改用长生命周期子进程 + STDIN/STDOUT 流式通信，或加进程池（如
worker_threads管理多个php实例）
HTTP 桥接（PHP 启 HTTP Server）适合复杂逻辑或需状态保持场景
当 PHP 侧需要 Session、数据库连接复用、或已有 Web API 时，比子进程更合理。
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
- PHP 不必写完整框架，用
php -S localhost:8000 router.php即可启动内置服务器 - Node.js 用
fetch或axios请求，注意超时设置（默认可能无限等待），例如timeout: 5000 - PHP 的
router.php需解析$_GET或file_get_contents('php://input')处理 JSON body，别漏掉 CORS 头（开发期）或反向代理配置（生产期） - 本地 HTTP 调用比子进程慢约 2–10ms，高并发下容易成为瓶颈；务必加连接池或限流（如
axios-rate-limit）
常见错误：PHP 脚本输出不可控导致 Node.js JSON.parse 失败
PHP 默认开启 output_buffering，且 var_dump、print_r、BOM、Warning 信息都会混入 stdout，让 JSON 解析直接抛错。
立即学习“PHP免费学习笔记（深入）”；
- Node.js 侧先做
Buffer.concat(chunks).toString().trim()再解析，避免换行/空格干扰 - PHP 侧开头加
ob_end_clean(); error_reporting(0); ini_set('display_errors', '0'); - 强制 UTF-8 输出：
header('Content-Type: application/json; charset=utf-8');（HTTP 方式）或mb_internal_encoding('UTF-8');（CLI 方式） - 调试时临时加
file_put_contents('/tmp/php-debug.log', print_r($GLOBALS, true), FILE_APPEND);查看真实输出
真正难的不是调通，而是错误边界处理——PHP 进程崩溃、HTTP 服务宕机、JSON 格式漂移、字符编码错位，这些在本地测试时全不出现，一上生产就集体爆发。
