本文介绍如何使用 Python 递归遍历指定目录及其所有子目录，安全、准确地批量替换所有 .php 文件中特定字符串（如数据库名），并解决路径拼接错误、文件编码异常等常见问题。
本文介绍如何使用 python 递归遍历指定目录及其所有子目录，安全、准确地批量替换所有 `.php` 文件中特定字符串（如数据库名），并解决路径拼接错误、文件编码异常等常见问题。
在 Web 项目迁移（例如更换数据库名称）过程中，常需批量更新大量 PHP 源码中的硬编码字符串。手动修改不仅低效，还极易遗漏或出错。Python 提供了简洁可靠的自动化方案——结合 os.walk() 遍历目录结构，并通过 os.path.join() 构建完整文件路径，确保正确读写每个 .php 文件。
以下是一个健壮、可直接运行的示例脚本：
import os
import re
# ⚙️ 配置参数（按需修改）
directory = r'C:/Users/me/Desktop/wsphp' # 根目录路径（建议使用原始字符串 r'' 避免转义问题）
old_text = r'OLD DATABASE NAME' # 待替换的原始文本（正则模式，若无需正则可改用 str.replace）
new_text = 'NEW DATABASE NAME' # 替换后的新文本
# ? 遍历目录及所有子目录
for root, dirs, files in os.walk(directory):
for filename in files:
if filename.lower().endswith('.php'): # 不区分大小写匹配 .php/.PHP
filepath = os.path.join(root, filename) # ✅ 关键：拼接完整路径
try:
# ? 安全读取（显式指定 UTF-8 编码，避免中文乱码）
with open(filepath, 'r', encoding='utf-8') as f:
content = f.read()
# ✏️ 执行替换（使用 re.sub 支持正则；如仅字面替换，可用 content.replace(old_text, new_text)）
new_content = re.sub(old_text, new_text, content)
# ? 写回文件（仅当内容实际变化时才写入，避免无谓修改时间戳）
if new_content != content:
with open(filepath, 'w', encoding='utf-8') as f:
f.write(new_content)
print(f"✅ 已更新: {filepath}")
else:
print(f"ℹ️ 未变更: {filepath}")
except UnicodeDecodeError:
print(f"⚠️ 编码错误（非UTF-8）: {filepath} — 建议手动检查或添加 'latin-1' 等备用编码")
except PermissionError:
print(f"❌ 权限不足，跳过: {filepath}")
except Exception as e:
print(f"❌ 处理失败 {filepath}: {e}")关键要点说明：
- 路径拼接必须使用 os.path.join(root, filename)：os.walk() 中的 filename 仅为文件名，root 是当前子目录的绝对路径，二者拼接才是完整可访问路径；
- 始终使用 with open(...) 上下文管理器：确保文件自动关闭，避免资源泄漏；
- 显式指定 encoding='utf-8'：PHP 文件常含中文或特殊符号，忽略编码易导致 UnicodeDecodeError；
- 增加异常处理与日志反馈：区分编码错误、权限问题、其他异常，提升脚本鲁棒性；
- 写入前比对内容：仅当替换生效时才写入文件，避免触发不必要的文件系统变更（如 Git 脏状态）；
- .lower().endswith('.php')：兼容 .PHP、.Php 等大小写变体。
✅ 最佳实践建议：
立即学习“PHP免费学习笔记（深入）”；
- 务必先备份整个目录（如压缩为 wsphp_backup.zip），再运行脚本；
- 对于正则表达式中的特殊字符（如 .、*、$），需对 old_text 进行 re.escape() 转义（例：re.escape('my.db.name')）；
- 若需更复杂的逻辑（如仅替换某行内、或排除注释块），可结合 tokenize 模块或专用 PHP 解析器（如 phply），但本场景纯文本替换已足够高效可靠。
该方案兼顾准确性、安全性与可维护性，是 PHP 项目批量重构中值得复用的基础工具范式。
