تابع ( ) scandir ، لیست فایل ها و پوشه های موجود در یک مسیر خاص را به صورت یک ارایه بر می گرداند .
نکته : خروجی این تابع در صورت موفقیت در خواندن پوشه ارایه ای از لیست فایل ها و پوشه ها و در صورت عدم موفقیت مقدار False به همراه یک پیام هشدار خواهد بود.
حتما بخوانید: تابع ( ) readdir در PHP
شکل کلی تعریف و استفاده از تابع ( ) scandir در PHP به صورت زیر است :
| Syntax | scandir ( directory , sort ) ; |
| syntax توضیح هر یک از موارد | |
| توضیح | پارامتر |
| این پارامتر تعیین کننده نام یا ادرس پوشه ای است که می خواهید برنامه ان را باز کرده لیست فایل های موجود در ان را در خروجی برگرداند . استفاده از این پارامتر اجباری است . |
directory |
| این پارامتر ترتیب نشان دادن ایتم های ارایه خروجی تابع را مشخص می کند . به صورت پیش فرض این ارایه از عضو ۰ شروع شده و رو به افزایش می رود . اگر مقدار sort را روی ۱ تنظیم نمایید ، ارایه از انتها به صورت کاهشی نمایش داده خواهد شد . استفاده از این پارامتر اختیاری است . |
sort |
مثال های عملی :
در مثال های زیر نحوه کار با تابع ( ) ۸ را در عمل به شما نمایش داده ایم .
مثال ۱ : در مثال زیر با استفاده از تابع ( ) ۸ ، فایل ها و اجزای پوشه images را به صورت یک ارایه در خروجی نمایش داده ایم. در مثال اول، ترتیب ارایه به صورت پیش فرض و از کم به زیاد می باشد :
| Example | |
| <?php print_r ( scandir ( ” images ” ) ) ; ?> |
کد |
| Array ( [0] => . [1] => .. [2] => ASP.jpg [3] => PHP.jpg [4] => HTML.gif ) |
خروجی |
حتما بخوانید: تابع ( ) opendir در PHP
مثال ۲ : در مثال دوم ، کد مثال ۱ را باز نویسی کرده ایم با این تفاوت که با مقدار دهی پارامتر sort به ۱ ، باعث شده ایم تا ترتیب نمایش ارایه برعکس شده و از انتها به ابتدا باشد :
| Example | |
| <?php print_r ( scandir ( ” images ” , 1 ) ) ; ?> |
کد |
| Array ( [4] => HTML.gif [3] => PHP.jpg [2] => ASP.jpg [1] => .. [0] => . ) |
خروجی |
با دریافت « مشاوره برنامهنویسی، وب و سئو » از کارشناسان جوان حرفهای و باتجربه ساکوراد؛ موفقیت کسب و کار، رونق فروش و افزایش درامد خود را تضمین کنید!
و اما کلام اخر…
تابع ( ) scandir یک ارایه از نام فایلها و دایرکتوریها را برمیگرداند. در صورتی که دایرکتوری خالی باشد، ارایهای خالی برمیگرداند.






