readdir() (readdir)
تابع «readdir» نام فایل بعدی را از پوشه می دهد. یعنی هر بار صدا بزنی، یکی از داخل پوشه برمی گرداند؛ مثل برداشتن برگه ها از یک پوشه مدرسه.
تعریف و نحو
طبق منبع، readdir(dir) نام ورودی بعدی را می دهد. اگر چیزی نمانده باشد یا خطا شود، FALSE برمی گردد.
نمونه استاندارد: فهرست کردن محتوا
<?php
$dir = "/images/";
if (is_dir($dir)) {
$dh = opendir($dir);
if ($dh !== false) {
while (($file = readdir($dh)) !== false) {
echo "filename: " . $file . "<br>";
}
closedir($dh);
}
}
?>
گام های عملی
- با is_dir مسیر را چک کن.
- با opendir پوشه را باز کن.
- با readdir نام ها را بخوان.
- خروجی را نمایش بده.
- با closedir دسته را ببند.
نکته: «دسته دایرکتوری (Directory Handle)» یک اشاره گر برای کار با پوشه است.
هشدار: اگر مجوزها درست نباشد، باز کردن پوشه ممکن نیست و مقدار FALSE برمی گردد.
ارتباط های مفید
برای شروع، opendir را ببین. سپس برای بستن، closedir را بررسی کن. همچنین راهنمای تابع readdir این صفحه را مرجع نگه دار.
جمع بندی سریع
- readdir هر بار یک نام برمی گرداند.
- در پایان، closedir را فراموش نکن.
- در خطا یا پایان، FALSE می آید.
- کنترل مجوزها بسیار مهم است.