XinAdmin 是面向 PHP 开发者的中后台快速开发框架，主打少写重复代码、快出可用系统，预置用户管理、权限控制、数据字典及 CRUD 页面，支持 ThinkPHP8、Laravel12、Webman 等多内核版本，提供可视化建表、一键生成 CRUD、按钮级权限、Swagger 接口文档自同步等能力。
XinAdmin 是一套面向 PHP 开发者的中后台快速开发框架，核心价值不是“写更多代码”，而是“少写重复代码、快出可用系统”。它不强制你从路由、控制器、模型一层层搭起，而是把用户管理、权限控制、数据字典、CRUD 页面这些高频模块都预置好，你只需聚焦业务字段和逻辑。
明确你的技术栈版本
XinAdmin 目前提供多个后端内核版本，选错会卡在环境搭建第一步：
- 推荐新手/主流项目：用 XinAdmin-Think（基于 ThinkPHP8 + PHP8.2），文档最全、更新较勤、社区示例多；
- 已有 Laravel 项目基础或偏好 Eloquent 模式：选 XinAdmin-Laravel（Laravel12 + React 前端）；
- 追求更高并发性能、轻量部署：可试 XinWebman（Webman 框架版本），但生态插件略少；
- 想直接做内容站点（如企业官网、博客）：XinCms 是基于 XinAdmin 的开箱即用 CMS 版本，含文章、栏目、模板管理。
三步跑通第一个后台页面
以 XinAdmin-Think 为例，跳过复杂配置，直奔核心流程：
-
初始化项目：用 Composer 创建项目（
composer create-project xin-admin-think myadmin），执行php think install完成数据库和初始管理员创建； -
可视化建表：登录后台（默认地址
/admin，账号 admin / 123456），进入「系统管理 → 数据表管理」，点“新建”，填表名（如product）、加字段（名称、价格、状态、图片等），类型全部点选，无需写 SQL； - 一键生成 CRUD：保存表后，勾选该表，点击「生成代码」，平台自动产出控制器、模型、前端列表页/表单页，并注入到菜单系统。刷新左侧菜单，就能看到“商品管理”，点开即可增删改查。
权限与扩展怎么配
它不是“所有功能都塞给你”，而是按需启用：
立即学习“PHP免费学习笔记（深入）”；
-
按钮级权限：在菜单管理里编辑某菜单项，开启“按钮权限”，然后为每个按钮（如“导出”“审核”）分配唯一标识符（如
product:export），前端按钮自动根据当前用户权限显示或隐藏； -
接口文档自同步：在控制器方法上加 Swagger 注解（如
@ApiOperation("获取商品列表")），运行php think swagger:generate，前端 UmiJS 就能自动生成调用代码和 TypeScript 类型定义； -
自定义逻辑不破坏结构：想在新增商品时自动计算库存预警？不用改生成的控制器，只需在模型的
afterSave钩子里写业务代码，框架保留所有扩展入口。
注意几个实际易踩的点
避开常见卡点，能省下大半天调试时间：
- 确保 PHP 版本 ≥ 8.2（低版本会报错，尤其注解解析和类型声明）；
- MySQL 推荐 5.7+ 或 8.0，避免使用 SQLite 做生产环境（XinAdmin 默认设计面向真实关系型数据库）；
- 前端资源（React 页面）首次运行需执行
npm install && npm run build，否则访问空白； - 若部署到子目录（如
https://xxx.com/myadmin），需同步修改.env中的APP_URL和前端config/base.ts的base路径。
