贡献代码

FastAdmin 致力于服务开发者，努力为开发者节省更多的时间。

参与开源社区的方式有很多种，比如：使用开源、推荐开源、写书写教程、贡献代码、回答社区问题、总结经验、打赏赞助等等，这些都可以让开源可持续的发展下去，开源更像是一群志同道合的小伙伴们同时开发一个有趣的项目，并吸引更多有趣的小伙伴们加入。

欢迎广大开发者朋友们贡献自己的智慧，让 FastAdmin 变得更强大，让 FastAdmin 变得更完美，最终为你节省更多的时间，让大家有更多的时间读书、健身、开源、投资、帮朋友和陪家人。

FastAdmin 从 v1.6.0 开始使用了 npm 作为前端组件的管理，废弃了原来的 bower ，以下是关于 FastAdmin 的贡献说明，请查看。

开源仓库

FastAdmin 开源框架仓库地址如下：

• FastAdmin 组织 https://gitee.com/fastadminnet
• FastAdmin Gitee 仓库地址 https://gitee.com/fastadminnet/fastadmin
• FastAdmin Github 仓库地址 https://github.com/fastadminnet/fastadmin
• ThinkPHP 框架核心 Gitee 仓库地址 https://gitee.com/fastadminnet/framework

开始之前

请严格遵循以下代码标准：

• 《PSR-12 编码规范扩充》 https://www.php-fig.org/psr/psr-12/
• 使用 4 个空格作为缩进
• 《语义化版本规范》 v2.0.0 https://semver.org/lang/zh-CN/
• 《git commit 约定式提交规范》 v1.0.0 https://www.conventionalcommits.org/zh-hans/v1.0.0/

php 版本特别说明：FastAdmin 框架v1.6.x 推荐使用 php7.4，v1.7.x 推荐使用 php8.0，安装前请切换到对应的 php 版本，其它环境要求请参考文档的 安装 章节。

安装工具

以下为 FastAdmin 开发环境必备工具：

1. Git 强大的开源版本管理软件。
   下载地址： https://git-scm.com/
2. composer php 依赖管理。
   下载地址：https://getcomposer.org/
3. node.js 前端环境。
   下载地址：https://nodejs.org/
4. npm 前端组件管理
   安装 node.js 后会自带 npm
5. grunt 前端构建工具
   安装命令：npm install -g grunt-cli

首次配置

1. 设置 Git 的昵称和邮箱地址。
2. 配置 composer 为国内源。
3. 配置 npm 为国内源。

操作流程

以 FastAdmin 的 Gitee 仓库为例：

1. 首先进入 FastAdmin 仓库网页， Fork FastAdmin 仓库到自己的账号名下。

2. 然后 Clone 到自己的本地。

    git clone https://gitee.com/<yourname>/fastadmin.git

3. 进入 fastadmin 目录，并切换到 1.x-dev 分支。

    cd fastadmin
    git checkout 1.x-dev

4. 安装前后端依赖组件。

    composer update -vvv
    npm install --ddd
    npm run build

5. 安装 FastAdmin 后台框架。
   在 Web Server（Apache/NGINX）新建一个站点，设置运行目录为 public ，打开站点的域名进行在线安装，详细请参考文档的安装章节。
6. 编写代码并测试。
   在本地新增功能或者修复 Bug，进行测试，并将代码提交到本地 Git 仓库。

7. 推送到自己的远程仓库。

    git push

8. 创建合并请求。
   进入 FastAdmin 的 Gitee 仓库的网页，点击 Pull Request 创建合并请求，源分支选择自己仓库的 1.x-dev，目标分支选择 FastAdmin 官方仓库的 1.x-dev，详细描述你的合并请求。

为节省你的宝贵时间，请详细的描述一下合并请求，比如新功能描述详细的使用方法，修复 Bug 时写出详细的复现过程和环境，这样可以节省你的时间并更快的得到回应或合并，感谢支持 FastAdmin，感谢支持国内的开源社区。

FastAdmin 开源贡献者名单

FastAdmin 开源后还有更大的惊喜，我们结识了一群有趣的小伙伴，有小伙伴为 FastAdmin 赞助服务器的，有为 FastAdmin 打赏支持的，还有参与到 FastAdmin 生态建设中的，截至 2025-05-18 已经有 100 位小伙伴为 FastAdmin 贡献了代码，以下为 FastAdmin 开源贡献者名单，感谢支持 FastAdmin，感谢支持国内的开源社区。
开源贡献者名单（实时更新） https://gitee.com/karson/fastadmin/contributors?ref=1.x

报告BUG

在使用 composer 或 npm 命令时需保障网络流畅，可以自行使用国内的镜像地址，可能需要连接到 Github，需要保证网络畅通。

FastAdmin 开源后台框架的 Bug 或建议请帮忙提交到 Gitee Issues 中，谢谢。

文档日志

• 2025-03-31，FastAdmin 从 v1.6.0 开始采用了 npm 管理前端组件，弃用了 bower 前端管理工具。
• 2025-06-11，php 版本说明：v1.6.x 推荐使用 php7.4，v1.7.x 推荐使用 php8.0，安装前请切换到对应的 php 版本。