ftp_rawlist (ftp_rawlist)
تابع ftp_rawlist «فهرست خام FTP» را می دهد. یعنی لیست فایل ها را با اطلاعات کامل برمی گرداند. هر خط یک رشته است. بنابراین باید خودت آن ها را تحلیل کنی.
تعریف و کاربرد
طبق منبع، ftp_rawlist() از یک پوشه در سرور، لیست فایل ها را با اطلاعات بازمی گرداند. هیچ «تجزیه (Parsing)» انجام نمی شود. خروجی یک آرایه رشته هاست.
سینتکس و پارامترها
ftp_rawlist( ftp_conn, dir, recursive )
- ftp_conn: اتصال FTP موجود.
- dir: مسیر پوشه؛ می تواند آرگومان های LIST داشته باشد.
- recursive: اگر TRUE باشد، فرمان «LIST -R» ارسال می شود.
مثال عملی: دریافت لیست با اطلاعات
<?php
$ftp_server = "ftp.example.com";
$ftp_conn = ftp_connect($ftp_server) or die("Could not connect to $ftp_server");
$login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass);
$filelist = ftp_rawlist($ftp_conn, "/");
ftp_close($ftp_conn);
var_dump($filelist);
?>
خواندن نتیجه خام
هر عنصر آرایه، یک خط از خروجی LIST است. بنابراین باید رشته ها را خودت پردازش کنی. مثلاً با الگوهای ساده و جداکننده ها.
حالت بازگشتی (LIST -R)
وقتی recursive برابر TRUE باشد، زیرپوشه ها هم لیست می شوند. اما حجم خروجی بیشتر می شود.
تفاوت با ftp_nlist
ftp_nlist فقط نام فایل ها را می دهد. اما فهرست خام FTP شامل مجوز، مالک و تاریخ است.
گام های پیشنهادی
- اتصال بده و وارد شو.
- پوشه هدف را در
dirتعیین کن. - در صورت نیاز،
recursiveرا TRUE بگذار.
نکته: برای دیدن پوشه فعلی از ftp_pwd کمک بگیر. برای حالت پشت فایروال، ftp_pasv را روشن کن. همچنین برای دستورات خاص، دستور خام FTP را ببین.
فهرست خام FTP را به عنوان مرجع داخلی ذخیره کن.
جمع بندی سریع
- خروجی آرایه رشته هاست.
- هیچ تجزیه ای انجام نمی شود.
- گزینه بازگشتی، زیرپوشه ها را می آورد.
- برای نام ها فقط، از
ftp_nlistاستفاده کن.