realpath() (realpath)
تابع realpath() مسیر «مسیر مطلق» را می دهد. «مسیر مطلق (Absolute Path)» آدرسی کامل است؛ مثل آدرس خانه با شهر و خیابان.
تعریف «مسیر مطلق» با realpath
realpath() همه لینک های نمادین و الگوهای اضافی مانند /./ و /../ را حذف می کند و مسیر مطلق را برمی گرداند.
نمونه ساده
مسیر کامل فایل را برگردان.
<?php
echo realpath("test.txt");
?>
پارامتر
path: مسیر نسبی یا مطلقی که باید بررسی شود.
بررسی خطا و مقدار بازگشتی
در موفقیت، مسیر مطلق برمی گردد. در خطا، مقدار FALSE می آید. پس نتیجه را چک کن.
<?php
$abs = realpath("test.txt");
if ($abs === false) {
// مسیر نامعتبر است یا فایل پیدا نشد
} else {
echo $abs;
}
?>
گام های عملی
- مسیر ورودی را مشخص کن.
- تابع را صدا بزن و نتیجه بگیر.
- برای FALSE کنترل خطا انجام بده.
نکته: برای نمایش محتوا، می توان از readfile() استفاده کرد.
هشدار: مسیرها را از کاربر بدون فیلتر نپذیر. از پیمایش دایرکتوری ناامن جلوگیری کن.
برای توضیح بیشتر درباره مسیر مطلق همین صفحه مرجع است. همچنین برای کار با لینک نمادین ببین readlink().
جمع بندی سریع
- realpath مسیر مطلق را برمی گرداند.
- الگوهای اضافی حذف می شوند.
- در خطا، مقدار FALSE می آید.
- کنترل خطا را فراموش نکن.