直接用 laravel/laravel 骨架,很少需要碰底层;但当你要深入理解 Eloquent、容器、队列、事件的实现,或要做框架级扩展、贡献源码时,需要直接面对它的核心组件库。laravel/framework 就是 Laravel 的“发动机”:所有 facades、contracts、组件都在这里。

项目基本信息

信息项详情
项目名称framework
GitHub地址https://github.com/laravel/framework
项目描述驱动 Laravel 应用的 PHP 底层组件与契约库
作者laravel
开源协议MIT License
开源状态公开
Languages—
支持平台Windows / macOS / Linux
最后更新2026-10-30

一、项目介绍

laravel/framework 是 Laravel 框架的底层组件库(即你在 composer.json 里依赖的 illuminate/* 集合),MIT 协议。它包含容器、Eloquent ORM、路由、队列、缓存、事件、认证、邮件等全部核心实现与 contracts 契约。应用骨架 laravel/laravel 只是把这些组件组装起来的“样板间”,真正的逻辑都在 framework 里。理解它有助于做深度定制、调试与贡献。

二、核心优势

  1. 核心全集:容器/Eloquent/队列/事件/认证等全部 illuminate 组件。
  2. 契约清晰:contracts 定义稳定接口,便于替换与测试。
  3. 解耦设计:各组件可单独使用,不强制整套绑定。
  4. 文档完善:配套 Laravel 文档覆盖每个组件。
  5. 跨平台:PHP 库,Windows / macOS / Linux 通用。

三、适用场景

  • 需要深度定制或扩展 Laravel 能力的开发者。
  • 调试框架级问题、阅读源码定位根因。
  • 为 Laravel 贡献代码或写高级包。
  • 学习现代 PHP 框架架构设计。

四、安装教程

作为依赖被 laravel/laravel 自动引入;单独使用可 require:

composer require illuminate/support
# 或整体
composer require laravel/framework

常见报错:版本与 PHP/应用骨架不匹配会报依赖冲突,按官方版本矩阵对齐;Composer 扩展缺失同样会报错。

五、使用示例

单独用其组件(如集合与容器):

use Illuminate\Support\Collection;

$result = Collection::make([1, 2, 3])->map(fn ($x) => $x * 2);

真实效果:你可以脱离整个 Web 框架,只取 illuminate/support、illuminate/database 等组件在项目里用——Laravel 的“组件化”让它的能力可被任意 PHP 项目复用。

六、常见问题

Q:它和 laravel/laravel 是什么关系?
A:laravel/laravel 是应用骨架,framework 是被依赖的底层组件库。
Q:可以单独用它的组件吗?
A:可以,illuminate/* 各组件解耦,可单独 require 使用。
Q:协议允许商用吗?
A:MIT,允许商用与修改,需保留版权与许可声明。

七、总结

laravel/framework 是 Laravel 的底层组件引擎,包含容器、Eloquent、队列等全部 illuminate 实现。对需要深度定制、调试或贡献 Laravel 的开发者,它是绕不开的源码库;MIT 协议,组件化设计也让其能力可被任意 PHP 项目单独复用。