phpEnv是PHP版本管理工具，不提供install suitecrm命令；它仅通过.php-version文件切换PHP二进制路径，SuiteCRM需手动下载、配置数据库并运行浏览器安装向导。
phpenv 本身不安装 SuiteCRM，它只管理 PHP 版本；你要装 SuiteCRM，得先用 phpenv 切到兼容版本（如 phpenv local 8.1），再走标准部署流程。
为什么不能直接用 phpenv install suitecrm
phpenv 是个 PHP 版本切换工具，不是包管理器 —— 它没有 install suitecrm 这种命令，也不下载、解压或配置任何 PHP 应用。它的作用仅限于：在当前目录读取 .php-version，然后把 php 命令指向对应编译好的 PHP 二进制文件。
- 常见误解：看到 “phpenv + SuiteCRM” 就以为能一键部署，结果运行
phpenv install suitecrm报错command not found - 真实依赖链：SuiteCRM 要求 PHP ≥ 7.4（推荐 8.1/8.2），
phpenv只帮你满足这个前提，后续仍需手动拉代码、配数据库、跑安装向导 - 如果你跳过版本控制直接用系统默认 PHP（比如 Ubuntu 自带的 8.3），而 SuiteCRM 8.5.x 尚未完全适配，就可能在
composer install阶段报Root composer.json requires php ^7.4 || ^8.0冲突
用 phpenv 切换 PHP 版本后，SuiteCRM 安装关键动作
确认你已用 phpenv 装好并激活了兼容版本（例如 8.1）：
phpenv install 8.1.28<br>phpenv local 8.1.28<br>php -v # 应输出 8.1.x
接着才是 SuiteCRM 本身的部署动作：
立即学习“PHP免费学习笔记（深入）”；
- 下载源码：
wget https://github.com/salesagility/SuiteCRM/releases/download/v8.5.2/SuiteCRM-8.5.2.zip - 解压到 Web 目录：
unzip SuiteCRM-8.5.2.zip -d /var/www/html/suitecrm - 确保扩展已启用：
php -m | grep -E "zip|mbstring|pdo_mysql|xml|curl|json"，缺哪个就补哪个（Ubuntu 上是sudo apt install php8.1-zip php8.1-mbstring ...） - 设好权限：
chown -R www-data:www-data /var/www/html/suitecrm，否则安装向导卡在“检查写入权限” - 访问
http://your-ip/suitecrm，走浏览器安装流程 —— 此时后端用的就是phpenv指定的 8.1，不是系统默认 PHP
composer install 失败常见原因（和 phpenv 强相关）
即使 phpenv local 设对了，composer install 仍可能失败，因为 Composer 会读取系统级 PHP 配置，而非当前 shell 的 phpenv 环境：
- 现象：
Your lock file does not contain a compatible set of packages或提示缺ext-zip - 根因：Composer 启动时调用的是
/usr/bin/php（系统默认），不是~/.phpenv/versions/8.1.28/bin/php - 解决办法：显式指定 PHP 路径运行：
~/.phpenv/versions/8.1.28/bin/php composer.phar install - 或者重装 Composer 并绑定当前版本：
curl -sS https://getcomposer.org/installer | ~/.phpenv/versions/8.1.28/bin/php，生成的composer.phar就会固定用 8.1
真正容易被忽略的是：phpenv 切换只影响当前 shell 会话，Web 服务器（如 Apache 或 Nginx）跑 PHP 是独立进程，不受 phpenv 控制 —— 所以你必须单独配置 Web 服务器使用的 PHP-FPM 池，指向 phpenv 安装的 PHP 版本对应的 fpm.sock 或端口，否则浏览器里跑的还是系统默认 PHP。
