phpenv 不支持共享文件夹配置，因其仅管理 PHP 版本切换，不涉及虚拟机挂载或文件系统操作；共享目录属虚拟机层（如 VMware/OrbStack），phpenv 属运行于其内的工具层，二者完全解耦。
phpenv 本身不支持、也不负责共享文件夹配置 —— 它只管 PHP 版本切换，挂载目录是虚拟机或宿主机的事。
为什么 phpenv 命令里找不到共享目录相关选项
phpenv 是纯 shell 层的版本管理器，它不启动虚拟机、不操作文件系统、不接触挂载点。你看到的 phpenv local 或 phpenv global 只是在改 ~/.phpenv/version 或项目级 .php-version 文件，然后通过 shims 动态代理 php 命令调用对应版本的二进制。它对 /mnt/hgfs、/vagrant 或 /var/www 里的文件一无所知。
所谓“phpenv 虚拟机开发环境设置共享文件夹”，实际是两件事叠加： - 你在 OrbStack / VMware / VirtualBox 里跑了一个 Linux 虚拟机； - 你在那台虚拟机里装了 phpenv 管理 PHP 版本。
共享文件夹属于第一层（虚拟机），phpenv 属于第二层（运行在虚拟机内的工具）。两者完全解耦。
OrbStack / VMware 中挂载宿主机目录的实操要点
以 OrbStack 的 Ubuntu 虚拟机为例（最常见场景）：
立即学习“PHP免费学习笔记（深入）”；
- OrbStack 默认已启用
~/Documents、~/Downloads等路径的自动挂载，映射到虚拟机的/mnt/orbstack/下，无需额外配置 - 若需挂载自定义路径（如
/Users/you/projects），需在 OrbStack GUI 的「Volumes」中手动添加，并确认勾选「Mount at startup」 - 挂载后检查是否生效：
ls -l /mnt/orbstack/；如果报No such file or directory，说明 OrbStack 服务未重启或路径权限受限 - VMware 用户注意：
vmware-hgfsclient输出的共享名必须带.host:/前缀，mount -t vmhgfs-fuse .host:/myshare /mnt/hgfs才能成功；CentOS/RHEL 还得先sudo yum install open-vm-tools - 挂载点目录（如
/mnt/hgfs）的属主和权限要匹配 PHP 进程用户（常为www-data或apache），否则fopen()会报Permission denied
PHP 脚本能读到共享目录的前提条件
即使目录已挂载，PHP 还可能因以下原因拒绝访问：
-
open_basedir限制：检查php -i | grep open_basedir，若非空且不含挂载路径，需在php.ini或 vhost 配置中显式追加，例如open_basedir = "/var/www/:/mnt/orbstack/" -
cgi.fix_pathinfo=0（默认值）会导致 Nginx + PHP-FPM 在访问挂载目录下的脚本时返回 404；改为1并 reload PHP-FPM - SELinux（仅 CentOS/RHEL）：执行
setsebool -P httpd_read_user_content 1允许 Apache 读取用户挂载目录 - PHP-FPM 的
user/group必须有挂载点目录的执行（x）权限，否则无法进入子目录；常用修复：sudo chmod o+x /mnt/orbstack（临时）或改用bind mount指定 UID/GID
项目内如何安全引用共享目录中的文件
不要硬编码 /mnt/orbstack/myproject 这类路径。更可靠的做法是：
- 在项目根目录放一个
.env文件，写入SHARED_ROOT=/mnt/orbstack，再用getenv('SHARED_ROOT')读取 - 用
realpath()校验路径有效性：if (!is_dir($path = realpath($_ENV['SHARED_ROOT'] . '/uploads'))) { die('Shared dir not mounted'); } - 避免在
include或require中直接拼接挂载路径，防止路径遍历；优先用 Composer autoload 或 PSR-4 映射 - 上传目录若放在共享路径下，务必在 PHP 中检查
$_FILES['file']['tmp_name']是否确实在upload_tmp_dir内，防止绕过
真正容易被忽略的是：挂载路径的用户 UID/GID 与 PHP 进程 UID/GID 不一致时，Linux 权限模型会静默拒绝访问 —— 此时 ls -l 看起来一切正常，但 fopen() 就是打不开，连错误日志都可能不输出，只能靠 strace -e trace=openat php test.php 抓系统调用确认。
