TYPO3 9.5站点迁移至staging.mywebsite.com配置修改咨询

已完成操作确认 #

你已经完成两个关键基础操作：

• 重命名网站根目录为staging.mywebsite.com
• 修改/etc/hosts添加新域名映射

接下来需要完成以下配置修改，确保TYPO3正常运行：

1. Web服务器配置（Apache/Nginx） #

• Apache：找到对应站点的配置文件（通常在/etc/apache2/sites-available/下，比如old.mywebsite.com.conf），修改以下内容：
  • 将ServerName和ServerAlias改为staging.mywebsite.com
  • 将DocumentRoot路径更新为/var/www/staging.mywebsite.com/public（TYPO3 9.5通常以public目录作为web根）
  • 可选但规范：将配置文件名改为staging.mywebsite.com.conf
  • 执行命令启用新配置并重启Apache：a2ensite staging.mywebsite.com.conf && systemctl restart apache2
• Nginx：找到对应站点配置文件（通常在/etc/nginx/sites-available/），修改：
  • server_name改为staging.mywebsite.com
  • root路径更新为/var/www/staging.mywebsite.com/public
  • 软链接到sites-enabled并重启Nginx：ln -s /etc/nginx/sites-available/staging.mywebsite.com.conf /etc/nginx/sites-enabled/ && systemctl restart nginx

2. TYPO3 系统配置文件 #

• 修改/var/www/staging.mywebsite.com/typo3conf/LocalConfiguration.php：
  • 找到HTTP数组下的host值，改为staging.mywebsite.com
  • 找到SYS数组下的trustedHostsPattern，更新为匹配新域名的正则，比如/^staging\.mywebsite\.com$/
• 检查AdditionalConfiguration.php，如果有硬编码的旧域名，一并修改

3. TYPO3 后台站点配置 #

登录TYPO3后台（通过新域名staging.mywebsite.com/typo3）：

• 进入站点管理，找到对应站点
• 修改站点的基础URL为https://staging.mywebsite.com/（根据实际使用的HTTP/HTTPS协议调整）
• 检查站点配置中的跳转规则、资源路径等字段，确保没有硬编码旧域名

4. 数据库中的旧域名替换 #

TYPO3数据库中可能存储了旧域名的链接或内容，需要批量替换（替换前请务必备份数据库）：
执行以下SQL命令：

UPDATE pages SET url = REPLACE(url, 'old.mywebsite.com', 'staging.mywebsite.com');
UPDATE tt_content SET bodytext = REPLACE(bodytext, 'old.mywebsite.com', 'staging.mywebsite.com');
UPDATE sys_file_reference SET link = REPLACE(link, 'old.mywebsite.com', 'staging.mywebsite.com');

注：如果使用了扩展（比如新闻、跳转管理），可能需要额外替换对应表中的旧域名，比如sys_redirect、tx_news_domain_model_news等。

5. 清除缓存 #

完成以上修改后，必须清除TYPO3缓存：

• 后台顶部点击清除缓存按钮，选择“全部清除”
• 或者删除缓存目录文件：rm -rf /var/www/staging.mywebsite.com/var/cache/*

关于你找到的StackOverflow文章 #

那篇文章适配TYPO3 10+版本，部分配置逻辑和9.5存在差异（比如站点管理的细节），上面的步骤更贴合你的9.5版本需求。

内容的提问来源于stack exchange，提问作者user3759978