如何用PHP替换Markdown文件内容-php教程-PHP中文网

用file_get_contents读取markdown文件后，应通过正则精准替换（如preg_replace锚定链接语法）并用临时文件+rename原子写入，避免破坏格式或丢失原文件。

如何用php替换markdown文件内容

用 `file_get_contents` 读取 Markdown 文件再写回

PHP 没有原生 Markdown 解析器，所以“替换内容”本质是文本替换——先读文件、改字符串、再写回去。最直接的方式就是 file_get_contents + str_replace（或正则）+ file_put_contents。

注意：Markdown 是纯文本，但结构敏感（比如标题缩进、列表符号、代码块），盲目全局替换容易破坏格式。别用 str_replace 直接换 "# " 这类片段，除非你确认它只出现在标题行开头。

读取时加 FILE_IGNORE_NEW_LINES | FILE_SKIP_EMPTY_LINES 可减少干扰，但不解决逻辑问题
写入前务必检查 file_put_contents 返回值是否为 false，否则静默失败
如果文件路径含中文或特殊字符，确保 PHP 脚本编码与文件一致（推荐 UTF-8 without BOM）

用正则精准替换特定 Markdown 元素（如链接、图片）

想只改 ![alt](url) 中的 url，或把所有 [text](old.com) 换成新域名？得用 preg_replace，且必须锚定边界。

常见错误是写 preg_replace('/old\.com/', 'new.com', $content)——这会把代码块里的 old.com 也替掉。正确做法是匹配完整链接语法：

$pattern = '/\!\[([^\]]*)\]\(([^)]+)\)/';
$replacement = '![$1](https://new.example.com/$2)';
$content = preg_replace($pattern, $replacement, $content);

图片和链接的括号可能嵌套（如 ![img](path/to/img.png?x=1&y=2)），[^)]+ 比 .*? 更安全
替换前用 mb_ereg_replace 或 preg_replace 的 u 修饰符处理中文 alt 文本
测试正则时，先用 var_dump(preg_match_all($pattern, $content, $matches)) 确认捕获组是否符合预期

避免覆盖原始文件：用临时文件 + `rename` 原子操作

直接 file_put_contents($path, $new_content) 风险高——写到一半磁盘满、权限错、编码崩，原文件就丢了。

Markdown to PDF (Styled)

使用pandoc和wkhtmltopdf将Markdown文件转换为带样式的PDF，支持内置或自定义CSS样式。

下载

更稳妥的做法是写入临时文件，验证无误后再替换：

$tempFile = tempnam(sys_get_temp_dir(), 'md_');
if (file_put_contents($tempFile, $content) === false) {
    unlink($tempFile);
    throw new RuntimeException('Failed to write temp file');
}
if (rename($tempFile, $originalPath) === false) {
    unlink($tempFile);
    throw new RuntimeException('Failed to replace original file');
}

tempnam() 生成的路径自带唯一性，但需手动 unlink() 失败时的残留
rename() 在同一文件系统下是原子操作，不会出现“半新半旧”状态
跨分区 rename 会失败，此时要 fallback 到 copy() + unlink()，并加锁防止并发写

处理 Front Matter（YAML 头部）时不能简单全文替换

很多静态博客的 Markdown 文件开头有 --- 包裹的 YAML 头部，比如：

---
title: "Old Title"
date: 2023-01-01
tags: [php, markdown]
---
正文内容...

如果只想更新 date 字段，硬用 str_replace 会污染正文里出现的 date:（比如代码块中）。必须先分离头部。

用 preg_split('/^---$/m', $content, 2) 提取头部（注意 m 修饰符让 ^/$ 匹配每行）
用 yaml_parse()（需安装 symfony/yaml 或 php-yaml 扩展）解析头部，改完再 yaml_emit()
若不用扩展，至少用 preg_replace('/^date:\s*.+$/m', 'date: ' . date('Y-m-d'), $frontMatter)，并确保只作用于头部段落