17370845950

PHP rename() 不带日志功能，需手动用 file_put_contents() 追加记录；应使用绝对路径、确保权限、过滤敏感路径、包含时间/路径/结果/错误码；建议封装为 safe_rename_with_log() 函数并配合 logrotate 实现轮转。

PHP rename() 函数直接重命名文件，但不自动记录日志

PHP 本身没有内置的“带日志的重命名”函数，rename() 只负责移动/改名，成功或失败都静默。你要的日志能力必须自己补全——不是加个参数就能开，而是得在调用前后手动写入日志条目。

用 file_put_contents() 追加日志，注意权限和路径安全

最轻量的做法是每次 rename 前后，用 file_put_contents($log_file, $log_line, FILE_APPEND | LOCK_EX) 写入一行。关键点：

• $log_file 要用绝对路径（比如 /var/log/myapp/rename.log），避免相对路径导致写入失败
• 确保 Web 进程用户（如 www-data 或 nginx）对日志目录有写权限，否则日志会静默丢失
• 日志内容建议包含时间、原路径、目标路径、操作结果（成功/失败）、错误码（如果失败）
• 别把敏感路径（如用户上传的原始文件名）直接拼进日志，先做 basename() 过滤，防路径遍历或日志注入

if (rename($old_path, $new_path)) {
    $log = date('Y-m-d H:i:s') . " [OK] rename '{$old_path}' -> '{$new_path}'\n";
} else {
    $err = error_get_last()['message'] ?? 'unknown error';
    $log = date('Y-m-d H:i:s') . " [FAIL] rename '{$old_path}' -> '{$new_path}': {$err}\n";
}
file_put_contents('/var/log/myapp/rename.log', $log, FILE_APPEND | LOCK_EX);

封装成函数更可控，支持失败回滚和上下文标记

如果重命名逻辑分散在多处，建议抽成函数，比如 safe_rename_with_log()。它不只是记日志，还能帮你规避常见坑：

• 自动检查 $old_path 是否存在、$new_path 所在目录是否可写
• 失败时尝试恢复原名（前提是旧文件没被删或覆盖）
• 支持传入 $context 参数（如 'user_upload' 或 'batch_process_123'），让日志可分类检索
• 避免重复写日志：rename() 在同一文件系统内是原子操作，但跨分区会先 copy 再 unlink，此时若中断，可能留下残留，日志里要体现这种风险

日志轮转不能靠 PHP 自己做，得交由系统工具

PHP 不适合处理日志切割。不要在代码里判断文件大小然后重命名旧日志——并发请求下极易冲突。正确做法是：

• 让 PHP 日志文件保持单一、追加写入（如 rename.log）
• 用系统级工具管理轮转：Linux 下配 logrotate，指定 rotate 7、daily、compress 等规则
• logrotate 的 postrotate 可选发信号给 PHP-FPM（如果用了 reload 机制），但绝大多数场景下不需要——PHP 不缓存日志文件句柄，每次 file_put_contents() 都是重新打开

日志字段格式看似简单，但时间戳时区、路径编码（特别是中文文件名）、并发写入的原子性，这几个地方最容易出隐性问题。别等线上查不到某次重命名才回头补。