Composer不能直接安装React组件，因其仅管理PHP包；React属JavaScript生态，需通过npm管理，再用limenius/react-renderer等PHP桥接包调用Node.js执行SSR。
PHP后端本身不直接渲染UI组件，但可以通过Composer管理用于服务端渲染（SSR）或桥接前端组件的工具链——关键不是“装UI组件”，而是装能让你在PHP上下文中安全调用、预渲染、或与React/Vue等交互的中间层包。
为什么不能直接用Composer装React组件？
Composer只管理PHP代码包，而React/Vue组件是JavaScript生态产物。你无法通过composer require react/react安装一个可运行的React组件；强行把JS文件丢进vendor/会导致路径混乱、无构建流程、无法解析ES模块或JSX。
真正可行的路径是：用Composer引入能“桥接”PHP与JS组件的PHP封装层，比如limenius/react-renderer，它内部依赖Node.js环境执行JS，但对外暴露PHP接口。
- 错误做法：把
node_modules/整个复制进vendor/，再手动require JS文件 → PHP会报ParseError: syntax error, unexpected token - 正确思路：Composer只管PHP侧胶水代码，JS部分由npm/yarn管理，二者通过约定路径（如
build/server-bundle.js）通信 - 必须确保服务器上装有Node.js且PATH可达，否则
PhpExecJsReactRenderer会抛出exec(): Unable to fork
如何用composer require limenius/react-renderer实现SSR？
这个包不是“UI组件库”，而是让PHP能调用Node.js执行React组件并返回HTML字符串的执行器。它要求你同时维护两套构建逻辑：PHP侧加载+JS侧打包。
立即学习“PHP免费学习笔记（深入）”；
- 先运行：
composer require limenius/react-renderer，它会装入vendor/并注册自动加载 - JS端需额外用npm安装
react-on-rails，并按其文档导出服务端入口（如RecipesAppServer.js），最终打包为单个.js文件供PHP调用 - PHP中实例化渲染器时，必须指定该JS文件的绝对路径：
new PhpExecJsReactRenderer('/var/www/myapp/build/server-bundle.js') - 若JS bundle里用了ES6+语法或动态import()，需确认Node.js版本≥14，否则
eval()会失败
遇到“ReferenceError: window is not defined”怎么办？
这是最常卡住的点：你在JS里写了只适用于浏览器环境的代码（比如访问window、document或使用localStorage），但服务端渲染时没有DOM全局对象。
- 不要在服务端入口组件里直接调用
window.location之类 —— 这类逻辑应移到componentDidMount或useEffect中（客户端hydrate阶段才执行） - 检查所有第三方React UI库（如Ant Design、Material-UI）是否标明支持SSR；不支持的需包裹
if (typeof window !== 'undefined')条件判断 -
limenius/react-renderer默认用exec()启动子进程运行Node.js，错误堆栈不会自动映射回原始JS行号，建议先用node server-bundle.js手动测试JS bundle能否独立运行
生产环境部署时容易漏掉什么？
本地跑通不等于线上可用。SSR对运行时环境敏感，尤其容易忽略Node.js版本、权限、路径和超时设置。
- Web服务器（如Apache/Nginx）运行PHP的用户（如
www-data）必须有权限执行node命令，且node --version输出要与开发机一致 - JS bundle路径不能写相对路径（如
../build/...），必须用__DIR__或realpath()转成绝对路径，否则CLI和Web请求下getcwd()不同会导致file not found - 默认超时是30秒，如果JS bundle启动慢或React组件初始化耗时长，需显式设置：
$renderer->setTimeout(60) - 别把
node_modules/上传到生产服务器 —— 它应该在部署流程中由CI单独npm install --production生成
真正难的从来不是装哪个包，而是厘清PHP和JS各自的职责边界：PHP负责路由、数据组装、调用渲染器；JS负责组件定义、状态管理、客户端交互。跨过这个认知门槛，Composer才不只是个下载器，而是前后端协作的契约锚点。
