در ادامه آموزش توابع در زبان برنامه نویسی php به یکی دیگر از توابع این زبان می رسیم که تابع ( ) dir نام دارد.در ادامه ای مطلب با کلیات و ساختار این تابع آشنا خواهید شد.
تابع ( ) dir ، پوشه تعیین شده برای آن را باز کرده و نتیجه را به صورت یک object به صفحه ارسال می کند . object ارسالی دارای ۳ متد ( ) read ( ) ، rewind و ( ) close است که از آنها می توان برای کار با اطلاعات خروجی تابع استفاده کرد . نحوه کار با این متدها در مثال عملی نمایش داده شده است .
نکته : تابع ( ) dir ، در صورتی که موفق شود پوشه تعیین شده برای آن را باز کند ، لیست محتویات درونی پوشه را به صورت یک آرایه بر می گرداند .
اما در صورتی که پوشه باز نشده و یا آن را پیدا نکند ، مقدار False را به همراه یک error به صفحه بر می گرداند . شما می توانید پیام error ارسالی را با استفاده از یک علامت @ در مقابل نام تابع مخفی نمایید .
شکل کلی تعریف و استفاده از تابع ( ) dir در PHP به صورت زیر است :
;(dir ( directory
directory:
این پارامتر تعیین کننده نام یا آدرس پوشه ای است که می خواهید برنامه آن را باز کرده و بخواند .
استفاده از این پارامتر اجباری است .
