Mac安装本地禅道步骤及所遇问题

由于禅道集成安装包没有支持Mac，故Mac需通过源码安装。

禅道运行环境部署

Apache、PHP、MySQL

注：本机装的php7.3.3,数据库8.0.16

Apache

Mac系统自带Apache，在终端中输入以下命令即可启动

sudo apachectl start

在浏览器中输入下面网址查看是否启动成功

http://localhost 或 http://127.0.0.1

如果成功，页面会显示It works!

Apache其他相关命令如下：

sudo apachectl -v //查看Apache服务版本 sudo apachectl stop //关闭Apache服务 sudo apachectl restart //重启Apache服务

Apache服务默认安装路径在/private/etc/apache2,属于系统私有目录,我们不可直接在Finder中找到该路径 打开Apache安装路径方法： 1:在Finder -> 前往 -> 前往文件夹中输入/etc即可进入etc文件夹 2:在终端输入open /etc回车即可

PHP

mac系统启动PHP,在Apache服务中配置即可 1.找到/private/etc/apache2目录，打开httpd.conf文件 2.搜索#LoadModule php，找到LoadModule php7_module libexec/apache2/libphp7.so这一行，将前方的#删除 (如果因为权限问题不能修改的话，把它拖到桌面修改，再把桌面的拖到里面去替换原来的就可以) 3.重启Apache服务即可（sudo apachectl restart）

后面发现Mac自带的php版本较低。由于新装的mysql8.0.16，默认使用了新的密码验证插件：caching_sha2_password，而之前的PHP版本中所带的mysqlnd无法支持这种验证，故需要升级php.（php升级方法不在列举） 本机装的php7.3.3

mysql

注意：安装到最后一步会弹出一个框，上面有用户和密码，保存下来，否则后面会进不去数据库 浏览器打开http://dev.mysql.com/downloads/mysql/，下载图中第一个文件，安装即可。 数据库相关命令：

mysql --version //版本信息 exit //退出 sudo /usr/local/mysql/support-files/mysql.server start //启动MySQL服务 sudo /usr/local/mysql/support-files/mysql.server stop //停止MySQL服务

禅道下载及安装

打开禅道官网https://www.zentao.net，选择开源版下载。将其解压缩，得到zentaopms目录。拷贝到webserver/Documents目录下，如下图所示。 打开http://localhost/zentaopms/www/index.php，开始安装即可。

安装过程中易出问题

Session存储目录不存在或者不可读写。 注： 这里经常会出现的问题是Session存储目录不存在或者不可读写。 解决方式： 打开zentaopms\www目录中install.php (1 hit) Line 14: session_start();之前加入“session_save_path(dirname(dirname(FILE)).’/tmp/’); ”(不含最外侧的引号)数据库连接失败 解决方法 使用PHP连接MySQL 8的时候，可能会发生如标题所示的错误： SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client 发生这种错误，是由于MySQL 8默认使用了新的密码验证插件：caching_sha2_password，而之前的PHP版本中所带的mysqlnd无法支持这种验证。解决这个问题，有两种办法。 解决方法： 升级PHP支持MySQL 8的新验证插件。生成配置文件时，127.0.0.1可能失败，可尝试localhost