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