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