目前在Mac OS系统下可以通过源码包进行安装，并需要自己手动配置 Apache+Mysql+PHP安装环境。

一、禅道运行环境说明

禅道运行环境推荐使用 Apache + PHP(5.3/5.4/5.5/5.6/7.0/7.1版本) + MySQL(5.5/5.6版本)/mariadb组合，Nginx其次。

禅道运行需要pdo, pdo_mysql, json, filter, openssl, mbstring, zlib, curl, gd, iconv这几个模块，请确保PHP环境中都有加载。

在Mac OS系统下推荐使用 Apache+Mysql+PHP，因为OS系统自带Apache与PHP环境，方便配置。

二、配置环境

1. 配置Apache服务

MAC OS环境已内置了Apache服务，只需要启动即可，需输入帐号密码。

Apache 服务器命令

sudo apachectl start //开启Apache服务 
sudo apachectl stop //停止Apache服务 
sudo apachectl restart //重启Apache服务

浏览器访问 localhost 或者127.0.0.1， " It works!"表示服务已启动， 如您不需要修改web资源路径以及端口号，可跳转到PHP环境配置部分。
默认web路径与端口号
Apache默认web资源路径为：/Library/WebServer/Documents/
Apache默认端口号为 80
如果不修改Apache默认配置，请直接跳转到配置php环境。
我们不建议您修改Apache的默认配置，原因如下：

1. 修改其配置文件有一定的危险性。

2. 自定义web路径会涉及文件权限问题，将会导致项目部署启动异常，增加问题解决难度。
3. 后续终端命令，默认为Apache默认访问路径为前提，方便您直接复制执行，如果变更过请将对应的路径替换。
修改Apache默认配置，如您因端口号冲突或者其他原因，需要修改web访问路径与默认端口号，可参考下文。
1. 备份Apache的配置文件
```
sudo cp /etc/apache2/httpd.conf  /etc/apache2/httpd.conf.backup
```
2. 修改web访问路径，打开 httpd.conf 配置文件，查找 " DocumentRoot" ，修改此部分路径，路径中不能出现中文与空格，路径为真实路径，修改后需重启 Apache服务。

3. 端口号修改，搜索 "Listen 80" ，将默认80端口修改为其他端口（注意不要与其他服务端口号冲突），修改后需重启Apache服务。

5. 测试，可在自定义的web路径下，建 index.html 文件，使用 localhost : 自定义端口号/index.html。

6. 访问正常，则自定义配置结束。

2. 配置PHP环境

Mac OS系统已内置了 PHP环境，注意内置的PHP版本号是否与禅道所需版本号匹配。
禅道适用 PHP 运行环境(5.3/5.4/5.5/5.6/7.0/7.1版本) 。
```
php -v
```
整合Apache与PHP，打开Apache配置文件 httpd.conf，搜索 “php”找到 # LoadModule php7_module libexec/apache2/libphp7.so 去掉注释符号 #。
```
sudo vim /etc/apache2/httpd.conf  # 打开httpd.conf 
```
配置完成后，需要 重启Apache服务。

3. 配置mysql 服务

禅道源码包所适用的 Mysql 版本为5.5 或5.6，你可以通过官网或者第三方下载安装包，也可以通过 Homebrew 包管理器安装 Mysql服务。

目前官网不再提供支持Mac OS的5.6版本安装包，本教程推荐通过 Homebrew 命令来下载与安装Mysql 服务。

首先安装 Homebrew 包管理器工具，在终端中执行如下命令，其他资料参考官网： https://brew.sh/index_zh-cn
```
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
```
安装过程需耐心等待，安装完成后执行 brew -v 查看版本，测试是否安装成功。
Homebrew安装后，执行如下命令安装 Mysql5.6，执行过程较慢，需耐心等待。
```
brew install mysql@5.6
```
下载完成后，依次执行如下命令，添加系统环境变量。
```
echo 'export PATH="/usr/local/opt/mysql@5.6/bin:$PATH"' >> ~/.bash_profile
```
加载环境变量。
```
source ~/.bash_profile
```
启动mysql 服务。
```
brew services start mysql@5.6
```

启动服务后，默认是匿名登录，现在初始化 root 账号。
输入 mysql_secure_installation 命令，来初始化 root 账号信息。

Enter current password for root (enter for none) # 第一次登陆root账号密码为空，直接回车
Set root password? # y
New password: # 密码
Re-enter new password:  # 再输一遍密码
Remove anonymous users?  是否删除匿名用户 ？ y
Disallow root login remotely? 是否允许root账号远程登录？ y
Remove test database and access to it?  删除test测试库，对test库的访问权限？ n
Reload privilege tables now? 刷新授权表使修改生效？y

配置完成就可以使用 root 账号与密码登陆了。

如您需要操作Mysql服务，可使用 brew 命令来管理（需要退出mysql执行）。

brew services start mysql@5.6 # 启动 mysql 服务
brew services restart mysql@5.6 # 重启 mysql 服务
brew services stop mysql@5.6 # 停止 mysql 服务

三、安装部署禅道项目

源码包下载地址： https://www.zentao.net/download.html 。

解压禅道源码包
将解压后的文件复制到Apache访问目录下（默认路径为 /Library/WebServer/Documents/）
```
sudo cp -r ~/Downloads/zentaopms/* /Library/WebServer/Documents/
```
安装方式，浏览器访问，本机ip:端口号/www/index.php

安装中出现访问禅道下文件权限问题，执行如下命令。

sudo chmod -R 777 /Library/WebServer/Documents  # 给禅道项目所属文件权限

安装中出现 session.save_path问题，执行如下操作。
修改PHP配置文件，该配置文件默认位于 /etc/php.ini.default
备份 php.ini.default 文件后将 php.ini.default 重命名为 php.ini ，并在文件内搜索 session.save_path = "/tmp" ，修改此 "/tmp" 值，建议修改路径为 /Users/zentao （路径可自定义到任意真实存在路径下），如下图所示。
修改完成后，将此项的注释放开，即 删除 ";" 符号，执行如下命令，给予文件权限。
```
sudo mkdir /Users/zentao
sudo chmod -R 777 /Users/zentao
```
执行完如上操作后, 重启Apache服务, 点击页面刷新即可。
配置Mysql，此步骤前建议 检查Mysql 服务是否开启。

常见问题解决

1. 新建 /Users/zentao 目录，并授予777 权限。

sudo mkdir /Users/zentao
sudo chmod -R 777 /Users/zentao

2. 修改php.ini文件中，session.save_path值重新指向新建目录 /Users/zentao ，重启apache服务，刷新页面访问试下。
3. 如果修改后问题依旧，请删除 zentaopms/config/my.php文件后，刷新浏览器，重装禅道软件试下。