信息系统开发之本地打开（以docs为例）

1. 软件下载

从以下链接中下载开发我们所需要的软件：

在线文档帮助系统https://docs.ecnulab.cn/view/article/16

【注意】

1. Sourcetree 下载3.4.7版本

2. Sourcetree 用户名命名需要真实姓名、长期使用邮箱

···下面是后续操作，注意保持xampp中mysql打开状态

2. 克隆

下载完成sourcetree后，新建Repos根目录，并在根目录下新建如下三个文件夹

按照如下图片以及文件内容 依次从四个URL克隆到本地：

docs@ecnulab.cn:~/prjDocs

docs@ecnulab.cn:~/manDocs

docs@ecnulab.cn:~/docs

docs@ecnulab.cn:~/globalPackages

打开 Sourcetree，点击 文件 ---> 克隆

点击克隆 弹出用户名和密码窗口，按照我们提供的用户名密码如实填写即可

克隆成功后，点击获取

点击确定

等待片刻后如不报错则服务器通，连接成功

在Repos\dbscripts\docs中，创建自己的新分支 dev_***  (下划线后的字母是自己名的首字母+姓的首字母，例：李小四的分支命名为 dev_xsli）（此处仅演示数据库所需库，同理，对其他文件操作也应在自己的分支下进行）

空心圆表示当前版本（在本地看到的版本），如空心圆不在最上面，则表明当前版本不是最新版本，需要进行合并（一定在创建分支后进行）

弹出窗口无需勾选，合并后更新为最新版本

3. 数据库的配置

打开navicat，首先新建一个MariaDB连接，命名为root@localhost

可以通过测试连接测试是否能够成功创建

 创建成功后双击连接打开，右击连接，选择新建数据库，输入我们的数据库名docs，选择如下字符集和排序规则

新建数据库成功后，单击用户，选择新建用户

按照如下填写，用户名即为项目名称，此处以docs为例，密码同样设置为项目名称，点击保存后自动填充插件

单击权限，选择添加权限

 在弹出的对话框中，选择我们的数据库docs勾选，之后右击右侧任意位置，选择全部授予，点击确定

点击保存

保存之后，再次新建一个MariaDB连接，注意此时用户名和密码输入我们刚刚新建用户的用户名和密码，测试连接成功（先不要点击确定，还有后续操作，如点击可进行连接编辑）

点击高级，设置位置为dbscripts的位置（图中设置高一级）

点击数据库——勾选使用自定义数据库列表——勾选docs——点击确定

 创建成功后，右击关闭 root@localhost 连接，再关闭 navicat（此处关闭是为了没有警示窗）

再次打开navicat，双击docs@localhost打开连接，打开数据库，此时查询已被导入

注意运行tables、tablesofviews两个查询，显示如下即为运行成功，注意不要轻易误修改查询内容

至此，数据库准备完毕

4. 代码运行

使用VScode打开文件Repos\projects\prjDocs

找到.env.example文件，并在源路径下粘贴一个相同的文件，更改复制文件的名字为.env

对.env文件的13/14/15行、53行做如下操作（53行此处为老师的UID，同学们请填入自己的UID）

打开终端（ctrl+j）

输入npm i         ——此操作用于安装项目依赖的包。

成功后再输入composer install            ——用来安装项目所需的依赖项。

成功后运行npm run dev进行前端打包 ，运行成功程序就绪

输入php artisan serve，进行服务器的准备

摁住ctrl点击图中链接或复制连接（http://127.0.0.1:8000）到浏览器中打开

5. 网页

首次进入网页时，网页显示如下，在.env文件中第三行APP_KEY为空

单击如下位置，此时再去观察APP_KEY，此时显示即为加密密钥

点击后此处会出现Refresh now，点击此处，就显示出我们开发的网站

至此所有步骤结束