本文介绍如何使用 Python 递归遍历指定目录及其所有子目录，安全、高效地批量替换所有 .php 文件中的特定字符串（如数据库名），并提供完整可运行代码与关键注意事项。
本文介绍如何使用 python 递归遍历指定目录及其所有子目录，安全、高效地批量替换所有 `.php` 文件中的特定字符串（如数据库名），并提供完整可运行代码与关键注意事项。
在 Web 项目迁移（例如更换数据库名称）过程中，常需批量更新大量 PHP 源码中硬编码的数据库标识符。Python 的 os.walk() 是处理此类递归文件操作的理想工具，但初学者易忽略路径拼接问题——os.walk() 返回的 filename 仅为文件名，不包含所在目录路径，直接用其打开文件会导致 FileNotFoundError。
正确做法是将 root（当前遍历的绝对路径）与 filename 通过 os.path.join() 安全拼接，构造完整文件路径。以下是经过生产环境验证的完整解决方案：
import os
import re
# ⚙️ 配置项（请按需修改）
directory = r'C:/Users/me/Desktop/wsphp' # 根目录路径（Windows 下建议使用原始字符串）
old_text = r'OLD DATABASE NAME' # 要被替换的原文（支持正则表达式）
new_text = r'NEW DATABASE NAME' # 替换后的内容
# ? 递归遍历 + 批量替换
for root, dirs, files in os.walk(directory):
for filename in files:
if filename.lower().endswith('.php'): # 不区分大小写匹配 .php/.PHP
file_path = os.path.join(root, filename) # ✅ 关键：拼接完整路径
try:
# ? 读取文件（推荐使用 with 语句确保自动关闭）
with open(file_path, 'r', encoding='utf-8') as f:
content = f.read()
# ✏️ 执行替换（re.sub 支持正则，若只需字面替换可用 str.replace）
new_content = re.sub(old_text, new_text, content)
# ? 写回文件（仅当内容实际变化时才写入，避免触发时间戳更新）
if new_content != content:
with open(file_path, 'w', encoding='utf-8') as f:
f.write(new_content)
print(f"✓ 已更新: {file_path}")
else:
print(f"→ 无变更: {file_path}")
except UnicodeDecodeError:
print(f"⚠ 编码错误（跳过）: {file_path} — 尝试指定 encoding='latin-1' 或其他编码")
except PermissionError:
print(f"❌ 权限不足（跳过）: {file_path}")
except Exception as e:
print(f"❌ 处理失败: {file_path} — {e}")✅ 关键优化说明：
免费红色响应式多语言企业通用模板1.0.0
下载
该模板源码有公司简介、公司新闻、产品展示、客户案例、留言等企业官网常用页面功能。模板是响应式模板，支持多语言，完善的标签调用修改起来很方便。功能特点：1. 使用的框架采用HkCms开源内容管理系统v2.2.3版本、免费可以商用。2. 所需环境Apache/Nginx，PHP7.2 及以上 + MySQL 5.6 及以上。3. 安装教程： (1) 站点运行路径填写到public目录下。 (2) 浏览
- 使用 with open() 确保文件句柄自动释放，避免资源泄漏；
- 添加 encoding='utf-8' 显式指定编码，防止中文或特殊字符乱码；
- 通过 filename.lower().endswith('.php') 兼容大小写变体（如 .PHP）；
- 仅当内容实际变更时才写入文件，减少不必要的磁盘 I/O 和时间戳扰动；
- 全面异常捕获：覆盖编码错误、权限拒绝等常见场景，并给出明确提示。
⚠️ 重要注意事项：
立即学习“PHP免费学习笔记（深入）”；
- 务必提前备份：运行前对整个目录执行完整备份（如压缩为 ZIP 或使用版本控制 git commit），避免误操作导致不可逆损坏；
- 正则转义谨慎：若 old_text 包含正则元字符（如 .、*、?），需用 re.escape(old_text) 转义，或改用 str.replace() 进行字面替换；
- 测试先行：先在小范围子目录（如新建测试文件夹）中验证脚本逻辑与替换效果；
- Windows 路径兼容性：示例中使用原始字符串 r'...' 避免反斜杠转义问题，Linux/macOS 用户可直接使用普通字符串。
该方案兼顾健壮性、可维护性与安全性，适用于中小型 PHP 项目数据库迁移、品牌重命名、API 地址更新等典型批量文本替换场景。
