说明
- 这是一个用于测试 Laravel 功能与性能的轻量级示例工程。
- 目标：验证核心功能、快速跑通业务流程、进行性能基准测试与调优实验。
主要目标
- 功能验证：路由、中间件、控制器、模型、队列、事件等。
- 性能对比：请求吞吐、响应延迟、数据库查询量、缓存命中率。
- 可观测性：日志、性能追踪、异常监控。
环境要求
- PHP >= 8.0（根据项目实际版本调整）
- Composer
- MySQL / PostgreSQL / SQLite（任选其一）
- Redis（可选，用于缓存与队列）
- Node.js & npm（前端资产编译时需要）
快速开始
- 克隆仓库
git clone https://github.com/ZHYxulei/Laravel-Demo.git cd Laravel-Demo - 安装依赖
composer install npm install npm run dev # 或 npm run build - 环境配置
cp .env.example .env php artisan key:generate # 编辑 .env 填写 DB/REDIS 等配置 - 数据库初始化
php artisan migrate php artisan db:seed # 可选 - 启动应用
composer run dev
测试与质量
- 单元与集成测试
./vendor/bin/phpunit - 静态分析（可选）
composer run phpstan
性能测试建议
- 负载测试工具：wrk、ab、siege
- 建议指标：RPS、p95响应时间、错误率、数据库QPS、慢查询数、内存与CPU使用
- 简单示例（使用 wrk）：
wrk -t2 -c100 -d30s http://localhost:8000/api/endpoint - 开启缓存（Redis/OPcache）、数据库索引并收集基线数据；每次改动后重复测试。
可观测性与调试
- 使用 Laravel Telescope 或 Debugbar 在开发环境启用请求、查询监控。
- 日志位于 storage/logs，生产环境建议接入集中化日志（ELK/CloudWatch）。
常用命令速查
- 清理缓存：
php artisan optimize:clear - 队列监听：
php artisan queue:work - 调度任务：
php artisan schedule:run（或通过 cron）
项目结构（示例）
- app/ — 应用源码
- routes/ — 路由定义
- database/ — 迁移与种子
- tests/ — 测试用例
- resources/ — 视图与前端资源
贡献
- 欢迎提交 Issue 与 PR。
- 提交前请保证所有测试通过并附带必要说明与基准对比（若涉及性能改动）。
许可证
- 根据仓库实际许可证填写（如 MIT）。
备注
- 在进行性能对比时请尽量在隔离环境（可重复复现）中执行，记录环境与参数以便复现结果。
- 如需进一步的基准脚本或性能检测配置，可说明具体关注点（并发、某一路由、数据库负载等）。