Lumin Framework

---

Lumin 是一个基于 Laravel 组件的轻量级 PHP 框架，专为开发者设计，旨在帮助您快速上手 Laravel 的核心概念，并深入理解 Composer 和 Illuminate 组件的应用。通过 Lumin，您可以学习如何构建现代 Web 应用，掌握路由、数据库操作、事件处理、视图渲染等关键技术，同时体验轻量化和模块化开发的魅力。无论是学习 Laravel 框架的核心思想，还是提升对 Composer 依赖管理和 Illuminate 组件的理解，Lumin 都是您的理想选择。

---

---

特性

• 轻量高效：基于 Laravel 核心组件，去除冗余功能，保持轻量化。
• 路由系统：支持 RESTful 路由和动态路由参数。
• 数据库支持：集成 Eloquent ORM，提供强大的数据库操作功能。
• 事件系统：支持事件监听和触发，实现解耦设计。
• 视图渲染：支持 Blade 模板引擎，简化视图开发。
• 中间件支持：全局中间件支持，灵活处理请求和响应。
• 日志管理：集成 PSR-3 日志接口，支持多种日志驱动。
• 环境配置：使用 .env 文件管理环境变量，方便开发和部署。

---

安装

1. 克隆仓库：

bash
git clone https://gitee.com/wangzhaobo/Lumin.git
cd Lumin

2. 安装依赖：

bash
composer install

3. 配置环境：
   • 复制 .env.example 文件为 .env，并修改配置：

env
   APP_ENV=local
   APP_KEY=base64:your_random_key_here
   DB_CONNECTION=mysql
   DB_HOST=localhost
   DB_PORT=3306
   DB_DATABASE=your_database
   DB_USERNAME=your_username
   DB_PASSWORD=your_password

4. 启动应用：

bash
php -S localhost:8000 -t public

访问 http://localhost:8000 查看效果。

---

使用示例

1. 定义路由

在 routes/web.php 中定义路由：

php
use Illuminate\Support\Facades\Route;

Route::get('/', function () {
return 'Hello, Lumin!';
});

Route::get('/user/{id}', function ($id) {
return "User ID: $id";
});

2. 使用数据库

在控制器中使用 Eloquent ORM：

php
use App\Models\User;

$users = User::all();
foreach ($users as $user) {
echo $user->name;
}

3. 使用视图

在控制器中渲染视图：

php
use Illuminate\Support\Facades\View;

return View::make('welcome', ['name' => 'Lumin']);

4. 使用中间件

在 config/middleware.php 中定义全局中间件：

php
return [
    // 全局中间件
    'global' => [
        \App\Http\Middleware\GlobalDemo::class,
    ],
    // 注册中间件别名
    'alias' => [
        'params' => App\Http\Middleware\ParamProcessor::class,
    ],
];

---

配置文件

• config/app.php：应用配置。
• config/database.php：数据库配置。
• config/middleware.php：中间件配置。
• config/logging.php：日志配置。

---

日志管理

框架集成了 PSR-3 日志接口，支持多种日志驱动。默认配置为 single 驱动，日志文件存储在 storage/logs 目录下。

php
use Illuminate\Support\Facades\Log;

Log::info('This is an info message.');
Log::error('This is an error message.');

---

贡献指南

我们欢迎任何形式的贡献！请遵循以下步骤：

1. Fork 本项目。
2. 创建分支 (git checkout -b feature/YourFeature)。
3. 提交更改 (git commit -m 'Add some feature')。
4. 推送分支 (git push origin feature/YourFeature)。
5. 提交 Pull Request。

---

致谢

• 感谢 Laravel 提供了强大的组件。
• 感谢 Guzzle 提供了 PSR-7 实现。

---

联系

如有问题或建议，请通过以下方式联系：

• Email: 963087326@qq.com
• Gitee: Lumin

---

说明

1. 框架介绍：简要说明框架的特点和目标。
2. 安装步骤：提供清晰的安装和配置指南。
3. 使用示例：展示路由、数据库、视图和中间件的基本用法。
4. 配置文件：列出框架的配置文件及其作用。
5. 日志管理：说明日志功能的用法。
6. 贡献指南：鼓励开发者参与贡献。
7. 许可证和致谢：明确开源协议，并感谢相关项目。

---

希望此框架能为你学习 PHP 框架提供清晰、专业的支持！ 🚀