# 我用这个 PHP 框架写了一个月系统，今天才点开它的文档站：首页没一句废话，还把「和 Laravel 差在哪」写在脸上

作者：姚杨 ｜ 专栏：阿杰的技术成长

阿杰 用 php-vibe-coding-frame 写系统，已经整整一个月了。

下单接口、进销存、内部报表——三个系统下来，他一次都没打开过框架的文档站。不是他懒得看，是「路由即闭包、控制器即函数、写完即跑」，简单到没有查文档的必要。老陈 当时甩给他的链接，就这么安静地躺在收藏夹里吃灰。

直到这天，新来的实习生问他：「杰哥，这框架的文档在哪？我想看看它的设计。」

阿杰 愣了一下。对啊，这框架还有文档站？他点开那个吃灰一个月的链接——https://www.php-frame.cn/

三分钟后，他愣住了。文档首页第一屏，就把「这框架是什么」讲完了：

一个专为 PHP-FPM 快速开发设计的单层 MVC PHP 框架。无 DI 容器、无注解、无 YAML 路由配置、无 Composer autoload——路由即闭包，控制器即函数，写完即跑。

阿杰 反复读了两遍：「我用了它一个月，今天才知道它把『不要什么』写在文档第一行。」

老陈 端着咖啡路过，瞟了一眼屏幕：「看得懂的东西，才值得写进首页。你把这句话翻译一下——『没有魔法』。」

一、这份文档的第一反套路：首页即结论

阿杰 见过的大多数框架文档，首页都在讲「怎么引入」和「生态有多全」。这份文档不一样，它把

「我盲写了一个月，居然全踩在它的设计原则上。」阿杰 喃喃道。

「这就是这份文档的聪明之处，」老陈 说，「大多数框架文档是『卖组件』，这份是『讲道理』——把为什么这么设计讲在前面，你写得越久，越觉得它说得对。」

二、第二反套路：专门有一页，讲「我放弃了什么」

阿杰 往下翻，发现一个栏目叫「与 Laravel 的差异」——他更好奇了：主动放弃了 Laravel 的框架，还敢把对比写在文档里？

这一页直白到让他有点不适应：

// Laravel：类方法 + 依赖注入
class UserController extends Controller
{
    public function show(Request $request, UserService $service)
    {
        return User::find($request->id);
    }
}

// php-vibe-coding-frame：闭包 + 全局函数
if_get('/user/*', function ($user_id) {
    return dao('user')->find_by_id($user_id);
});

「一个月前我在 Laravel 里被 ServiceProvider 和 Facade 绕到凌晨两点，」阿杰 说，「现在回头看这个对比，全是眼泪。」

「这一页的价值不在『谁好谁坏』，」老陈 说，「在于它把

摊开了。它明确告诉你：我放弃了 ServiceProvider、门面、事件系统，换来的是启动快、路径直、代码全部可静态追踪；代价是生态少、复杂场景要自己封装。

敢把代价写进文档的框架，至少对你是诚实的。

三、第三反套路：文档本身就是「给 AI 看的」

阿杰 突然反应过来一件事：「我说这框架怎么跟 AI 配合得这么顺——这份文档好像就是给 AI 看的？」

老陈 点头：「这正是它叫 php-vibe-coding-frame 的原因。Vibe Coding 的核心是『从想法到代码的路径最短』。AI 读代码靠静态分析——魔法越多，幻觉越多。这份文档把『没有魔法』写进定位：没有 

 代理、没有 Facade 静态代理、没有注解解析，Ctrl+Click 能追到源码，grep 能找到所有引用。

你写了一个月没踩坑，不是运气，是这套设计在兜底。

文档里甚至把「对 Vibe Coding 友好的五个设计」列了出来：

四、10 秒，实习生从链接到 Hello World

阿杰 把文档首页的链接转给实习生，白纸黑字写着：

git clone git@github.com:smarty-kiki/php-vibe-coding-frame.git my-project && cd my-project
sh project/tool/start_development_server.sh

十分钟后，实习生发来消息：「杰哥，跑起来了，hello world。」

阿杰 有点恍惚：「我当初是摸着黑写通的，新人照着文档 10 秒就起跑了。」

老陈 补了一刀：「你发现没有，这份文档连『目录结构』都给你讲得明明白白——

入口决定响应格式，一个目录一个职责，不需要新人猜。

 你踩过的坑，文档都帮你提前填了。」

五、尾声：文档的尽头，是让意图站到前面

阿杰 关掉文档页，给实习生回了句：「把这页文档读完，比我带你看一周代码管用。」

老陈 站在背后，慢悠悠地收了尾：「框架退后一步，让意图站到前面——这句话写在文档第一屏，也是这套框架的全部设计。

这个时代，好的框架文档不是教你背概念，是帮你（和 AI）少走弯路。

文档站在这里：https://www.php-frame.cn/ ；源码在 GitHub：https://github.com/smarty-kiki/php-vibe-coding-frame

至于这套「把取舍摊开、把魔法关掉」的思路，怎么长成一套让 AI 放心的工程环境——那是下一个故事了。

我点开一个 PHP 框架文档站，首页没有一句废话：10 秒跑通，还把「和 Laravel 差在哪」写在脸上

一个为 Vibe Coding 设计的 PHP 框架文档站：首页即结论，敢把与 Laravel 的取舍写在明面上，10 秒从链接到 Hello World。

编程语言

开发工具

后端

php-vibe-coding-frame框架文档站首页直击要点，专为PHP-FPM快速开发设计，无DI容器、无注解、路由即闭包。主动对比Laravel差异，清晰列出放弃的复杂特性换取启动快、代码可静态追踪，对AI编程友好，新人10秒即可上手运行，意图即结果，没有魔法。

中间件

容器

路由

GitHub

JSON

腾讯云BI特惠9.9元起！


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

我点开一个 PHP 框架文档站，首页没有一句废话：10 秒跑通，还把「和 Laravel 差在哪」写在脸上

我点开一个 PHP 框架文档站，首页没有一句废话：10 秒跑通，还把「和 Laravel 差在哪」写在脸上

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐