rename() (rename)
تابع rename() نام «فایل/پوشه» را عوض می کند. «تغییر نام فایل» یعنی جابجا کردن یا نام گذاری دوباره مسیر.
تعریف و کاربرد
rename(old, new, context) یک فایل یا پوشه را به نام یا مسیر جدید می برد. بنابراین می توانی نام را عوض کنی، یا آن را به پوشه دیگر منتقل کنی.
سینتکس
rename(old, new, context) پارامتر context اختیاری است. «کانتکست (Context)» مجموعه گزینه های جریان است.
نمونه کاربرد
نام پوشه و فایل را عوض کن. هر خط یک کار:
<?php
rename("images", "pictures");
rename("/test/file1.txt", "/home/docs/my_file.txt");
?>
گام های عملی
- مسیر قدیمی را دقیق بنویس.
- مسیر جدید را درست مشخص کن.
- اسکریپت را اجرا و نتیجه را چک کن.
نکته: اگر می خواهی فقط نمایش کنی، از readfile() کمک بگیر.
نکته: برای مسیر مطلق، قبل از تغییر نام، realpath() را بررسی کن.
هشدار: اگر مقصد وجود داشته باشد، ممکن است جایگزین شود. همیشه نسخه پشتیبان داشته باش.
جمع بندی سریع
- rename نام یا مسیر را تغییر می دهد.
- می تواند جابجایی پوشه ای انجام دهد.
- کانتکست اختیاری است.
- مسیرهای دقیق بنویس تا خطا نشود.