getcwd() (getcwd)
تابع «getcwd» مسیر کاری جاری را می دهد. «مسیر کاری جاری (Current Working Directory)» یعنی پوشه ای که کد الآن داخلش کار می کند. مثل این که بدانی دفتر کلاس الان کجاست.
تعریف و نحو
طبق منبع، getcwd() مسیر کاری فعلی را برمی گرداند. در صورت خطا، مقدار FALSE برمی گردد.
نمونه سریع
<?php
echo getcwd();
?>
نمونه امن با بررسی خطا
<?php
$cwd = getcwd();
if ($cwd === false) {
echo "خطا در دریافت مسیر.";
} else {
echo "مسیر فعلی: " . $cwd;
}
?>
گام های کاربردی
- تابع را صدا بزن و خروجی را ذخیره کن.
- اگر FALSE بود، پیام خطا چاپ کن.
- وگرنه، مسیر برگشتی را نمایش بده.
نکته: نتیجه getcwd فقط یک رشته مسیر است؛ آن را جابه جا نمی کند.
هشدار: اگر دسترسی پوشه محدود باشد، ممکن است FALSE برگردد.
ارتباط با مرجع دایرکتوری
برای دیدن همه توابع پوشه ها، به مرجع دایرکتوری (PHP Directory) برو. برای تغییر مسیر کاری، صفحه chdir را هم ببین.
جمع بندی سریع
- getcwd مسیر کاری فعلی را برمی گرداند.
- در خطا، مقدار FALSE می دهد.
- چاپ مستقیم یا ذخیره در متغیر ممکن است.
- برای تغییر مسیر، از chdir استفاده کن.