开源需要大家一起来支持,支持的方式有很多种,比如使用、推荐、写教程、保护生态、贡献代码、回答问题、分享经验等;欢迎您加入我们!
# 操作流程
# BuildAdmin 的开源仓库地址如下:
# 以 Gitee 仓库为例
# Fork和克隆
首先进入BuildAdmin
仓库网页 (opens new window),Fork
仓库到自己的账号下。
然后克隆Fork的仓库到本地,然后进入buildadmin
目录
git clone https://gitee.com/<yourname>/buildadmin.git
cd buildadmin
# 安装后端依赖和启动安装服务
composer install
php think run
浏览器访问:127.0.0.1:8000 (opens new window),根据引导完成安装。
# 编写代码并测试
- 在本地新增功能或者修复 Bug,进行测试,并将代码
commit
到本地 Git 仓库; - 请确保
commit
时已经还原安装程序造成的文件修改,主要是以下文件:
.env-example
config/buildadmin.php
config/database.php
# 可能会有其他文件,请保证提交的文件仅新增功能或修复Bug产生的文件变更即可
# 还原单个文件的命令
git restore <文件名>
- 提交时请参考提交规范 (opens new window)。
- 接下来,推送到自己的远程仓库。
git push
# 创建合并请求
进入您Fork
的 BuildAdmin 仓库的页面,点击 Pull Request 创建合并请求,源分支选择自己仓库的 v2,目标分支选择 BuildAdmin 官方仓库的 v2,详细描述你的合并请求。
# 代码规范
- 请参考 代码编辑器配置 (opens new window) 文档完成编辑器的配置。
web
端代码可以直接执行pnpm format
命令和pnpm lint
检查和格式化代码。server
端代码使用了 psr-12 (opens new window) 代码规范,请参考以上第1点
完成配置,然后使用Ctrl+Alt+L
来格式化代码。- 所有文件使用
LF
作为换行符。 - 所有文件必须且只可使用不带
BOM
的UTF-8
编码。 - 类名必须以类似
StudlyCaps
形式的大写开头的驼峰命名方式声明。 - 方法名称必须符合
camelCase()
式的小写开头驼峰命名规范。