PHP无法跨平台创建软链接，symlink()仅限类Unix系统；Windows需用mklink命令配合exec()，或采用配置重写、路由接管等替代方案。
PHP里根本不能直接创建软链接
PHP本身没有内置函数能跨平台创建符号链接（symlink），symlink() 函数只在类Unix系统（Linux/macOS）上有效，Windows默认不支持——哪怕你用的是WSL或Git Bash，只要PHP进程跑在原生Windows下，symlink() 就会报错 Warning: symlink(): Operation not permitted。
常见错误现象：本地开发用Mac写好代码，部署到Windows服务器后整个目录结构失效，require 找不到路径，静态资源404。
-
symlink()在Windows上需要管理员权限 + 启用开发者模式 + 以管理员身份运行Web服务（如Apache），实际生产环境几乎不可行 - 即使成功创建，Windows资源管理器不显示为“快捷方式”，而是普通文件夹图标，容易误删
- PHP-FPM或Nginx配置若未开启
follow_symlinks on（Nginx）或EnableSendfile off（某些旧版Apache），静态文件仍会403/404
Windows下替代方案：用mklink命令 + exec()
真要在Windows服务器上模拟软链接效果，得绕过PHP，调用系统命令。前提是PHP配置允许执行外部程序（disable_functions 里没禁掉 exec、shell_exec）。
使用场景：部署时一次性建立公共资源链接，比如把 public/storage 指向 storage/app/public。
立即学习“PHP免费学习笔记（深入）”；
- 必须用绝对路径，相对路径在
exec()中行为不可靠 - 命令格式是
mklink /D "目标路径" "源路径"，注意顺序和引号，缺一不可 - 执行前检查目标路径是否已存在，否则命令失败且无提示；可用
is_link()或file_exists()预判 - PHP用户（如www-data或IIS_IUSRS）需对目标父目录有“创建符号链接”权限，Windows默认拒绝，得手动在组策略中启用
示例片段：
if (!is_link('public/storage')) {
$target = realpath('public/storage');
$source = realpath('storage/app/public');
exec("mklink /D \"{$target}\" \"{$source}\" 2>&1", $output, $return);
if ($return !== 0) {
error_log('mklink failed: ' . implode("\n", $output));
}
}
更稳妥的跨平台做法：用配置+路由重写代替硬链接
与其折腾系统级链接，不如让应用层接管路径映射。Laravel的 php artisan storage:link 实际也是调 symlink()，但它加了平台判断和fallback提示——你完全可以抄这个思路。
性能影响极小，兼容性拉满，连OpenBSD或Docker Alpine都能跑。
- 把“链接逻辑”移到Web服务器配置里：Nginx用
alias，Apache用Alias+Options FollowSymLinks - PHP内部用
realpath()+dirname(__DIR__)动态拼路径，避免硬编码../storage - 静态资源统一走一个PHP路由（如
/storage/*），用readfile()输出并设好header，彻底绕过文件系统限制 - 别信“Windows Subsystem for Linux能解决一切”，PHP进程若不在WSL里跑（比如用XAMPP），
symlink()依然无效
最容易被忽略的点：权限继承和SELinux
即使 symlink() 成功，链接目标目录的权限不继承给链接本身。Linux下如果源目录被SELinux标记为 httpd_sys_content_t，而链接路径是 default_t，Apache照样拒绝访问。
这时候 ls -Z 看上下文，用 chcon -R -t httpd_sys_content_t /path/to/target 修正，比反复改chmod管用得多。
还有个坑：某些云存储网关（如S3FS挂载点）不支持symlink，is_link() 返回false，但 file_exists() 又返回true，得用 lstat() 的 mode 字段位运算判断才准。
