ftp_rename (ftp_rename)
با ftp_rename می توانی نام فایل یا پوشه را در سرور FTP عوض کنی. «تغییر نام فایل FTP» خیلی شبیه تغییر اسم پوشه بازی هاست؛ فقط اینجا روی سرور است.
تعریف و کاربرد
طبق منبع، ftp_rename() نام یک فایل یا پوشه را در سرور تغییر می دهد. اگر موفق شود TRUE برمی گرداند؛ در غیر این صورت FALSE.
سینتکس و پارامترها
ftp_rename( ftp_conn, oldname, newname )
- ftp_conn: اتصال FTP موجود.
- oldname: مسیر فایل یا پوشه فعلی.
- newname: نام یا مسیر جدید برای مورد انتخابی.
مثال عملی: تغییر نام فایل
<?php
$ftp_server = "ftp.example.com";
$ftp_conn = ftp_connect($ftp_server) or die("Could not connect to $ftp_server");
$login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass);
$old_file = "oldfile.txt";
$new_file = "newfile.txt";
if (ftp_rename($ftp_conn, $old_file, $new_file)) {
echo "Renamed $old_file to $new_file";
} else {
echo "Problem renaming $old_file to $new_file";
}
ftp_close($ftp_conn);
?>
نکات مسیر و سطح دسترسی
حتماً مسیر درست بده. همچنین مجوزهای نوشتن لازم است. وگرنه عملیات ناموفق می شود.
ارتباط با توابع مفید دیگر
برای دیدن پوشه فعلی از ftp_pwd کمک بگیر. برای ارسال راحت تر از پشت فایروال، ftp_pasv را روشن کن. برای آپلود قبل از تغییر نام، ftp_put مناسب است. برای بررسی لیست فایل ها، ftp_nlist یا ftp_rawlist را ببین.
هشدار: اگر مقصد هم نام موجود باشد، ممکن است خطا بگیری. ابتدا وجود مسیر مقصد را بررسی کن.
گام های پیشنهادی
- اتصال بده و وارد شو.
- مسیر قدیمی و جدید را دقیق بنویس.
- تابع
ftp_renameرا اجرا کن.
جمع بندی سریع
- برای تغییر نام روی سرور است.
- مسیرها را دقیق وارد کن.
- مجوز نوشتن ضروری است.
- TRUE یعنی موفق؛ FALSE یعنی خطا.