Leantime是一款面向非传统项目管理人群的开源项目管理系统，界面设计友好，内置任务看板、路线图、时间追踪、目标管理等功能，特别适合小团队跑敏捷流程。很多朋友想在本地先用起来试试效果，这时候用phpEnv搭建环境会比手工安装Apache、PHP、MySQL省事得多。下面就把phpEnv部署Leantime的完整过程详细拆解一遍，包括环境准备、站点创建、数据库配置和安装向导的走完流程。
一、安装前的环境要求检查
Leantime对PHP版本有一定要求，官方推荐PHP 8.1及以上版本，低版本的PHP 7.x会导致安装过程中直接报错。打开phpEnv主界面，在PHP版本管理里切换到8.1或8.2，phpEnv支持多版本共存，切换后记得在对应站点上重新指定PHP版本。
除了版本，还需要确认几个扩展已经开启。Leantime依赖的扩展主要有pdo_mysql、mbstring、gd、curl、xml、zip、bcmath等。在phpEnv的PHP管理面板中点击扩展管理，勾选上述扩展后保存。如果不确定缺哪个，可以新建一个info.php文件写入<?php phpinfo();放到站点目录，浏览器访问查看。
数据库方面使用phpEnv自带的MySQL即可，Leantime需要MySQL 5.7以上或者MariaDB 10.3以上，phpEnv默认携带的版本都能满足。安装前建议先启动Apache（或Nginx）和MySQL服务，在phpEnv首页确认所有服务都显示绿色运行状态。
二、下载Leantime并创建站点
先去Leantime官方发布页下载最新的发行包，一般是一个zip压缩文件。下载完成后解压，把里面的文件放到phpEnv的站点目录中。假设站点目录是D:\phpEnv\www\leantime，就把解压出来的所有文件复制到这个目录下，注意要让index.php位于站点根目录，而不是套了一层子文件夹。
接着在phpEnv中创建新站点：点击网站管理，新建站点，域名可以填leantime.test之类的本地域名，phpEnv会自动写入hosts，根目录指向刚才的leantime文件夹，PHP版本选择8.1以上。创建完成后，打开MySQL管理界面新建一个数据库，比如命名为leantime，字符集选择utf8mb4，同时记下数据库用户名和密码，后面配置要用。
这里有个容易忽略的细节：Leantime的部分目录需要写入权限，例如userfiles目录和.env配置文件。在Windows下一般不存在权限问题，但如果你的站点目录放在受保护路径或者用了特殊的安全软件，安装向导可能会提示目录不可写，手动给目录加上写入权限即可。
三、配置文件与安装向导
Leantime使用环境文件来管理配置。找到项目根目录下的.env.sample文件，复制一份并重命名为.env，然后用编辑器打开，重点修改以下几项数据库连接信息：
DB_HOST=127.0.0.1 DB_USER=root DB_PASSWORD=你的数据库密码 DB_NAME=leantime APP_URL=http://leantime.test
其中APP_URL要和你站点填写的域名保持一致，协议头写http还是https要对应，否则登录后可能出现跳转异常。DB_HOST建议写127.0.0.1而不是localhost，可以避免某些环境下MySQL套接字连接失败的问题。
保存配置后在浏览器访问站点域名，会自动进入安装向导。向导第一步会检测环境，检查PHP版本和扩展是否齐全，全部通过才能继续。接着填写管理员账号信息，包括邮箱和密码，这个账号就是安装完成后的超级管理员。点击安装后系统会自动建表和初始化数据，整个过程一般在一分钟内完成，看到成功提示就意味着部署结束，可以直接登录后台开始创建第一个项目了。
四、常见问题与调优建议
第一个常见问题是安装向导打开就是500错误，多半是PHP版本过低或者扩展缺失。回到phpEnv检查站点绑定的PHP版本，并确认gd、zip这类容易被忽略的扩展已经打开，改完记得重启Apache服务。
第二个问题是登录后页面样式错乱或资源加载失败。这通常是因为APP_URL配置和实际访问地址不一致，比如配置写的是http但开启了强制https，或者域名带了端口却没写在配置里。保持两边一致就能解决。如果使用了Nginx，还需要给站点加上伪静态规则，把请求转发到入口文件：
location / {
try_files $uri $uri/ /index.php?$query_string;
}
最后说说使用建议。Leantime自带的任务看板和目标管理已经能满足日常团队协作，如果后续要给团队正式使用，建议定期用phpEnv的MySQL备份功能对数据库做备份，同时把.env文件妥善保管，因为它包含了数据库凭据等敏感信息。测试满意后，也可以把整套站点迁移到云服务器，迁移时把站点目录和数据库一起搬过去，修改.env中的连接信息即可，操作逻辑和本地部署完全一致。