dir() (dir)
تابع «dir» یک شیء «Directory» برمی گرداند. «شیء (Object)» یعنی بسته ای از داده و توابع. با آن می توان پوشه را بخوانیم، عقب برویم، و پایان کار ببندیم. مثل فهرست کتابخانه مدرسه است.
تعریف، نحو و ویژگی ها
طبق منبع، dir(directory, context) یک نمونه از کلاس Directory می دهد. ویژگی ها: handle و path. متدها: read()، rewind()، close().
نمونه عملی تابع dir
<?php
$d = dir(getcwd());
echo "Handle: " . $d->handle . "<br>";
echo "Path: " . $d->path . "<br>";
while (($file = $d->read()) !== false) {
echo "filename: " . $file . "<br>";
}
$d->close();
?>
گام های ساده برای پیمایش پوشه
- با
dir(مسیر)شیء دایرکتوری بساز. - با
read()نام فایل ها را بگیر. - در پایان، با
close()اتصال را ببند.
نکته: rewind() لیست را به ابتدای پوشه برمی گرداند؛ مثل اسکرول به بالا.
هشدار: اگر مسیر اشتباه باشد، تابع شکست می خورد و مقدار FALSE می دهد.
ارتباط با مرجع دایرکتوری
برای دیدن همه توابع پوشه، به مرجع دایرکتوری (PHP Directory) برو. همچنین برای بازکردن سنتی پوشه می توانی opendir و readdir را ببینی.
جمع بندی سریع
- تابع dir شیء Directory می دهد.
- ویژگی ها: handle و path.
- متدها: read، rewind، close.
- بعد از کار، حتماً close را صدا بزن.