ftp_nlist (ftp_nlist)
تابع ftp_nlist فهرست فایل های یک پوشه را می دهد. «فهرست (List)» یعنی نام ها را پشت سرهم می گیری. این تابع ساده است و سریع کار می کند. فقط مسیر بده و خروجی را بخوان.
ftp_nlist چه می کند؟
نام فایل های پوشه خواسته شده روی سرور FTP را برمی گرداند. برای پوشه فعلی از . استفاده کن. خروجی یک آرایه از نام فایل هاست.
سینتکس
ftp_nlist(ftp_conn, dir);
مثال: لیست گرفتن از پوشه فعلی
<?php
// اتصال و ورود به FTP
$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);
// گرفتن فهرست فایل ها از پوشه فعلی
$file_list = ftp_nlist($ftp_conn, ".");
var_dump($file_list);
// بستن اتصال
ftp_close($ftp_conn);
?>
گام های عملی
- به سرور FTP وصل شو و لاگین کن.
- مسیر پوشه را تعیین کن. برای فعلی نقطه بده.
ftp_nlistرا صدا بزن و خروجی بگیر.- نتیجه را بررسی کن و اتصال را ببند.
نکات و هشدارها
نکته: در موفقیت آرایه می دهد؛ در خطا false برمی گردد.
نکته: برای جزئیات بیشتر از ftp_mlsd استفاده کن.
هشدار: بعضی سرورها خروجی متفاوت می دهند؛ همیشه خطا را چک کن.
صفحات مرتبط داخلی
برای «فهرست فایل های FTP» سریع، همین صفحه مناسب است. برای لیست با جزئیات، ftp_mlsd را ببین. اگر نیاز به نمایش کامل داری، ftp_rawlist کاربردی است.
لینک های منبع
- W3Schools: ftp_nlist() توضیح تابع و مثال.
- W3Schools: PHP FTP Reference فهرست توابع FTP.
جمع بندی سریع
- مسیر بده، نام فایل ها را بگیر.
.یعنی پوشه فعلی.- خروجی آرایه نام هاست.
- در خطا مقدار
falseاست.