
blueprint
写一份 YAML 蓝图,自动生成 Laravel 全套代码
项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-10-04 · 当前星标 ★ 3111
使用教程
环境要求
- 已安装 Composer 的 PHP 环境
- 一个 Laravel 11 或更高版本的 Laravel 应用
安装与启动步骤
-
1安装 Blueprint
在 Laravel 项目根目录用 Composer 以开发依赖方式安装,包会自动注册,无需手动配置服务提供者。
composer require -W --dev laravel-shift/blueprint -
2安装测试断言包
可选步骤。若想运行 Blueprint 生成的测试,需要额外安装 laravel-test-assertions 包。
composer require --dev jasonmccreary/laravel-test-assertions -
3编写 draft 蓝图文件
用 YAML 声明要生成的组件,例如在 models 下定义字段、在 controllers 下定义动作与语句。
-
4生成 Laravel 组件
运行 Artisan 命令,Blueprint 会依据 draft 文件一次性生成模型、迁移、控制器、路由等代码。
php artisan blueprint:build
如何确认成功
执行 php artisan blueprint:build 后无报错,项目中出现对应的模型、迁移、控制器、路由等生成文件。
常见问题
Q:需要哪个 Laravel 版本?
A:README 说明当前支持 Laravel 11 或更高版本,低版本无法使用。
Q:需要手动注册服务提供者吗?
A:不需要,Blueprint 会通过 Laravel 的包自动发现(package discovery)自动注册。
Q:生成的测试运行失败怎么办?
A:需要额外安装 jasonmccreary/laravel-test-assertions 包。另外示例假设默认应用自带 User 模型与 app.blade.php 布局。
注意事项
- Blueprint 通过 Composer 以 --dev 开发依赖方式安装。
- 若要在已有项目中使用,注意生成的测试可能依赖默认 Laravel 应用的 User 模型与 app.blade.php 布局。
- README 未给出 draft 文件的默认路径,实际路径请以 Blueprint 官方文档为准。
核心亮点
- 用 YAML 声明模型和动作,一次生成迁移、模型、控制器、路由、测试等多层代码,减少重复劳动
- 自动推导 Eloquent 关联、字段类型和验证规则,降低手写遗漏与不一致的风险
- 支持自定义 stub 模板,能按团队规范调整生成结果,并可在已有项目上增量生成
不足之处
- 仅面向 Laravel 生态,非 Laravel 或非 PHP 项目无法使用
- 蓝图 DSL 需要额外学习成本,复杂业务场景下生成结果可能仍需手工调整
适用场景
- 新 Laravel 项目快速搭建数据模型与 CRUD 骨架
- 团队统一代码规范,用自定义 stub 批量生成标准结构
- 已有项目新增模块时,按蓝图增量生成迁移、模型和测试
替代项目
Laravel Generator、InfyOm Laravel Generator
同类项目推荐
git-ai
开源
让 AI 代理的每次提交都有据可查,多代理协作不打架
Git designed for AI agents. Open-source, in the spirit of Anthropic's Scion and Open···
copilot.lua
开源
让 Neovim 秒变 AI 补全编辑器,Tab 即用
Fully featured & enhanced replacement for copilot.vim complete with API for interact···
packmind
开源
把团队工程规范喂给 AI,让生成的代码直接合规
Packmind seamlessly captures your engineering playbook and turns it into AI context,···
minuet-ai.nvim
开源
在 Neovim 里边写边补全,多家大模型随你换
Dance with Intelligence in Your Code. Minuet offers code completion as-you-type from···
OdinRunes
开源
在编辑器里直接调教 GPT,自动提取上下文,省心省钱。
Odin Runes, a java-based GPT client, facilitates interaction with your preferred GPT···
eca
开源
一套协议,让AI结对编程适配所有编辑器
Editor Code Assistant (ECA) - AI pair programming capabilities agnostic of editor
abcoder
开源
给 AI 编程助手装上精准、保密的代码上下文引擎
deep, reliable and confidential coding-context
project-butler
开源
给 AI 编程助手装上项目记忆,告别每次从零开始
Project memory system for AI coding assistants (Claude Code, Cursor, Codex): session···
GitBot
开源
把编码智能体封装成可复用机器人,本地批量跑仓库任务
Create reusable bots powered by Claude Code, Codex, or OpenCode. Run them locally ac···