rsc 是 react server components，非 php 框架，php 项目无法直接兼容，需通过反向代理分离、混合网关、headless cms 或 webassembly 等方式重构为 rsc 架构。
RSC 是 React Server Components 的缩写，它并非 PHP 框架，而是一种由 React 官方提出的、运行在服务端的组件模型，用于构建服务端渲染（SSR）和流式响应的现代 Web 应用。PHP 项目本身与 RSC 无直接兼容性，因为 RSC 依赖于 React 生态、Node.js 运行时、支持服务端组件的框架（如 Next.js 13+ 或 Remix 配合适配器），而非 PHP 执行环境。将 PHP 项目“迁移”至 RSC 并非框架替换，而是**应用架构层面的重写与技术栈重构**。以下是实现该目标的几种可行路径：
一、通过反向代理+渐进式前端分离
该方式保留原有 PHP 后端作为 API 提供者，将用户界面完全交由基于 RSC 的新前端接管，实现逻辑解耦与分阶段过渡。核心在于隔离渲染职责，避免一次性重写全部业务。
1、在 Nginx 或 Apache 中配置反向代理规则，将 /api/ 路径转发至 PHP 应用服务器，其余路径指向 Next.js 应用服务。
2、使用 PHP 的 Slim 或 Laravel API 模式，为关键业务模块（如用户登录、订单查询）提供符合 REST 或 GraphQL 规范的 JSON 接口。
立即学习“PHP免费学习笔记（深入）”；
3、在 Next.js 应用中创建 server components，通过 fetch 调用上述 PHP 接口获取数据，并在服务端完成初始渲染。
4、对 PHP 项目中的模板文件（如 .php 视图）进行标记归档，不再新增逻辑，仅维持现有接口稳定性。
二、构建混合渲染网关层
引入中间网关服务（如使用 Express 或 Fastify 编写的 Node.js 层），统一接收请求，按路由策略决定由 PHP 后端直出 HTML，或交由 RSC 渲染引擎处理。该方案适用于需长期共存两种渲染模式的遗留系统。
1、部署独立 Node.js 网关服务，监听 3000 端口，配置 CORS 与 cookie 共享策略以支持跨域会话透传。
2、定义路由匹配规则：例如 /dashboard/** 路由交由 Next.js App Router 处理；/legacy/** 路由则 proxy_pass 至 PHP-FPM。
3、在网关中注入共享 session 中间件，读取 PHP 写入的 session 文件或 Redis 存储，将其转换为 JWT 或加密 cookie 供 RSC 组件验证身份。
4、使用 React Server Components 不支持 useState、useEffect 等客户端钩子，因此所有需交互的区域（如表单提交）必须封装为 Client Components，并显式添加 'use client' 指令。
三、PHP 后端封装为 Headless CMS
将 PHP 项目降级为纯内容与数据管理服务，剥离所有视图逻辑与路由控制，使其退化为结构化数据源。RSC 应用通过 HTTP 请求消费其输出，彻底解除对 PHP 渲染能力的依赖。
1、停用 PHP 模板引擎（如 Twig、Blade），修改控制器返回纯 JSON 响应，确保 Content-Type 为 application/json。
2、为每类实体（文章、产品、分类）设计标准化 API 端点，例如 GET /wp-json/myplugin/v1/posts?id=123，响应字段包含 title、content、featured_image 等可序列化属性。
3、在 Next.js 中创建 async server component，使用 fetch 获取 PHP 接口数据，并通过 React.createElement 动态生成页面结构。
4、PHP 返回的富文本内容必须经由 DOMPurify 或 next-safe-svgs 进行 XSS 过滤后方可使用 dangerouslySetInnerHTML。
四、使用 WebAssembly 运行 PHP 运行时（实验性）
借助 PeachPie 或 PHP-WASM 等项目，将 PHP 字节码编译为 WebAssembly 模块，在 Node.js 环境中加载执行。此路径技术门槛极高，仅适用于极少数需复用复杂 PHP 业务逻辑且无法重构的场景。
1、使用 PeachPie CLI 将 PHP 项目编译为 .dll 文件，再通过 wasm-pack 构建为 WebAssembly 包。
2、在 Next.js 的 server action 或 Route Handler 中，通过 WASI 或自定义 host binding 加载并调用 PHP 函数。
3、配置 Vercel 或自托管 Node.js 服务启用 WASI 支持，确保 process.env.NODE_OPTIONS 包含 --experimental-wasi-unstable-preview1。
4、当前 PeachPie 对 $_SESSION、cURL 多部分上传、GD 图像处理等扩展支持不完整，关键功能需手动补丁。
