php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Doc Bug #73997 rename() won't overwrite existing directory
Submitted: 2017-01-25 16:55 UTC Modified: 2017-04-05 19:02 UTC
From: tim dot aagaard at gmail dot com Assigned: peehaa (profile)
Status: Closed Package: Filesystem function related
PHP Version: Irrelevant OS: NA
Private report: No CVE-ID: None
View Developer Edit
 [2017-01-25 16:55 UTC] tim dot aagaard at gmail dot com 
Description:
------------
"rename — Renames a file or directory"

"Attempts to rename oldname to newname, moving it between directories if necessary. If newname exists, it will be overwritten."

Rename will not overwrite a directory that already exists.

Test script:
---------------
mkdir('a/', 0777);
mkdir('b/', 0777);
rename('a/', 'b/');

Actual result:
--------------
Warning: rename(a/,b/): File exists

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2017-01-25 16:57 UTC] tim dot aagaard at gmail dot com 
This behavior should be noted somewhere in the documentation
 [2017-01-25 22:41 UTC] cmb@php.net
-Summary: Incorrect documentation +Summary: rename() won't overwrite existing directory -Package: Documentation problem +Package: Filesystem function related
 [2017-04-05 19:02 UTC] peehaa@php.net
-Status: Open +Status: Closed -Assigned To: +Assigned To: peehaa
 [2017-04-05 19:02 UTC] peehaa@php.net 
This bug has been fixed in the documentation's XML sources. Since the
online and downloadable versions of the documentation need some time
to get updated, we would like to ask you to be a bit patient.

Thank you for the report, and for helping us make our documentation better.
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Fri Oct 24 22:00:02 2025 UTC