scandir() (scandir)
تابع «scandir» محتویات یک پوشه را به صورت آرایه (Array) برمی گرداند. یعنی نام فایل ها و پوشه های داخل مسیر را می دهد؛ مثل دیدن لیست پوشه «Pictures» در گوشی.
تعریف و نحو تابع scandir
طبق منبع، scandir(directory, order, context) آرایه ای از فایل ها و پوشه ها می دهد. شکست بخورد، مقدار FALSE برمی گردد. ترتیب پیش فرض، حروفیِ صعودی است.
نمونه مرتب سازی صعودی و نزولی
<?php
$dir = "/images/";
$a = scandir($dir);
$b = scandir($dir, 1);
print_r($a);
print_r($b);
?>
راهنمای سریع استفاده
- مسیر پوشه را در متغیر بگذار.
- با
scandirآرایه نام ها را بگیر. - برای نزولی، آرگومان دوم را 1 قرار بده.
- نتیجه را با
print_rچاپ کن.
نکته: «ترتیب (Order)» می تواند 0، 1 یا SCANDIR_SORT_NONE باشد. مقدار 0 صعودی است.
هشدار: اگر مسیر پوشه نباشد، اخطار E_WARNING می بینی و مقدار FALSE می آید.
مطالب مرتبط
برای باز کردن پوشه از opendir استفاده کن. برای خواندن مرحله به مرحله نام ها، readdir را ببین. همچنین مسیر جاری را با getcwd بررسی کن.
جمع بندی سریع
- scandir نام ها را در آرایه می دهد.
- پیش فرض، ترتیب صعودی است.
- برای نزولی، آرگومان دوم را 1 بگذار.
- در خطا، مقدار FALSE می آید.