在2026年，使用 Flight 的原生 AI 集成为您的 PHP 项目加速

Source: Dev.to

Flight PHP 和原生 AI 集成

Flight PHP 在保持极简的同时，提供了现代工作流所需的强大工具。官方文档中专门的 AI & Developer Experience 章节展示了 Flight 如何让 AI 编码助手大放异彩——尤其是通过 Runway 提供的内置 CLI 命令，连接 LLM 并为 GitHub Copilot、Cursor、Windsurf、Antigravity（Gemini）等工具生成项目专属指令。这种原生支持意味着你的 AI 助手能够获取关于应用栈、约定和目标的定制化上下文，从而每次都提供更准确、相关的建议。

一个突出的优势是：Flight 的整个核心代码库非常小——即使包括测试在内也仅约 51 k token，轻松适配大多数 AI 上下文窗口（远低于 Claude 的 200 k+ 或 Gemini 的超大容量）。你的 AI 可以完整读取整个框架而不会被截断，因而相比于更庞大的框架，出现幻觉的概率更低，对 Flight 模式的理解也更深入。

对于新手用户，这大幅降低了入门门槛。对于长期使用 Flight 的开发者，则能提升团队一致性并加快迭代速度，无需重复造轮子。

快速开始：使用内置 Runway 的官方 Skeleton

让 AI 集成快速运行的最简方式是官方的 flightphp/skeleton。它已经预先配置好 Runway（Flight 的 CLI 工具）、预定义的 AI 指令文件以及完善的项目结构。

安装

1. 确保已安装 PHP 7.4+。
2. 在终端中运行：

composer create-project flightphp/skeleton my-flight-app
cd my-flight-app

这会拉取 Flight 核心、Runway，并创建 app/、public/、config/ 等文件夹，同时在 .github/、.cursor/ 等目录下生成 AI 就绪的文件。

本地运行

composer start

或使用 PHP 内置服务器：

php -S localhost:8000 -t public/

访问 。

Skeleton 开箱即用地对 AI 友好——预定义的指令帮助你的 IDE AI 立即理解命名空间结构、配置加载等内容。

使用 ai:init 设置 AI 凭证

Runway 为 AI 命令提供动力。首先，连接你的 LLM 提供商：

php runway ai:init

该命令会提示你：

• 选择一个提供商（例如 OpenAI、Grok、Claude）。
• 输入基础 URL（默认使用 OpenAI 的）。
• 提供你的 API 密钥。
• 选择模型（例如 gpt-4o、claude-3-opus）。

凭证会安全地保存到项目的 config.php 中。Gemini 支持通过 Antigravity 集成实现，会生成 .gemini/GEMINI.md 的说明，以便 Gemini 驱动的工具使用相同的上下文。

使用 ai:generate-instructions 生成智能指令

运行生成器：

php runway ai:generate-instructions

回答几个关于项目的提示（描述、数据库、模板、安全重点）。随后 Flight 会生成详细、针对项目的指令并写入以下文件：

• .github/copilot-instructions.md → GitHub Copilot
• .cursor/rules/project-overview.mdc → Cursor
• .windsurfrules → Windsurf
• .gemini/GEMINI.md → Antigravity (Gemini)

这些文件会直接向你的 IDE AI 提供上下文，把模糊的建议转化为遵循路由、PDO 使用、JSON 响应和安全中间件的代码。

你可以在添加功能或更改技术栈后随时重新运行该命令，保持指令最新，减少“重新解释项目” 的循环。

为什么这很重要：向后兼容性和持久性

Flight 自 2011 年起就已经存在，核心目标是实现坚如磐石的向后兼容性。文档指出，v3 保留了大多数 v2 的模式，仅有极少的破坏性更改（主要是为了与 MVC 对齐的输出缓冲调整）。这种稳定性意味着，基于旧版 Flight 示例训练的 AI 工具至今仍能很好地工作——不像快速迭代的框架那样出现版本特定的混乱。极小的核心确保即使是中等规模的模型也能获得完整的上下文。

实际收益： 提示 “Add a grouped admin route with auth middleware in Flight”，AI 会参考你的指示和 Flight 持久的风格，生成干净、兼容的代码。

快速示例：Skeleton 中的 AI 辅助路由

生成指令后，打开 public/index.php（或一个控制器），并向你的 IDE AI 助手提问：

“创建一个使用 PDO SQLite 的 GET /todos 路由，返回任务的 JSON 数组。”

AI 应该输出符合你的数据库选择、JSON 格式以及错误处理的代码——通常只需少量调整即可直接提交。

Runway 还提供了便利的快捷命令：

php runway routes                 # 列出所有端点
php runway generate:controller Todos   # 如有需要，脚手架一个控制器

Flight 的 AI 功能（在 v3.16.0 中加入）让快速、可靠的开发变得轻松愉快。获取 skeleton，初始化你的凭证，生成指令，观看你的 AI 成为真正的副驾驶。

---

你在 Flight 中使用的 LLM 配置是什么？