PHP本身不创建虚拟目录，真正起作用的是Web服务器（Apache/Nginx/IIS）对URL路径与物理路径的映射；所谓“旧站点平滑切换”，核心是保持原有访问路径（如/shop）不变，通过服务器配置将请求无缝路由至新物理目录，并确保PHP执行、路由解析和静态资源加载全部正常。
PHP 本身不参与虚拟目录的创建或迁移，真正起作用的是 Web 服务器（Apache/Nginx/IIS）对 URL 路径与物理路径的映射关系调整。所谓“旧站点平滑切换”，核心不是复制文件，而是让新目录在保持原有访问路径（如 /shop、/admin）的前提下，无缝接管请求，并确保 PHP 执行、路由解析、静态资源加载全部正常。
一、切换前必须验证的三项基础
迁移失败大多发生在切换瞬间，根源常是基础配置未就绪：
- 新目录下已有可运行的入口文件（如 index.php），且能独立输出 phpinfo() 或框架欢迎页
- Web 服务器已明确将目标 URL 路径（如 /shop）映射到新物理路径，而非沿用旧目录——不能只改文件，必须改配置
- PHP 运行环境一致：同一 PHP 版本、相同扩展（fileinfo、mbstring、curl）、相同的 cgi.fix_pathinfo 设置（Nginx 下通常需为 0，Apache/FastCGI 下建议为 1）
二、按服务器类型执行切换操作
配置变更后必须重启服务或重载，不能仅刷新页面。
-
Apache：修改 Alias 指令指向新路径，更新 RewriteBase（如原为
RewriteBase /shop/，新目录结构不变则保留；若入口位置变化，需同步调整），确认 .htaccess 在新目录中存在且规则有效 -
Nginx：修改 location 块中的 alias 或 root，特别注意 alias 后路径末尾必须带斜杠，且 try_files 规则中引用的入口文件路径（如
/shop/index.php）要与实际 URL 匹配 - IIS：右键原虚拟目录 → 「删除」；再右键网站 → 「添加虚拟目录」→ 填写相同别名（如 shop）但指向新物理路径；关键一步：进入该虚拟目录 → 「处理程序映射」→ 重新添加 FastCGI 映射（不能复用旧设置，路径和名称需唯一）
三、避免缓存与权限导致的“看似切换成功”假象
切换后访问仍显示旧内容，大概率是以下两类问题：
立即学习“PHP免费学习笔记（深入）”；
-
OPcache 或框架缓存未清：执行
php -r "opcache_reset();"；ThinkPHP/Laravel 需运行php think clear或php artisan config:clear -
权限未同步到位：新目录需被 Web 用户（如 www-data、IIS_IUSRS、nginx）拥有 读取+执行 权限；Linux 下常用
chown -R www-data:www-data /new/path+chmod -R 755 /new/path；Windows 下需手动赋予应用池用户对新路径的完整控制权
四、上线前最后两步验证
不要跳过手动检查：
- 直接访问新目录下的 info.php（内容为
<?php phpinfo(); ?>），确认 PHP 环境正常、路径显示为新目录 - 用 curl 模拟真实请求：
curl -I https://yoursite.com/shop/api/test，观察返回状态码（应为 200，非 404/500）、X-Powered-By 头是否出现、响应时间是否合理
