PHP本地环境不直接挂载共享目录，实际依赖操作系统或Docker等容器运行时；Docker通过-v参数映射宿主机路径，XAMPP/MAMP等靠修改DocumentRoot或符号链接，PHP内置服务器仅支持单根目录。
PHP本地环境本身不负责挂载共享目录，真正起作用的是底层操作系统（Windows/macOS/Linux）或容器运行时（如Docker）。所谓“PHP本地环境挂共享目录”，实际是指让PHP能访问到你指定的宿主机目录——这取决于你用的是哪种本地开发环境。
用Docker运行PHP时挂载宿主机目录
Docker是最常见也最可控的方式。关键在于 docker run 或 docker-compose.yml 中的 -v（或 volumes）参数，它把宿主机路径映射进容器内部，PHP脚本才能读写该路径。
- Windows/macOS用户：宿主机路径需是绝对路径，且对Docker Desktop可见（比如不能是
C:\Users\外的NTFS隐藏分区） - Linux用户：确保宿主机目录有足够权限，容器内PHP进程（常为
www-data或apache用户）能读写 - 路径末尾加冒号后跟容器内路径，例如
-v /path/on/host:/var/www/html，注意方向别反 - 如果PHP报错
failed to open stream: Permission denied，大概率是SELinux（CentOS/RHEL）或文件权限/用户UID不匹配导致
docker run -d \ -p 8080:80 \ -v $(pwd)/myapp:/var/www/html \ -v $(pwd)/logs:/var/log/apache2 \ --name php-apache \ php:apache
用XAMPP/MAMP/WAMP等集成包时“模拟挂载”
这类工具没有真正的挂载机制，只能通过配置Web服务器文档根目录（DocumentRoot）或使用符号链接（symlink）间接实现“共享”。本质是让Apache/Nginx把请求指向你想要的任意本地路径。
- Windows下用
mklink /D创建目录符号链接，比如把C:\projects\myapp链到C:\xampp\htdocs\myapp - macOS/Linux用
ln -s，但需确认Apache配置中启用了FollowSymLinks - 修改
httpd.conf或虚拟主机配置里的DocumentRoot和 - 重启Apache后，PHP脚本里用
__DIR__或$_SERVER['DOCUMENT_ROOT']可访问该路径，但注意PHP执行用户仍受限于Apache运行用户权限
用VS Code + PHP Server插件或PHP内置服务器时
PHP内置服务器（php -S）只接受一个路由脚本和一个文档根目录，不支持多路径挂载。所谓“共享”，只能靠启动时指定根目录为你的目标文件夹。
立即学习“PHP免费学习笔记（深入）”；
- 命令必须带
-t参数指定根目录，例如：php -S localhost:8000 -t /path/to/your/project - 无法像Web服务器那样配置多个别名路径；若需访问其他目录（如上传目录），得在路由脚本里手动
readfile()或include，不推荐用于生产逻辑 - VS Code的“PHP Server”插件默认以当前工作区为根目录，改根目录需右键项目文件夹 → “Open in PHP Server” 或修改插件设置中的
phpserver.documentRoot - 该方式完全绕过Apache/Nginx，无.htaccess、无模块扩展，仅适合快速预览
权限与路径陷阱最容易被忽略
无论哪种方式，“挂载成功”不等于“PHP能读写”。很多问题卡在权限和路径解析上：
- PHP脚本里用
realpath('..')或dirname(__FILE__)获取路径时，返回的是容器内或Web服务器视角的路径，不是宿主机原始路径 - Docker中PHP进程UID（如
82对应www-data）和宿主机文件UID不一致，导致写入失败；可加--user $(id -u):$(id -g)启动容器 - Windows下用Docker Desktop时，共享驱动器需在Docker Desktop设置中手动勾选（Settings → Resources → File Sharing）
- macOS上VirtualBox旧版Vagrant共享目录默认用
vboxsf文件系统，不支持flock()，可能影响PHP Session或日志锁
