basename() (basename)
«تابع basename (basename)» فقط نام فایل را از مسیر برمی گرداند. مثل زمانی که از آدرس خانه، فقط اسم صاحب خانه را بخواهی. بنابراین برای نمایش نام کوتاه فایل خیلی کاربردی است.
تعریف ساده تابع basename
تابع basename() از «مسیر فایل (File Path)» فقط «نام فایل (Filename)» را می دهد. همچنین، می توانی «پسوند (Suffix)» را بدهی تا اگر برابر بود، حذف شود. برای آشنایی بیشتر، مرجع تابع basename و دیگر توابع فایل سیستم را ببین.
سینتکس و پارامترها
basename(path, suffix)؛ ورودی path الزامی است. ورودی suffix اختیاری است و اگر با انتهای نام فایل یکی باشد، حذف می شود.
مثال سریع
<?php
$path = "/testweb/home.php";
// فقط نام فایل را برگردان
echo basename($path);
echo "\n";
// نام فایل بدون پسوند .php
echo basename($path, ".php");
?>
کاربردهای رایج تابع basename
- نمایش نام فایل در رابط کاربری.
- ساخت عنوان از نام فایل ذخیره شده.
- پاک کردن پسوند برای نمایش تمیزتر.
نکات و دام های مهم
نکته: مسیرها در ویندوز و لینوکس فرق دارند. اما basename با هر دو خوب کار می کند.
نکته: اگر پسوند اشتباه بدهی، حذف نمی شود. باید دقیقاً یکی باشد.
هشدار: روی ورودی های کاربر حساب باز نکن. ابتدا مسیر را اعتبارسنجی کن.
سه گام عملی
- مسیر کامل فایل را بگیر.
- در صورت نیاز پسوند را تعیین کن.
- خروجی basename را نمایش بده.
جمع بندی سریع
- basename فقط نام فایل را می دهد.
- پسوند اختیاری است و باید دقیق باشد.
- برای رابط ها، خروجی تمیز می سازد.
- اعتبارسنجی مسیر را فراموش نکن.