Masterlab 作为众多项目管理系统中的后起之秀,我个人是非常喜欢的,对于中、小型软件开发团队来说,是一个功能够用、好用、思路清晰、界面清新、操作流畅的系统。它上手非常简单,开发人员打开一看,几乎是秒懂,完全零学习成本,真正是开箱即用,非常的友好。我们团队自从用了Masterlab后,腰不酸了、腿不疼了,一口气都能爬上梧桐山了!
Masterlab基于事项驱动和敏捷开发,适用于互联网团队进行高效协作和敏捷开发。界面和gitlab很像,左侧主菜单,右侧顶部是二级菜单和三级菜单,所有页面非常一致,交互也很一致,学习成本很低。功能方面,Masterlab又和Jira很像,相当于Jira的简化版,但是主要功能又很完善。不过,最重要的是,Masterlab社区版式免费的。
很多时候,PHP项目令人诟病的一点就是:部署相对复杂,依赖的服务和支持较多,对于非PHP开发人员,部署起来确实不是很友好,有时候甚至是不知道从何做起,有时候是“从入门到放弃”,白白错失了好东西。
是的,Masterlab就是用PHP开发的,所以,它部署起来也确实和其它PHP项目一样有点复杂。但是,对于它优秀的功能来说,安装部署的辛苦都是值得的。最近,Masterlab终于发布了2.0版本,相对于之前的1.2版本,有了很多进步,修复了很多bug,变得更强大,更易用了。为了让需要的人都能用起来,斗胆来写一篇 Masterlab v2.0.1 的教程,给有需要的人,也算为Masterlab社区做点贡献。
一个PHP站点,想要跑起来,大概需要以下的东西:
- 操作系统。通常是Windows或者Linxu,当然,它们各自又有多种版本或者发行版;
- 网站服务器。通常是Apache、Nginx或者IIS,它是一个Web服务器;
- PHP的某个版本。Web服务器遇到PHP脚本时,会交给PHP解释程序来执行;
- MySQL的某个版本;
上面是最基本的需求了。Masterab 2.0.1对服务器的要求不高,对于百人以内的团队,普通单机服务器应付起来也是绰绰有余的。我们不谈硬件,只讲软件安装。
这个教程我准备分两个操作系统来讲解:Windows
和Liunx
。Windows我们基于Windows 7
,Linxu我们基于CentOS 7.7
,不同的Windows版本和不同的Linux发行版的话,大家可以作为参考,大同小异。
一、在Windows 7上安装 Masterlab 2.0.1
虽然并不推荐使用Windows作为Masterlab的生产服务器,但是,为了预览和学习的话,在Windows上部署Masterlab也是有需求的。为了简化操作,提高成功率,Windows 7 上的安装我们使用成熟的PHP的运行环境套件XAMPP
进行安装。选择XAMPP
的原因,是因为它已经十多年了,一直积极的更新维护,用它能够建立非常纯粹的apache+php运行环境,并且自带MySQL服务器。
1、下载和安装PHP运行环境套件XAMPP
XAMPP的官网是https://www.apachefriends.org/index.html,最新版是7.4.3
。如果官网很难打开,也可以到sourceforge.net
下载,下载页面在:https://sourceforge.net/projects/xampp/files/latest/download,文件链接为:https://nchc.dl.sourceforge.net/project/xampp/XAMPP%20Windows/7.4.3/xampp-windows-x64-7.4.3-0-VC15-installer.exe。下载完成后,运行安装程序,选择组件如下:
我们只需要Apache、MySQL、PHP和phpMyAdmin。phpMyAdmin是一个管理MySQL数据库的浏览器客户端程序。
安装位置尽量不要选择安装到C盘,C盘的权限比较严格,可能会有权限问题。
XAMPP中,Apache和MySQL有两种运行方式:
- 作为系统服务运行:安装为Windows系统服务,服务会随电脑启动自动运行;
- 作为后台程序运行:每次需要启动Apache和MySQL时,都要打开XAMPP控制面板,点击“start”按钮,手工启动它们,作为后台程序运行;
我们选择把Apache和MySQL安装为系统服务,这样就可以免维护了,相当方便。服务器启动时,Apache和MySQL会自动启动。
如果没有意外,Apache和MySQL服务就会启动成功。但是如果遇到端口(80、443、3306)占用的话,XAMPP会在日志里显示红色字体,提示出错信息。
这时,打开浏览器,访问 http://localhost
查看PHP版本信息,我们这个版本是64位的线程安全(Thread Safety)版本的PHP7.4.3。获取这个信息用于下载正确的Redis扩展
。
Masterlab
支持使用Redis
作为缓存服务器来加速站点,不过,Redis服务器
对于Masterlab
来说是可选的。如果选择使用Redis
,可以参考下面的内容,否则,可以直接跳过Redis
服务器安装部分。
XAMPP
默认没有为PHP安装Redis扩展
,我们要为它手工安装上。从PHP官网下载Redis扩展
https://windows.php.net/downloads/pecl/releases/redis/5.2.0/php_redis-5.2.0-7.4-ts-vc15-x64.zip,解压缩后,把压缩包里的php_redis.dll
放到 xampp/php/ext
目录下,编辑PHP配置文件 xampp/php/php.ini
, 搜索extension=pdo_mysql
字样,在这一行下面增加一行extension=redis
,然后重新启动Apache
服务。
重启Apache
服务后,刷新PHPInfo
页,确认Redis扩展
已加载,如下图:
PHPinfo如果现实了
Redis扩展
信息,说明Redis扩展
安装成功。
现在,XAMPP
安装完成,接下来我们安装Redis服务器
软件。
2、安装Redis
从Github上下载Redis服务器
的Windows安装程序版本。下载页面:https://github.com/microsoftarchive/redis/releases,下载链接:https://github.com/microsoftarchive/redis/releases/download/win-3.0.504/Redis-x64-3.0.504.msi,下载后执行安装程序,一路“next”即可安装完成,安装完成后,Redis服务器
即在后台运行了。这个版本的Redis服务是微软官方打包的,会安装成Windows系统服务
,并随计算机启动而自动启动。Redis服务默认使用的端口是6379
,如果端口占用,会导致Redis服务无法启动。
3、下载Masterlab v2.0.1
从Masterlab官网http://www.masterlab.vip/download.php下载最新的安装包Masterlab-v2.0.1.zip,并解压缩到D:\www\masterlab
下。加压缩后,会得到一个masterlab_full
文件夹。
4、创建Masterlab站点
1) 使用虚拟主机架设站点
如上图,打开Apache所在的文件夹,用文本编辑器打开apache/conf/extra/httpd-vhosts.conf
,在文件末尾添加如下内容:
<VirtualHost *:80>
DocumentRoot "D:\www\masterlab_full\app\public"
ServerName www.masterlab.cn
<Directory "D:\www\masterlab_full\app\public">
AllowOverride All
Require all granted
</Directory>
</VirtualHost>
保存配置后,使用XAMPP控制面板重启Apache服务。
用文本编辑器打开:C:\Windows\System32\drivers\etc\hosts
文件,在文件末尾添加如下一行:
上面我们是以内网虚拟主机安装举例的,域名使用的是www.masterlab.cn
,这个域名并不是互联网注册的域名,所以我们需要使用hosts文件解析域名。可以根据自己团队的实际情况确定域名和服务器IP地址。
如果是在公网服务器上安装,则需要自行添加正确的域名解析。
如果使用内网虚拟主机的方式部署Masterlab站点,团队全部成员都需要在自己的电脑添加hosts条目来解析这个域名。如果团队使用一个自己架设的DNS服务器,那么只需要在DNS服务器上解析这个域名即可。
2)使用IP地址访问站点
如果希望使用IP的方式来访问站点,那么就需要修改xampp/apache/conf/httpd.conf
,找到
DocumentRoot "D:/xampp/htdocs"
<Directory "D:/xampp/htdocs">
把路径改为D:\www\masterlab_full
,然后重启Apache。但是,用这种方式的话,就无法再访问XAMPP提供的管理工具。
保存后,使用XAMPP控制面板重新启动Apache服务。
5、安装Masterlab
使用谷歌浏览器访问:http://www.masterlab.cn/install
点击“同意协议进入安装”按钮,
如果是按照上面的步骤安装的,服务器环境检测是保过的。点击“下一步”,
这一步是配置MasterlabSocket
异步服务器和Redis
服务器。Masterlab
通过MasterlabSocket
异步服务器执行异步的操作,比如邮件发送等任务。为了提升性能,Masterlab
使用Redis
服务器作为缓存服务器,在使用前需要正确配置。我们刚才安装了Redis
服务器,所以,我们选择启用Redis
服务器,使用默认的配置即可,我们没有为Redis
服务器配置密码,密码留空即可。稍等我们安装MasterlabSocket
服务器。点击“下一步”
这一步需要填写数据库信息,我们使用默认的数据库名masterlab
,数据库用户root
,因为XAMPP安装的MySQL的root用户默认是没有密码的,所以这里数据库密码留空。如果你修改了数据库密码,这里填写正确的密码即可。
安装程序生成的默认账号是:master
,密码是:123456
。
6、启动MasterlabSocket异步任务服务器
从资源管理器打开D:\www\masterlab_full\bin
,找到masterlab_socket.exe
,双击执行它即可