PHP模板占位符替换后如何移除空白行

在PHP模板开发场景中，我们通常会先定义包含占位符的模板字符串，再通过替换逻辑将占位符替换为实际内容，这个过程中很容易产生多余的空白行，需要针对性进行处理。

空白行产生的常见原因

模板中原本的占位符可能单独占据一行，替换后占位符消失，原本的行就会变成空白行。比如下面的模板示例，占位符{user_name}在单独一行，替换后就会出现空白行：

<?php
$template = <<<TPL
用户信息：
{user_name}
年龄：{user_age}
TPL;
$data = [
    'user_name' => '张三',
    'user_age' => 25
];
// 简单替换占位符
foreach ($data as $key => $value) {
    $template = str_replace('{' . $key . '}', $value, $template);
}
echo $template;
?>

上述代码执行后，输出结果中用户信息：和年龄：25之间会出现一个空白行，这是因为{user_name}原本所在的行在替换后没有内容，只剩换行符。

方法一：使用str_replace处理连续换行

最直接的方式是替换模板中连续的两个换行符为一个换行符，不过这种方式只能处理连续的空白行，无法处理单个的空白行，适合简单场景：

<?php
$template = <<<TPL
用户信息：
{user_name}
年龄：{user_age}
TPL;
$data = [
    'user_name' => '张三',
    'user_age' => 25
];
foreach ($data as $key => $value) {
    $template = str_replace('{' . $key . '}', $value, $template);
}
// 替换连续两个换行为一个换行
$template = str_replace("nn", "n", $template);
echo $template;
?>

方法二：使用正则表达式移除空白行

如果需要更精准地移除所有只包含空白字符的行，可以使用preg_replace函数配合正则表达式，这种方式可以处理各种空白行场景：

<?php
$template = <<<TPL
用户信息：
{user_name}
年龄：{user_age}
TPL;
$data = [
    'user_name' => '张三',
    'user_age' => 25
];
foreach ($data as $key => $value) {
    $template = str_replace('{' . $key . '}', $value, $template);
}
// 正则匹配只包含空白字符的行，替换为空
$template = preg_replace('/^s*[rn]+/m', '', $template);
echo $template;
?>

这里的正则表达式/^s*[rn]+/m含义是：匹配行首任意空白字符，后面跟着一个或多个换行符，m修饰符表示按行匹配，这样就可以精准移除所有空白行。

方法三：替换占位符时直接处理换行

我们还可以在替换占位符的阶段就判断占位符是否单独成行，如果是则连同行尾的换行符一起替换，从源头避免空白行产生：

<?php
$template = <<<TPL
用户信息：
{user_name}
年龄：{user_age}
TPL;
$data = [
    'user_name' => '张三',
    'user_age' => 25
];
foreach ($data as $key => $value) {
    // 匹配单独成行的占位符，包含前后的换行符
    $pattern = '/n{' . $key . '}n/';
    $template = preg_replace($pattern, "n" . $value . "n", $template);
    // 处理占位符在开头的情况
    $pattern = '/^{' . $key . '}n/';
    $template = preg_replace($pattern, $value . "n", $template);
    // 处理占位符在结尾的情况
    $pattern = '/n{' . $key . '}$/';
    $template = preg_replace($pattern, "n" . $value, $template);
}
echo $template;
?>

不同方法对比

以下是三种方法的适用场景对比：

注意事项

• 处理换行符时要注意系统差异，Windows系统的换行符是rn，Linux和macOS是n，正则表达式中用[rn]可以兼容所有系统。
• 如果模板中需要保留合法的空白行，不要使用正则匹配所有空白行的方式，避免误删需要的换行。
• 替换完成后建议输出前做一次trim操作，移除字符串首尾的多余空白字符，让输出更整洁。

PHP模板占位符替换空白行移除preg_replace修改时间：2026-07-01 02:39:34