blueprint

写一份 YAML 蓝图,自动生成 Laravel 全套代码

开源 🏷️完全免费 🔧 仅开源项目,无在线服务,需自行部署 编程开发 🍴 复刻 294 🐛 待处理 8 👀 关注 49
GitHub ↗
GitHub 星标 ★ 3111
维护状态 较活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费工具

项目预览

blueprint 项目界面预览图
图片来源:GitHub 官方仓库名片

项目数据

分类编程开发
开发团队laravel-shift
定价模式🏷️完全免费
价格说明开源免费工具
访问状态🔧 仅开源项目,无在线服务,需自行部署
是否开源是
开源协议MIT
主要语言PHP
GitHub 星标★ 3111
上线时间2019-10-14 00:00:00
代码更新2026-10-20
仓库体积1.5 MB
本站数据更新2026-11-18
维护状态较活跃
收录时间2026-10-04
浏览次数7

项目介绍

Blueprint 是面向 Laravel 开发者的代码生成工具,通过读取一份 YAML 蓝图文件,一次性生成模型、迁移、控制器、路由、表单请求、事件、任务、测试等整套代码骨架。它解决的是 Laravel 项目里重复编写样板代码、手写迁移与模型容易遗漏关联和字段的问题。核心能力包括:用声明式 DSL 描述数据模型与业务动作,自动推导 Eloquent 关系、迁移字段和验证规则;支持生成 API 资源、策略、工厂、Seeder;可自定义模板与 stub,适配团队规范;还能在已有项目上增量生成而不覆盖手写逻辑。开发者只需维护蓝图文件,就能让代码结构与数据设计保持同步,显著减少初期搭建和后续扩展的机械劳动,适合中大型 Laravel 应用快速起步与迭代。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-10-04 · 当前星标 ★ 3111

使用教程

难度:入门 约 5 分钟 部署方式:库/依赖 4 步

环境要求

  • 已安装 Composer 的 PHP 环境
  • 一个 Laravel 11 或更高版本的 Laravel 应用

安装与启动步骤

  1. 1安装 Blueprint

    在 Laravel 项目根目录用 Composer 以开发依赖方式安装,包会自动注册,无需手动配置服务提供者。

    composer require -W --dev laravel-shift/blueprint
  2. 2安装测试断言包

    可选步骤。若想运行 Blueprint 生成的测试,需要额外安装 laravel-test-assertions 包。

    composer require --dev jasonmccreary/laravel-test-assertions
  3. 3编写 draft 蓝图文件

    用 YAML 声明要生成的组件,例如在 models 下定义字段、在 controllers 下定义动作与语句。

  4. 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···

★ 1002 2026-10-18
copilot.lua 开源

让 Neovim 秒变 AI 补全编辑器,Tab 即用

Fully featured & enhanced replacement for copilot.vim complete with API for interact···

★ 4094 2026-09-15
packmind 开源

把团队工程规范喂给 AI,让生成的代码直接合规

Packmind seamlessly captures your engineering playbook and turns it into AI context,···

★ 324 2026-09-16
minuet-ai.nvim 开源

在 Neovim 里边写边补全,多家大模型随你换

Dance with Intelligence in Your Code. Minuet offers code completion as-you-type from···

★ 1463 2026-10-29
OdinRunes 开源

在编辑器里直接调教 GPT,自动提取上下文,省心省钱。

Odin Runes, a java-based GPT client, facilitates interaction with your preferred GPT···

★ 92 2026-08-09
eca 开源

一套协议,让AI结对编程适配所有编辑器

Editor Code Assistant (ECA) - AI pair programming capabilities agnostic of editor

★ 1061 2026-08-09
abcoder 开源

给 AI 编程助手装上精准、保密的代码上下文引擎

deep, reliable and confidential coding-context

★ 390 2026-08-09
project-butler 开源

给 AI 编程助手装上项目记忆,告别每次从零开始

Project memory system for AI coding assistants (Claude Code, Cursor, Codex): session···

★ 377 2026-08-09
GitBot 开源

把编码智能体封装成可复用机器人,本地批量跑仓库任务

Create reusable bots powered by Claude Code, Codex, or OpenCode. Run them locally ac···

★ 243 2026-11-05