PHP 8.2旧地址迁移需同步处理PHP层逻辑、Web服务器规则、数据库存储路径和框架运行环境四方面，否则易致404、跳转失效、参数丢失或白屏；核心是精准命中新地址并透传查询参数，保障访问与SEO权重不流失。
PHP 8.2 网站做旧地址迁移时，重定向不能只改代码或只配服务器——必须同步处理 PHP 层逻辑、Web 服务器规则、数据库存储路径和框架运行环境四方面，否则极易出现 404、跳转失效、参数丢失或白屏。核心是让所有旧 URL 请求精准命中对应新地址，且完整透传查询参数，保障用户访问和 SEO 权重不流失。
PHP 层：用集中映射表统一跳转（推荐中等规模）
适用于几十到几百条旧路径变更，比硬编码易维护，比数据库查表轻量：
- 新建 redirect-router.php，定义关联数组：
`$redirect_map = ["/old-contact.html" => "https://new.com/contact", "/blog/2023/post1" => "https://new.com/articles/first-post"];` - 用 $_SERVER['REQUEST_URI'] 获取完整请求路径（含参数），截取路径部分匹配数组键
- 匹配成功后，拼接原始查询字符串：
`$new_url = $redirect_map[$path] . (!empty($_SERVER['QUERY_STRING']) ? '?' . $_SERVER['QUERY_STRING'] : '');` - 发送标准 301 头：
`http_response_code(301); header("Location: $new_url"); exit;` - 在 Nginx 或 Apache 中配置 fallback，把未命中静态资源的请求统一交给该脚本处理
Nginx 配置：用 return 301 批量跳转（高效可靠）
适合整站换域名、HTTPS 强制升级或目录级迁移，性能优于 rewrite：
- 域名更换（old.com → new.com）：
`return 301 https://new.com$request_uri;` —— $request_uri 自动保留路径+参数 - 强制 HTTPS：
`return 301 https://$host$request_uri;`（注意不用 $scheme，避免 http 回环） - 目录结构调整（如 /product/123 → /item/123）：
`location ^~ /product/ { rewrite ^/product/(\d+)(?:/.*)?$ /item/$1 permanent; }` - 多旧域名合并跳转：server_name 后空格列出 all-old.com old.net www.all-old.com，共用一条 return
- 配置后务必执行 nginx -t && nginx -s reload，并清浏览器缓存测试
数据库与配置文件中的旧地址替换
WordPress、Laravel、ThinkPHP 等系统常在数据库或配置里存绝对 URL，仅改跳转规则不够：
立即学习“PHP免费学习笔记（深入）”；
- 检查数据库表（如 WordPress 的 wp_options 表）：
`UPDATE wp_options SET option_value = REPLACE(option_value, 'http://old.com', 'https://new.com') WHERE option_name IN ('home','siteurl');` - 搜索项目内所有 config.php、.env、settings.php 文件，替换 $base_url、APP_URL、SITE_URL 等变量值
- 特别注意 Laravel 的 APP_URL 和前端资源路径（如 mix manifest），避免 CSS/JS 404
- 若使用宝塔面板，确认 .env 文件权限为 644，且未被意外上传覆盖
PHP 8.2 特别注意事项
版本升级本身会引发隐性跳转失败，需重点核对：
- PHP 8.2 已移除 mysql_connect() 等函数，若旧重定向逻辑依赖它（如动态查库跳转），必须改用 PDO 或 mysqli
- 确认已启用 fileinfo 扩展——部分路由类库（如某些 CMS 插件）依赖它解析请求头
- 检查 php.ini 中 output_buffering 是否开启，避免 header() 前意外输出导致“headers already sent”错误
- 禁用函数列表里不要删掉 parse_url、http_response_code 等跳转关键函数
- OPcache 开启状态下，修改 redirect-router.php 后需重启 PHP 进程或清除 OPcache 缓存
