贡献代码-v1.x分支

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

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

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

FastAdmin 开源框架 v1.x 采用的是 bower 作为前端组件管理，以下是关于 FastAdmin v1.x 分支的贡献说明，请查看。

仓库分支： https://gitee.com/karson/fastadmin/tree/1.x/

开始之前

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

• 《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/

安装工具

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

1. Git 强大的开源版本管理软件。
   下载地址： https://git-scm.com/
2. composer php 依赖管理。
   下载地址：https://getcomposer.org/
3. node.js 前端环境。
   下载地址：https://nodejs.org/
4. bower 前端组件管理。
   npm install -g bower

首次配置

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

操作流程

以 FastAdmin 的 Gitee 仓库为例：

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

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

    git clone -b 1.x https://gitee.com/<yourname>/fastadmin.git

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

    cd fastadmin
    git checkout 1.x

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

    composer update -vvv
    bower install

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

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

    git push

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

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