PHPackages                             larva/laravel-skeleton - 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-skeleton

ActiveProject[Framework](/categories/framework)

larva/laravel-skeleton
======================

The skeleton application for the Laravel framework.

10JavaScriptCI passing

Since Feb 5Pushed 4mo agoCompare

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

READMEChangelogDependenciesVersions (1)Used By (0)

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

[](#laravel-api-模板)

[![Tests](https://github.com/larva-cool/laravel-skeleton/actions/workflows/tests.yml/badge.svg)](https://github.com/larva-cool/laravel-skeleton/actions/workflows/tests.yml)[![Total Downloads](https://camo.githubusercontent.com/2050ee98134f6ff8121d69a95a0ba644f5b463aedfd46eefaf6c21c69301c7ba/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c617276612f6c61726176656c2d736b656c65746f6e)](https://packagist.org/packages/larva/laravel-skeleton)[![Latest Stable Version](https://camo.githubusercontent.com/8cfa086031fc2141831af99f5e0aff2f7b576c2e95c81eb4c16fa93bc97545b5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c617276612f6c61726176656c2d736b656c65746f6e)](https://packagist.org/packages/larva/laravel-skeleton)[![badge](https://camo.githubusercontent.com/efaa3e5e739bf25015e80ce0f8d8644ee7e409fe0fa3dd9519e454c06c0c1d11/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c65746f6e2f2d2f62616467652f6769742f6c61746573742f636f64652f7673636f64652d73746172746564)](https://camo.githubusercontent.com/efaa3e5e739bf25015e80ce0f8d8644ee7e409fe0fa3dd9519e454c06c0c1d11/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c65746f6e2f2d2f62616467652f6769742f6c61746573742f636f64652f7673636f64652d73746172746564)[![badge](https://camo.githubusercontent.com/153d8797c5e7d50b9fc1696da2db331520d2f5bb8c41ccbce16b1e6598efe4b1/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c65746f6e2f2d2f62616467652f6769742f6c61746573742f63692f706970656c696e652d61732d636f6465)](https://camo.githubusercontent.com/153d8797c5e7d50b9fc1696da2db331520d2f5bb8c41ccbce16b1e6598efe4b1/68747470733a2f2f636e622e636f6f6c2f6c617276612d636f6f6c2f6c61726176656c2d736b656c65746f6e2f2d2f62616467652f6769742f6c61746573742f63692f706970656c696e652d61732d636f6465)

这是一个基于 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-skeleton: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
```

监控与调试
-----

[](#监控与调试)

### Telescope

[](#telescope)

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

### Pulse

[](#pulse)

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

贡献
--

[](#贡献)

欢迎提交 Issue 和 Pull Request。

许可证
---

[](#许可证)

本项目基于 MIT 协议开源。

###  Health Score

18

—

LowBetter than 8% of packages

Maintenance50

Moderate activity, may be stable

Popularity2

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity12

Early-stage or recently created project

 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.

### 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 (129 commits)")

### Embed Badge

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

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

###  Alternatives

[laravel/dusk

Laravel Dusk provides simple end-to-end testing and browser automation.

1.9k39.6M299](/packages/laravel-dusk)[nineinchnick/edatatables

Grid widget for the Yii Framework, wrapper for the DataTables jQuery plugin

173.2k](/packages/nineinchnick-edatatables)[link-cloud/fast-hyperf

LinkCloud Fast Hyperf

241.2k1](/packages/link-cloud-fast-hyperf)

PHPackages © 2026

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