php 한글 메뉴얼 도움말 검색 사이트 Renames a file or directory [function.rename]

bool rename ( string $oldname , string $newname [, resource $context ] )

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

oldname: Note:
The old name. The wrapper used in oldname must match the wrapper used in newname.
newname: The new name.
context: Note: Context 지원은 PHP 5.0.0에서 추가되었습니다. contexts에 관한 자세한 설명은 Streams을 참고하십시오.

성공 시 TRUE를, 실패 시 FALSE를 반환합니다.

버전	설명
5.3.1	rename() can now rename files across drives in Windows.
5.0.0	rename() can now also be used with some URL wrappers. Refer to Supported Protocols and Wrappers for a listing of which wrappers support rename().
4.3.3	rename() may now be able to rename files across partitions on nix based systems, provided the appropriate permissions are held. Warnings may be generated if the destination filesystem doesn't permit chown()* or chmod() system calls to be made on files — for example, if the destination filesystem is a FAT filesystem.

Example #1 Example with rename()


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>