LangGraph 的 PHP 平替怎么选,六个方案和它们的真实取舍

想在 PHP 里做 LangGraph 那种有状态、可循环、可恢复的 Agent 工作流,目前能选的方案不止一个。PHP 生态已经出现了原生实现、Laravel 适配包和直接移植的 PHP SDK,它们都围绕一个目标,把 Agent 编排留在 PHP 技术栈里。和 Python 版 LangGraph 比,PHP 方案在技术栈统一和业务系统集成上占优,在生态成熟度和高级状态管理上还有差距。

PHP 里能直接跑 LangGraph 吗

不能直接跑 Python 版 LangGraph。PHP 生态目前给出的做法是在 PHP 技术栈内重新实现或适配图编排能力。Python 侧 LangGraph 的安装命令如下。

pip install -U langgraph

PHP 方案各自有包管理方式,下面只比较能力和取舍。对标 LangGraph 的能力包括多代理协作、人机协同、状态持久化、RAG、工具包、循环图、数据库和队列驱动执行,以及检查点机制。

六个 PHP 平替方案,按技术栈和任务挑

如果你在 Laravel 里,优先看 LaraGraph;如果需要跨框架和完整 Agent 能力,优先看 Neuron AI。其余四个方案分别覆盖直接移植、图工作流、极简学习和 Pest 风格。先看表格,再看每个方案的适用边界。

方案 类型 核心特点 适用场景
Neuron AI 框架无关的完整 Agentic 框架 PHP 生态中最完整的对标方案,提供多代理协作、人机协同、状态持久化、RAG 及内置工具包。 需要跨框架(Laravel/Symfony/原生 PHP)构建复杂生产级 Agent 系统的团队。
LaraGraph Laravel 原生包 专为 Laravel 设计,将 LangGraph 的循环图适配到 PHP 的无状态架构,完全由数据库和队列驱动执行。 已在用 Laravel 技术栈,希望深度集成 Eloquent、队列等原生能力的项目。
langgraph/langgraph-php 直接移植的 PHP SDK 对 Python LangGraph 概念的直译实现,包含 StateGraph、节点、边、检查点(Checkpointing)等核心组件。 熟悉 LangGraph 概念,希望在 PHP 中获得类似 API 体验的开发者。
Nexus AI Workflows 图工作流编排引擎 提供流畅的 WorkflowBuilder API,支持 8 种节点类型(条件、循环、并行、子工作流等),以及可恢复执行、中间件和可观测性。 需要精细控制工作流结构,并希望有完善中间件和事件系统的复杂流程。
PocketFlow PHP 极简主义图框架 仅约 400 行纯 PHP 代码,框架无关,零冗余,提供最核心的图执行、节点和流抽象。 追求极致轻量、希望自行掌控一切依赖和扩展的开发者,或作为学习图编排概念的起点。
Pagent Pest 风格的 Agent 框架 提供流畅的 Agent 配置 API,内置自动工具调用、多代理工作流、评估和 OpenTelemetry 追踪。 偏好类似 Pest 的声明式、流畅 API 风格,且需要内置评估和追踪能力的团队。

Neuron AI 适合做企业级复杂 Agent 系统。它的能力覆盖最全,跨框架使用,和现有 PHP 应用可以放在一起跑,直接访问本地 ORM 和 Redis,避免跨服务延迟。

LaraGraph 适合 Laravel 项目。它把循环图适配到 PHP 的无状态架构,每个节点作为独立队列任务执行,并发处理和水平扩展依赖 Laravel 的数据库和队列体系。

langgraph/langgraph-php 适合已经熟悉 LangGraph 概念的人。StateGraph、节点、边、检查点这些组件有直接对应的 PHP 实现,迁移概念成本低。

Nexus AI Workflows 适合工作流结构复杂的项目。条件、循环、并行、子工作流等节点类型,加上可恢复执行、中间件和可观测性,适合需要精细控制的流程。

PocketFlow PHP 适合追求轻量和控制权的人。约 400 行纯 PHP,框架无关,只保留图执行、节点和流的核心抽象,其余依赖和扩展由开发者自己决定。

Pagent 适合偏好声明式 API 的团队。Pest 风格配置,内置自动工具调用、多代理工作流、评估和 OpenTelemetry 追踪。

和 Python LangGraph 比,PHP 方案的优势

PHP 方案最实在的优势是技术栈统一,团队不用为了 Agent 编排切到 Python。

Agent 与业务逻辑可以共用同一套代码库和部署流程。数据库、缓存、鉴权、中间件都在原来的 PHP 体系里,开发、调试和上线不需要跨语言环境。对于已经在 PHP 里跑核心业务的项目,这个差别会直接反映在维护成本上。

与现有系统深度集成也是 PHP 方案的强项。LaraGraph 完全基于 Laravel 的数据库和队列系统驱动,每个节点作为独立的队列任务执行,天然具备并发处理和水平扩展能力。Neuron AI 强调与现有 PHP 应用的“同居”能力,可直接访问本地 ORM 和 Redis,避免跨服务延迟。

团队上手成本更低。PHP 工程师用熟悉的语言和模式构建 Agent,学习曲线远低于转向 Python 生态。Neuron AI 的设计目标之一就是让上手成本“几乎为 0”。

PHP 方案的短板

短板集中在生态和高级能力,不在能不能跑通基本工作流。

生态成熟度和社区规模仍有差距。Python 生态的 LangGraph 拥有更庞大的社区、更丰富的集成和更广泛的商业采用。PHP 方案起步较晚,整体生态仍在建设之中,可参考的案例和第三方扩展相对有限。

功能深度和高级抽象还在追赶。LangGraph 在长流程状态管理、精细的流式输出控制和与 LangChain 生态的无缝集成方面积累更深。PHP 方案在状态持久化的粒度、检查点机制的完善程度上,目前还处于追赶阶段。

人才储备是另一个现实问题。熟悉 Python AI 生态的开发者数量远多于熟悉 PHP AI 框架的开发者,这可能在招聘和团队扩展时带来挑战。

怎么选

按你的框架、任务复杂度和团队偏好选,不要只看功能列表长度。

  • 在 Laravel 生态中,LaraGraph 是集成度最高的选择,能把工作流融入熟悉的队列和数据库体系。
  • 需要更全面的 Agent 能力,比如内置 RAG 和工具包,Neuron AI 也完全兼容 Laravel。
  • 需要跨框架或构建复杂企业级 Agent 系统,Neuron AI 是目前 PHP 生态中最成熟、功能最完整的框架无关选项。
  • 熟悉 LangGraph 概念并希望快速在 PHP 中复用,langgraph/langgraph-php 提供最直接的 API 映射。
  • 追求极致的轻量和控制权,PocketFlow PHP 提供核心抽象,其余部分由你掌控。
  • 需要完善中间件和事件系统,Nexus AI Workflows 更适合。
  • 偏好 Pest 风格声明式 API,且需要内置评估和追踪,Pagent 更贴近。

落地前先确认这些

真正落地前,把下面这些问题问清楚,能少踩很多返工。

  • 项目是 Laravel 还是跨框架,Laravel 优先 LaraGraph,跨框架优先 Neuron AI。
  • 工作流是否需要循环、条件分支、并行和子工作流,Nexus AI Workflows 对这些节点类型支持更完整。
  • 状态持久化要求到哪一级,检查点粒度能否满足断点恢复。
  • 是否需要人机协同,选支持暂停和人工审核的方案。
  • 是否需要内置 RAG 和工具包,Neuron AI 的能力覆盖更全。
  • 并发和水平扩展靠什么,LaraGraph 依赖 Laravel 数据库和队列体系。
  • 是否需要评估和 OpenTelemetry 追踪,Pagent 内置这些能力。
  • 团队后续招聘和扩展是否容易,PHP AI 框架人才储备少于 Python AI 生态。

FAQ

下面这些问题覆盖选型和能力边界,范围只限本文提到的方案。

问 能不能直接在 PHP 里用 Python LangGraph?
答 不能直接跑,PHP 生态目前是重新实现或适配图编排能力。

问 哪个 PHP 方案最像 LangGraph?
答 langgraph/langgraph-php 提供 StateGraph、节点、边、检查点等核心组件的 PHP 实现。

问 Laravel 项目首选哪个?
答 LaraGraph,它深度集成 Eloquent、队列等 Laravel 原生能力。

问 需要 RAG 和工具包选哪个?
答 Neuron AI,它提供多代理协作、人机协同、状态持久化、RAG 及内置工具包。

问 最轻量的方案是哪个?
答 PocketFlow PHP,约 400 行纯 PHP,框架无关,只保留核心图执行抽象。

问 需要可观测性和中间件选哪个?
答 Nexus AI Workflows 提供中间件和可观测性,Pagent 提供 OpenTelemetry 追踪。

问 PHP 方案最大的优势是什么?
答 技术栈统一,Agent 与业务逻辑共用代码库和部署流程,与现有 PHP 系统集成更深。

问 PHP 方案最大的短板是什么?
答 生态成熟度、社区规模和高级状态管理能力仍落后于 Python LangGraph。