README

一个轻量级、高性能的PHP MVC框架，专为快速开发和生产部署而设计。

框架特性

核心功能

• 轻量级架构 - 精简的代码结构，快速启动
• MVC模式 - 清晰的模型-视图-控制器分离
• RESTful API - 完整的API开发支持
• 中间件系统 - 灵活的请求处理管道
• 数据库抽象 - 简洁的数据库操作接口
• 缓存系统 - 支持Redis和文件缓存
• 日志系统 - 多级别日志记录
• 异常处理 - 统一的错误处理机制

安全特性

• JWT身份验证
• CORS跨域支持
• 输入验证和过滤
• SQL注入防护
• XSS攻击防护
• 访问频率限制

目录结构

QingcaoCore/
├── app/                    # 应用程序代码
│   ├── Core/              # 核心组件
│   │   ├── Application.php    # 应用程序核心
│   │   ├── Database.php       # 数据库操作
│   │   ├── Cache.php          # 缓存系统
│   │   ├── Logger.php         # 日志系统
│   │   ├── Validator.php      # 数据验证
│   │   ├── JWT.php            # JWT认证
│   │   ├── ApiResponse.php    # API响应
│   │   ├── ExceptionHandler.php # 异常处理
│   │   ├── Paginator.php      # 分页器
│   │   └── Queue.php          # 队列系统
│   ├── Http/              # HTTP层
│   │   ├── Controllers/       # 控制器
│   │   │   ├── Api/          # API控制器
│   │   │   └── *.php         # Web控制器
│   │   └── Middleware/        # 中间件
│   ├── Models/            # 数据模型
│   └── Exceptions/        # 自定义异常
├── bootstrap/             # 启动文件
├── config/               # 配置文件
├── public/               # 公共资源
├── routes/               # 路由定义
├── storage/              # 存储目录
│   ├── cache/            # 缓存文件
│   ├── logs/             # 日志文件
│   └── database/         # 数据库文件
└── vendor/               # 第三方依赖

快速开始

1. 环境要求

• PHP >= 7.4
• Composer
• Web服务器 (Apache/Nginx/内置服务器)

2. 安装依赖

composer install

3. 配置环境

复制并编辑配置文件：

cp config/app.example.php config/app.php
cp config/database.example.php config/database.php

4. 启动开发服务器

php -S localhost:8000 -t public

访问 http://localhost:8000 查看应用程序。

核心组件说明

应用程序核心 (Application)

• 单例模式的应用程序容器
• 依赖注入和服务定位
• 中间件管道管理

数据库操作 (Database)

• PDO封装的数据库抽象层
• 查询构建器
• 事务支持
• 连接池管理

缓存系统 (Cache)

• 支持Redis和文件缓存
• 标签化缓存
• 缓存失效策略

验证器 (Validator)

• Laravel风格的验证规则
• 自定义验证规则
• 多语言错误消息

JWT认证 (JWT)

• 无状态身份验证
• Token生成和验证
• 自动过期处理

日志系统 (Logger)

• PSR-3兼容的日志接口
• 多级别日志记录
• 文件和数据库日志

配置说明

应用配置 (config/app.php)

return [
    'name' => 'QingcaoCore App',
    'env' => 'production',
    'debug' => false,
    'url' => 'http://localhost',
    'timezone' => 'Asia/Shanghai',
    'key' => 'your-secret-key',
];

数据库配置 (config/database.php)

return [
    'default' => 'mysql',
    'connections' => [
        'mysql' => [
            'driver' => 'mysql',
            'host' => 'localhost',
            'database' => 'your_database',
            'username' => 'your_username',
            'password' => 'your_password',
            'charset' => 'utf8mb4',
        ],
    ],
];

缓存配置 (config/cache.php)

return [
    'default' => 'file',
    'stores' => [
        'file' => [
            'driver' => 'file',
            'path' => storage_path('cache'),
        ],
        'redis' => [
            'driver' => 'redis',
            'host' => '127.0.0.1',
            'port' => 6379,
        ],
    ],
];

API开发

创建API控制器

<?php
namespace App\Http\Controllers\Api;

use App\Http\Controllers\Controller;
use App\Core\ApiResponse;

class UserController extends Controller
{
    public function index()
    {
        $users = User::all();
        return ApiResponse::success($users);
    }
    
    public function store($request)
    {
        // 验证输入
        $validator = new Validator($request->all(), [
            'name' => 'required|string|max:255',
            'email' => 'required|email|unique:users',
        ]);
        
        if ($validator->fails()) {
            return ApiResponse::error('验证失败', 422, $validator->errors());
        }
        
        // 创建用户
        $user = User::create($request->all());
        return ApiResponse::success($user, '用户创建成功', 201);
    }
}

定义路由

// routes/api.php
$router->group(['prefix' => 'api'], function($router) {
    $router->get('/users', 'Api\UserController@index');
    $router->post('/users', 'Api\UserController@store');
});

中间件使用

创建中间件

<?php
namespace App\Http\Middleware;

class AuthMiddleware
{
    public function handle($request, $next)
    {
        if (!$this->isAuthenticated($request)) {
            return ApiResponse::error('未授权访问', 401);
        }
        
        return $next($request);
    }
}

应用中间件

// 在路由中使用
$router->group(['middleware' => 'auth'], function($router) {
    $router->get('/profile', 'UserController@profile');
});

许可证

MIT License

版本信息

QingcaoCore 5.0 精简版 - 生产就绪的轻量级PHP框架

• 移除了测试框架和测试用例
• 移除了数据库迁移系统
• 移除了部署脚本和配置
• 保留了所有核心功能和生产必需组件
• 优化了目录结构和代码组织

适用于快速开发和生产部署的场景。