ฟังก์ชัน rename

ฟังก์ชัน rename ใช้เปลี่ยนชื่อไฟล์หรือไดเรกทอรี พารามิเตอร์แรกของฟังก์ชันรับชื่อไฟล์ปัจจุบันหรือพาธไปยังไฟล์นั้น พารามิเตอร์ที่สองรับชื่อใหม่หรือพาธใหม่ ฟังก์ชันคืนค่า true ในกรณีที่สำเร็จ และ false ในกรณีที่เกิดข้อผิดพลาด

ไวยากรณ์

rename(string $oldname, string $newname, resource $context = null): bool

ตัวอย่าง

เปลี่ยนชื่อไฟล์จาก 'old.txt' เป็น 'new.txt':

<?php
	$res = rename('old.txt', 'new.txt');
	var_dump($res);
?>

ผลลัพธ์การทำงานของโค้ด:

true

ตัวอย่าง

ย้ายไฟล์ไปยังไดเรกทอรีอื่น:

<?php
	$res = rename('file.txt', 'newdir/file.txt');
	var_dump($res);
?>

ผลลัพธ์การทำงานของโค้ด:

true

ตัวอย่าง

ลองเปลี่ยนชื่อไฟล์ที่ไม่มีอยู่:

<?php
	$res = rename('nonexistent.txt', 'new.txt');
	var_dump($res);
?>

ผลลัพธ์การทำงานของโค้ด:

false

ตัวอย่าง

เปลี่ยนชื่อไดเรกทอรี:

<?php
	$res = rename('olddir', 'newdir');
	var_dump($res);
?>

ผลลัพธ์การทำงานของโค้ด:

true

ดูเพิ่มเติม

ฟังก์ชัน copy,
ซึ่งใช้คัดลอกไฟล์
ฟังก์ชัน unlink,
ซึ่งใช้ลบไฟล์
ฟังก์ชัน move_uploaded_file,
ซึ่งใช้ย้ายไฟล์ที่อัปโหลด