PHP批量替换HTML链接异常：测试显示替换成功但保存后未生效

问题背景 #

我编写了一段PHP代码，用于批量更新数千个HTML页面中的链接——将原文件名含%20的链接替换为含短横线的形式（示例：$origlink_url = "fred%20flinstone.html"，$newlink_url = "fred-flinstone.html"）。代码如下：

<?php

// preceeding code removed
 
//load file that contains link to auto edit it before resaving
$file = file_get_contents('https://www.example.com/active/'.$link_array[$z][1][1]); 
//update via 'find & replace'   
$file2 = str_replace($origlink_url, $newlink_url, $file); 
//test to visually affirm file is modified (3 code lines below)
$w=strpos($file2, $newlink_url); 
$v=strlen($newlink_url); 
echo nl2br(" strpos of link: ".$w." link strlen is: ".$v." File substring: ".substr($file2,$w,$v)."  ");
//end of test code
$fh = fopen($_SERVER['DOCUMENT_ROOT']."/modified-files/".$link_array[$z][1][1], "w"); 
fwrite($fh, $file2);
fclose($fh);
echo nl2br("Page updated: ".$link_array[$z][1][1]. " \n"); 

?>

目前代码能成功加载HTML文件，测试代码显示替换已生效（可定位到新链接并输出正确内容），文件保存时能正常创建或覆盖文件、更新时间戳，但最终保存的文件中链接仍为含%20的原形式。

排查与解决步骤 #

1. 检查原始内容的编码状态 #

通过HTTPS URL获取文件时，服务器返回的内容中%20可能已被自动解码为空格，但你的$origlink_url存储的是编码后的%20，导致str_replace无法匹配。

• 验证：在file_get_contents后添加echo htmlspecialchars($file);，查看原始内容里的链接是%20还是空格。
• 修复：将匹配串解码后再替换：

$origlink_decoded = urldecode($origlink_url);
$file2 = str_replace($origlink_decoded, $newlink_url, $file);

2. 确认文件写入路径是否正确 #

你使用$_SERVER['DOCUMENT_ROOT']."/modified-files/".$link_array[$z][1][1]作为写入路径，可能存在查看文件路径错误的情况。

• 验证：在代码中添加echo $_SERVER['DOCUMENT_ROOT']."/modified-files/".$link_array[$z][1][1];，确认实际写入的文件位置，前往对应目录查看结果。

3. 改用正则表达式增强匹配灵活性 #

如果链接前后存在空白字符、编码差异，str_replace的精确匹配会失效，正则表达式能覆盖更多场景：

• 针对单个链接的替换：

// \s匹配任意空白字符（含解码后的空格）
$pattern = '/fred\sflinstone\.html/i';
$file2 = preg_replace($pattern, $newlink_url, $file);

• 批量替换所有含空格的文件名：

// 匹配文件名中的空格，替换为短横线
$file2 = preg_replace('/(\w+)\s(\w+\.html)/i', '$1-$2', $file);

4. 检查写入完整性 #

fwrite返回实际写入的字节数，可验证是否与内容长度一致：

$bytes_written = fwrite($fh, $file2);
if ($bytes_written !== strlen($file2)) {
    echo nl2br("写入异常：仅写入{$bytes_written}字节，内容总长度为".strlen($file2)."字节\n");
}

若写入不完整，需排查磁盘空间、文件权限或文件锁定问题。

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