---
url: /docs/5.0/intro.md
---
# CatchAdmin V5 介绍 - 专业的 PHP Laravel 后台管理系统

> 基于 Laravel 13.x 和 Element Plus 的现代化 php 开源后台管理 解决方案

`CatchAdmin`是一款基于[Laravel 12.x](https://laravel.com)和[Element Plus](https://element-plus.org)二次开发而成的 PHP 开源后台管理系统。`Laravel` 社区也有许多非常优秀的后台管理系统，例如 `Nova`, 官方出品，当然是收费的，免费的有基于 `Livewire` 的 `Filament`，还有不得不说的 `Laravel Admin`。它采用前后端分离架构，CatchAdmin 集成了 Token 鉴权、权限管理、动态路由、动态表格、分页封装、资源权限、上传下载、代码生成器支持一键导出导入，数据回收站，附件管理的一款模块化框架。`Laravel` 框架仅仅作为 `Api` 输出。将管理系统模块之间的耦合降到了最低限度。每个模块之间都有独立的控制器，路由，模型，数据表。在开发上尽可能将模块之间的影响降到最低，降低了开发上的难度。基于 `CatchAdmin `可以开发 `CMS`，`CRM`，`OA` 等 等系统。也封装了很多实用的工具，提升开发体验。

作为一款专业的 **laravel admin** 解决方案，CatchAdmin 在众多 **PHP 后台开源管理系统** 中脱颖而出：

## 🚀 技术优势

* **现代化架构**: 基于 Laravel 12.x 最新版本，充分利用 PHP 8+ 特性
* **前后端分离**: Vue 3 + Element Plus 前端，Laravel RESTful API 后端
* **模块化设计**: 每个业务模块完全独立，支持按需加载和扩展
* **开箱即用**: 内置完整的权限管理、用户管理、日志系统

## 快速开始

极速安装项目，五分钟即可构建。详细[安装文档](./start/install.md)

```shell
composer create catchadmin/catchadmin

cd catchadmin

php artisan catch:install
```

## 功能

* ☑️ **用户管理**：支持用户新增/编辑/删除/禁用、密码重置与基础信息维护；不同用户登录后台可呈现不同首页与可见功能模块
* ☑️ **部门管理**：支持公司/部门/小组多级组织架构配置与维护，树形结构展示，支持层级调整与人员归属管理
* ☑️ **岗位管理**：岗位（职务）统一维护与分配，支持主岗位/多岗位配置，为权限控制与业务流程提供身份基础
* ☑️ **角色管理**：树结构角色体系，支持角色菜单权限、按钮级权限分配与数据权限配置，满足精细化授权需求
* ☑️ **菜单管理**：可视化配置系统菜单、路由与按钮资源，支持排序/层级/隐藏等管理，实现前后端一致的权限控制
* ☑️ **字典管理**：集中维护枚举/状态/类型等基础数据，支持分组与启用禁用，便于统一复用并减少硬编码
* ☑️ **系统配置**：系统常用参数集中管理，支持分类维护与动态读取，配置调整可快速生效，降低运维与二开成本
* ☑️ **操作日志**：记录关键操作与变更轨迹，支持按用户/模块/时间多维检索，便于审计追溯与问题定位
* ☑️ **登录日志**：记录登录历史与访问信息（如时间/IP/设备等，按实现为准），支持查询统计与异常排查
* ☑️ **文件上传**：统一上传能力，支持 `本地`、`七牛云`、`阿里云`、`腾讯云` 等存储方式，按配置灵活切换
* ☑️ **附件管理**：对系统上传的文件/图片等资源集中管理，支持检索、预览与清理维护，避免资源冗余
* ☑️ **数据表维护**：支持数据表碎片清理与优化，并提供数据回收与销毁管理能力，保障系统长期稳定运行
* ☑️ **代码生成**：一键生成前后端代码（`php`、`vue`）及数据库迁移文件，支持直接生成到模块，显著提升开发效率
* ☑️ **支持 Vue 即时渲染**：支持前端 Vue 即时渲染，无需编译即可生效，加快开发调试与迭代速度
* ☑️ **支持插件系统**：插件即 Composer 包，深度融入 Composer 生态，支持模块化扩展与快速集成
  * 文档：[CatchAdmin 插件快速开始](https://doc.catchadmin.com/docs/5.0/plugin/quickstart)

## 体验地址

[v5 demo 地址](https://v5.catchadmin.com)

\[超管账户]

* 账户: `catch@admin.com`
* 密码: `catchadmin`

\[测试账户]

* 账户: `test@admin.com`
* 密码: `Testadmin1`

## 💼 适用场景

* **企业后台管理**: 适合中小企业快速搭建内部管理系统
* **SaaS 平台**: 为 SaaS 产品提供标准化的管理后台基础
* **内容管理**: CMS、博客、新闻等内容管理系统
* **电商后台**: 商品管理、订单处理、客户服务等电商场景
* **项目管理**: OA 办公、CRM 客户关系管理等企业应用

## 架构特性

`CatchAdmin` 聚焦于 PHP Laravel 后台管理 的工程实践，保持前后端分离，让 `Laravel` 只负责标准化的 `RESTful API` 和权限校验，前端则依赖 `Element Plus` 提供可扩展的 UI 组件。这样的模块化设计确保核心业务逻辑与界面层完全解耦，在迭代时能够快速响应复杂的企业需求。

* 灵活的模块拆分：控制器、路由、模型与数据表保持独立，便于按需组合或裁剪，实现面向领域的 laravel 后台 规划。
* 完整的扩展生态：基于 `Laravel` 既有能力和 `CatchAdmin` 封装的工具集，可以平滑接入第三方服务，减少 php 后台管理 项目常见的重复开发成本。
* 企业级运维友好：标准化的接口设计与日志体系便于团队在容器化环境下部署和监控，为长期维护 laravel admin 项目提供保障。

### 📊 核心功能详解

**权限管控**: CatchAdmin 采用业界标准的 RBAC (Role-Based Access Control) 权限模型，支持：

* 多角色授权、角色继承
* 菜单权限、按钮权限、数据权限三级管控
* 部门数据隔离、个人数据权限
* API 接口权限验证

**开发效率**: 作为专业的 **laravel 后台** 框架，内置多种开发加速工具：

* 一键 CRUD 生成，减少重复代码编写
* 标准化 API 接口规范
* 完整的前端组件库
* 详细的开发文档和示例代码

## 业务场景

`CatchAdmin` 已在多种业务中验证：以 `CMS` 内容平台为例，团队可以通过可视化菜单与权限配置快速建立内容审核流程；在 `CRM` 或销售管理场景中，借助灵活的岗位与角色绑定，实现跨部门协同；针对内部 `OA` 系统，配合操作日志、登录日志等模块，帮助管理者洞察关键行为。这些功能让开发者无需从零搭建 PHP Laravel 后台管理 基座，即可交付稳定的 laravel 后台 产品，并持续在现有 laravel admin 生态中迭代。

## 项目地址

* [github 地址](https://github.com/jaguarjack/catch-admin)
* [gitee 地址](https://gitee.com/jaguarjack/catchAdmin)

## 项目预览

|                                                                      |                                                                |
|----------------------------------------------------------------------|----------------------------------------------------------------|
| ![登录](https://image.catchadmin.com/202512151142046.png)              | ![控制台](https://image.catchadmin.com/202512150841525.png)       |
| ![权限](https://image.catchadmin.com/202512151143109.png)              | ![布局](https://image.catchadmin.com/202512151144233.png)        |
| ![上传](https://image.catchadmin.com/202601101535082.png)              | ![代码生成](https://image.catchadmin.com/202601101536072.png)      |
| ![菜单](https://image.catchadmin.com/202601101537583.png)              | ![模板](https://image.catchadmin.com/202601101538807.png)        |

### 加入微信群

添加微信好友进群


## 赞助

如果项目对你有帮助，或者在工作上帮你节省了开发时间。在力所能及的情况下，可以支持下`Catchadmin`项目, 非常感谢 🙏

## 🛠️ 技术栈

### 后端技术

* **PHP 8.2+**: 利用最新 PHP 特性，性能提升显著
* **Laravel 12.x**: 最新版本的 Laravel 框架，稳定可靠
* **MySQL**: 支持主流关系型数据库
* **Redis**: 缓存和会话存储，提升系统性能
* **Composer**: PHP 依赖管理工具

### 前端技术

* **Vue 3**: 现代化的前端框架，响应式开发
* **Element Plus**: 企业级 UI 组件库，开箱即用
* **TypeScript**: 类型安全，提升代码质量
* **Vite**: 快速的构建工具，热更新支持
* **Pinia**: 状态管理，替代 Vuex

## 📚 学习资源

### 快速入门

1. [安装指南](./start/install.md) - 详细的安装步骤和环境配置
2. [项目介绍](./start/project_intro.md) - 了解项目结构和核心概念
3. [视频教程](./video.md) - 可视化学习，快速上手

### 进阶开发

* [模块开发](./server/modules.md) - 学习如何开发自定义模块
* [权限管理](./server/permission.md) - 深入理解权限体系
* [前端组件](./front/intro.md) - 前端开发指南和组件使用

### 部署运维

* [部署指南](./deploy.md) - 生产环境部署最佳实践
* [常见问题](./faq.md) - 问题排查和解决方案

### 插件开发

* [快速入门](./plugin/quickstart.md) - 插件快速入门开发

## 🏆 成功案例

CatchAdmin 已成功应用于多个行业：

* **教育行业**: 某知名在线教育平台使用 CatchAdmin 构建学员管理系统
* **电商领域**: 多家电商企业基于 CatchAdmin 开发商家后台管理
* **政企服务**: 政府部门采用 CatchAdmin 搭建内部办公管理系统
* **医疗健康**: 医疗机构使用 CatchAdmin 开发患者管理和医生工作站

## 感谢 🙏

> 排名不分先后

* [Laravel](https://laravel.com)
* [Vue](https://cn.vuejs.org/)
* [ElementPlus](https://element-plus.org)
* [Vitepress](https://vitepress.dev/)
* [JetBrains](https://www.jetbrains.com/)