PHP str_replace配合file_put_contents写入返回零值问题咨询

问题核心诱因 #

• 精确字符串匹配失效：你硬编码的$from是完全固定格式的@media (max-width: 767px) {，但实际CSS文件里的对应片段大概率存在格式差异：比如冒号后多空格、括号前后有多余空白、大括号单独换行、存在不可见特殊字符（比如零宽空格、全角空格），导致str_replace找不到匹配目标，替换完全没执行。
• 编码不一致：如果CSS文件不是UTF-8无BOM编码（比如是GBK、带BOM的UTF-8），读取到的内容字节序列和你硬编码的$from不匹配，也会导致匹配失败。
• 返回值认知偏差：str_replace本身不会返回整数0，它的返回值是替换后的字符串，你观测到的零值实际是file_put_contents返回的写入字节数为0——要么是替换没生效写入了和原文件完全一致的内容，要么是读取文件失败拿到空内容，替换后还是空值，最终写入零字节。
• 变量异常：如果$folder变量为空、包含换行/截断类特殊字符，可能导致替换后的内容异常，甚至被截断为空。

可行解决思路 #

• 替换前先做匹配校验：执行替换前先用strpos($item_content, $from)判断匹配串是否存在，如果返回false，直接打印对应文件的实际内容片段，排查格式差异，不要盲目写入。
• 用正则替换替代固定字符串匹配，兼容格式差异，参考代码：

// 兼容任意空白字符、大小写差异，只替换第一个匹配项避免重复插入
$pattern = '/@media\s*\(\s*max-width\s*:\s*767px\s*\)\s*\{/i';
$insertContent = ".st{$folder} {}" . PHP_EOL . ".sb{$folder} {}" . PHP_EOL;
// $0 代表匹配到的原媒体查询开头，不需要重复写原字符串，避免写错
$item_content = preg_replace($pattern, $insertContent . '$0', $item_content, 1);

• 统一编码处理：读取文件后统一转成UTF-8无BOM格式再做替换，如果不确定源文件编码，可以用mb_detect_encoding做检测后再转码，避免编码不一致导致的匹配失败。
• 加替换成功校验再写入：对比替换前后的字符串长度，只有长度发生变化（说明确实插入了新内容）再执行写入操作，没匹配到的文件记录到日志单独排查，参考逻辑：

$beforeLength = strlen($item_content);
// 执行替换逻辑
$item_content = preg_replace($pattern, $insertContent . '$0', $item_content, 1);
// 长度没变化说明替换失败，跳过写入记日志
if (strlen($item_content) === $beforeLength) {
    file_put_contents('./replace_failed.log', $currentFilePath . PHP_EOL, FILE_APPEND);
    continue;
}
// 校验通过再写入
file_put_contents($currentFilePath, $item_content);

• 提前处理$folder变量：过滤掉$folder里的换行、花括号、注释符等特殊字符，避免插入的内容破坏CSS结构，甚至导致内容截断。

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