במדריך זה, נדון בשימוש ובתחביר של ה- rename() פונקציה ב-PHP.
מהי פונקציית rename() ב-PHP?
ה שנה שם() function היא פונקציית PHP מובנית המשמשת לשינוי שם הקובץ או הספרייה מבלי לשנות את תוכן הקובץ. פונקציה זו לוקחת את השם הישן והשם החדש של הקובץ כארגומנטים נחוצים.
תחביר
הפורמט לשימוש ב- שנה שם() הפונקציה ב-PHP היא כדלקמן:
לשנות שם ( ישן , חָדָשׁ , הֶקשֵׁר )
ה ישן ו חָדָשׁ הם הפרמטרים החובה, ה ישן מציין את הקובץ שברצונך לשנות, חָדָשׁ מציין את השם החדש לקובץ. ה הֶקשֵׁר הוא פרמטר אופציונלי שקובע את ההקשר לשינוי שם הקובץ.
ה rename() פונקציה החזרות נָכוֹן על הביצוע המוצלח, אחרת, הוא חוזר שֶׁקֶר. ה שנה שם() הקובץ מחזיר שגיאה אם הקובץ החדש כבר קיים באותה ספרייה.
כיצד להשתמש בפונקציית rename() ב-PHP?
שינוי שם הקובץ דרך rename() פונקציה קל, והדוגמאות הבאות יעזרו לך במקרה זה.
כיצד לשנות שם של קובץ באמצעות פונקציית PHP rename()
הקוד הבא ישנה את שם הקובץ test.php אל א file.php:
לשנות שם ( 'test.php' , 'file.php' ) ;
?>
אם תשנה את השם של קובץ שכבר קיים באותה ספרייה, הוא יוחלף.
דוגמה 1 - כיצד לשנות שם קובץ באמצעות פונקציית PHP rename()
הדוגמה הבאה תשנה את שם ה- test.php ל test2.php. בסיום מוצלח, ה אם הצהרה יודפס על הקונסולה, אחרת, ה הצהרה אחרת יוצג כפלט:
אם ( לשנות שם ( 'ג: \\ xampp \\ htdocs \\ test.php' , 'ג: \\ xampp \\ htdocs \\ test2.php' ) )
{
הֵד 'שם test.php שונה בהצלחה ל-test2.php' ;
}
אַחֵר {
הֵד 'שגיאה בעת שינוי שם הקובץ' ;
}
?>
הערה: ב-PHP, בעת ציון נתיבים לקובץ עבור ה- שנה שם() פונקציה (ופעולות אחרות הקשורות לקבצים), חשוב להשתמש בה קווים אחוריים כפולים (\\) במקום נטוי בודד (\) כדי להבטיח שנתיב הקובץ יתפרש כהלכה, הסיבה לכך היא שאלכסון אחורי בודד מטופל כתו בריחה ב-PHP.
דוגמה 2 - כיצד לשנות שם ספרייה באמצעות פונקציית PHP rename()
כדי לשנות שם ספרייה באמצעות ה שנה שם() פונקציה, עקוב אחר הקוד הנתון להלן:
$oldDirName = 'מסמכים' ;$newDirName = 'קבצים לדוגמה' ;
אם ( לשנות שם ( $oldDirName , $newDirName ) ) {
הֵד 'שם הספרייה שונה בהצלחה!' ;
} אַחֵר {
הֵד 'שגיאה בעת שינוי שם הספרייה.' ;
}
שורה תחתונה
הפונקציה rename() של PHP היא כלי אמין לשינוי שם של קובץ או ספרייה ללא מאמץ תוך שמירה על התוכן שלו. התחביר הפשוט ויכולות הטיפול בשגיאות הופכות אותו לבחירה נוחה למשימות ניהול קבצים. על ידי מינוף הכוח של שנה שם(), מפתחי PHP יכולים לארגן ולשנות ביעילות שמות קבצים או ספריות בפרויקטים שלהם.