PHPackages                             larva/laravel-skel - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. larva/laravel-skel

ActiveProject[Framework](/categories/framework)

larva/laravel-skel
==================

The skeleton application for the Laravel framework.

v1.0.3(2mo ago)00MITPHPPHP ^8.4CI failing

Since Feb 28Pushed 1mo agoCompare

[ Source](https://github.com/larva-cool/laravel-skel)[ Packagist](https://packagist.org/packages/larva/laravel-skel)[ RSS](/packages/larva-laravel-skel/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (40)Versions (5)Used By (0)

Laravel API 模板
==============

[](#laravel-api-模板)

[![Tests](https://github.com/larva-cool/laravel-skel/actions/workflows/tests.yml/badge.svg)](https://github.com/larva-cool/laravel-skel/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/9ef536d8be7f8b930d244b6a20063fca0f7d2facb89406c05bd40ced171a4750/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c617276612f6c61726176656c2d736b656c)](https://packagist.org/packages/larva/laravel-skel)[![Latest Stable Version](https://camo.githubusercontent.com/46081b28e2bf72eca3b443a5fa04f5d8b343181356881ad29130d53a32c06b62/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c617276612f6c61726176656c2d736b656c)](https://packagist.org/packages/larva/laravel-skel)[![badge](https://camo.githubusercontent.com/a7733138b859fa469e6554af2a0416c7aa51a65ef4cedcf9f507b8e3a59d430b/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c2f2d2f62616467652f6769742f6c61746573742f636f64652f7673636f64652d73746172746564)](https://camo.githubusercontent.com/a7733138b859fa469e6554af2a0416c7aa51a65ef4cedcf9f507b8e3a59d430b/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c2f2d2f62616467652f6769742f6c61746573742f636f64652f7673636f64652d73746172746564)[![badge](https://camo.githubusercontent.com/e46dc383bb56f71fbb15ecd12b359bd017803e7c807473d13ca203060c36d018/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c2f2d2f62616467652f6769742f6c61746573742f63692f706970656c696e652d61732d636f6465)](https://camo.githubusercontent.com/e46dc383bb56f71fbb15ecd12b359bd017803e7c807473d13ca203060c36d018/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c2f2d2f62616467652f6769742f6c61746573742f63692f706970656c696e652d61732d636f6465)

这是一个基于 Laravel 12.x 的 API 模板，采用 DDD 结构，内置 Sanctum 授权机制和用户系统，适合快速构建后端 API 服务。

系统要求
----

[](#系统要求)

- PHP &gt;= 8.2
- MySQL &gt;= 8.0
- Redis &gt;= 6.0
- Composer &gt;= 2.0

特点
--

[](#特点)

### 架构设计

[](#架构设计)

- 采用 DDD（领域驱动设计）架构
- 遵循 Laravel 最佳实践
- 高度完善的控制器、模型、模块模板
- 内置模型通用高阶 Traits 封装
- 自动注册 Policies

### 功能特性

[](#功能特性)

- 完整的用户认证系统（基于 Laravel Sanctum）
- 强大的用户系统（包含用户组、用户资料、积分系统等）
- 社交功能支持（关注、点赞、评论）
- 文件管理系统
- 验证系统（邮件验证码、手机验证码）
- 多语言支持（zh\_CN、en）
- 后台管理基础框架

### 开发工具

[](#开发工具)

- Laravel Telescope（调试和监控）
- Laravel Pulse（性能监控）
- Laravel Pint（代码风格检查）
- PHPUnit（单元测试）
- Laravel Sail（Docker 开发环境）

安装
--

[](#安装)

### 1. 创建项目

[](#1-创建项目)

```
composer create-project larva/laravel-skel:dev-master -vv
```

### 2. 环境配置

[](#2-环境配置)

```
# 创建配置文件
cp .env.develop .env

# 生成应用密钥
php artisan key:generate

# 配置数据库等相关信息
vim .env
```

### 3. 安装依赖与初始化

[](#3-安装依赖与初始化)

```
# 安装 Composer 依赖
composer install

# 安装 NPM 依赖（如果需要前端资源）
npm install

# 运行数据库迁移和填充数据
php artisan migrate --seed

# 创建存储软链接
php artisan storage:link
```

目录结构
----

[](#目录结构)

```
app/
├── Events/          # 事件类
├── Exceptions/      # 异常处理类
├── Http/
│   ├── Controllers/ # 控制器
│   ├── Middleware/  # 中间件
│   ├── Requests/    # 表单请求验证
│   └── Resources/   # API 资源
├── Models/          # 数据模型
│   └── Traits/      # 模型 Traits
├── Policies/        # 授权策略
├── Providers/       # 服务提供者
├── Services/        # 服务层
└── Support/         # 辅助功能

```

核心功能
----

[](#核心功能)

### 用户系统

[](#用户系统)

- 用户注册、登录、找回密码
- 用户组管理
- 用户资料管理
- 积分系统
- 社交功能（关注、点赞、评论）

### 认证授权

[](#认证授权)

- 基于 Sanctum 的 API 认证
- 完整的授权策略（Policies）
- 角色权限管理

### 系统功能

[](#系统功能)

- 文件上传和管理
- 验证码系统（邮件、短信）
- 系统设置
- 多语言支持

开发工具使用
------

[](#开发工具使用)

### 代码规范检查

[](#代码规范检查)

```
./vendor/bin/pint --test
```

### 运行测试

[](#运行测试)

```
./vendor/bin/phpunit
```

### 使用 Sail（Docker）

[](#使用-saildocker)

```
# 启动开发环境
./vendor/bin/sail up -d

# 运行命令（例如：artisan）
./vendor/bin/sail artisan
```

### Docker 部署

[](#docker-部署)

```
# 构建 Docker 镜像
docker build --build-arg ENV=develop -t laravel_skel .

# 运行容器
docker run -p 8787:8787 -d laravel_skel
```

监控与调试
-----

[](#监控与调试)

### Telescope

[](#telescope)

- 访问路径：`/telescope`
- 用途：查看请求、命令、队列等调试信息
- 仅在开发环境中启用

### Pulse

[](#pulse)

- 访问路径：`/pulse`
- 用途：实时监控应用性能、服务器状态
- 可配置在生产环境使用

贡献
--

[](#贡献)

欢迎提交 Issue 和 Pull Request。

许可证
---

[](#许可证)

本项目基于 MIT 协议开源。

###  Health Score

40

—

FairBetter than 88% of packages

Maintenance90

Actively maintained with recent releases

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~4 days

Total

4

Last Release

60d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/534cdb651e8c806590fa945c6b5a18f361613848e890db1349f4a9fbcae1a650?d=identicon)[xutongle](/maintainers/xutongle)

---

Top Contributors

[![xutongle](https://avatars.githubusercontent.com/u/46956076?v=4)](https://github.com/xutongle "xutongle (79 commits)")

---

Tags

apiframeworklaravelSkeletonkitskel

###  Code Quality

TestsPHPUnit

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/larva-laravel-skel/health.svg)

```
[![Health](https://phpackages.com/badges/larva-laravel-skel/health.svg)](https://phpackages.com/packages/larva-laravel-skel)
```

###  Alternatives

[bagisto/bagisto

Bagisto Laravel E-Commerce

26.2k161.6k7](/packages/bagisto-bagisto)[unopim/unopim

UnoPim Laravel PIM

9.4k1.8k](/packages/unopim-unopim)[krayin/laravel-crm

Krayin CRM

22.0k32.8k1](/packages/krayin-laravel-crm)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
