توابع FTP در PHP

مقدمه PHP FTP

توابع FTP دسترسی کاربران سرورهای فایل را از طریق پروتکل انتقال فایل (FTP) فراهم می‌کنند.

توابع FTP برای باز کردن، ورود و بستن اتصال، همچنین برای آپلود، دانلود، تغییر نام، حذف و دریافت اطلاعات فایل از سرورهای فایل استفاده می‌شوند. نه همه توابع FTP برای هر سروری موثر هستند یا نتایج مشابهی را برمی‌گردانند. از PHP 3 به بعد، توابع FTP قابل استفاده هستند.

این توابع برای دسترسی دقیق به سرورهای FTP استفاده می‌شوند. اگر تنها نیاز به عملیات خواندن و نوشتن به سرور FTP دارید، توصیه می‌شود از wrapper ftp:// در توابع filesystem استفاده کنید.

نصب

نسخه‌ی Windows PHP این پلاگین FTP را به صورت پیش‌فرض دارد. برای استفاده از این توابع نیازی به بارگذاری هیچ کتابخانه‌ی اضافی نیست.

اما اگر نسخه‌ی Linux PHP خود را اجرا می‌کنید، در زمان کامپایل به گزینه‌ی --enable-ftp (برای نسخه‌های PHP4 یا بالاتر) یا --with-ftp (برای نسخه‌ی PHP3) اضافه کنید.

توابع FTP در PHP

PHP:نسخه‌ی قدیمی‌ترین PHP که این توابع را پشتیبانی می‌کند را نشان می‌دهد.

توابع توضیحات PHP
ftp_alloc() فضای لازم برای فایل‌هایی که قرار است به سرور FTP آپلود شوند را اختصاص دهید. 5
ftp_cdup() دایرکتوری فعلی را به دایرکتوری والد سرور FTP تغییر دهید. 3
ftp_chdir() دایرکتوری فعلی سرور FTP را تغییر دهید. 3
ftp_chmod() اجازه دسترسی به فایل را از طریق FTP تنظیم کنید. 5
ftp_close() اتصال FTP را ببندید. 4
ftp_connect() اتصال FTP را باز کنید. 3
ftp_delete() فایل را از سرور FTP حذف کنید. 3
ftp_exec() یک برنامه / دستور را در FTP اجرا کنید. 4
ftp_fget() فایل را از سرور FTP دانلود کنید و در فایل باز شده محلی ذخیره کنید. 3
ftp_fput() فایل باز شده را آپلود کنید و در سرور FTP به عنوان فایل ذخیره کنید. 3
ftp_get_option() تنظیمات مختلف گزینه‌های اتصال فعلی FTP را بازگرداند. 4
ftp_get() فایل را از سرور FTP دانلود کنید. 3
ftp_login() به سرور FTP ورود کنید. 3
ftp_mdtm() زمان آخرین تغییرات فایل مشخص شده را بازگرداند. 3
ftp_mkdir() یک دایرکتوری جدید در سرور FTP ایجاد کنید. 3
ftp_nb_continue() دریافت / ارسال پیاپی فایل (non-blocking). 4
ftp_nb_fget() فایل را از سرور FTP دانلود کنید و در فایل باز شده محلی ذخیره کنید (non-blocking) 4
ftp_nb_fput() فایل باز شده را آپلود کنید و در سرور FTP به عنوان فایل ذخیره کنید (non-blocking). 4
ftp_nb_get() فایل را از سرور FTP دانلود کنید (non-blocking). 4
ftp_nb_put() فایل را به سرور آپلود کنید (non-blocking). 4
ftp_nlist() لیست فایل‌های دایرکتوری مشخص شده را بازگرداند. 3
ftp_pasv() برگردان وضعیت passive mode FTP فعلی. 3
ftp_put() فایل را به سرور آپلود می‌کند. 3
ftp_pwd() نام دایرکتوری فعلی را برمی‌گرداند. 3
ftp_quit() ftp_close() به عنوان اسم مستعار ftp_quit() استفاده می‌شود. 3
ftp_raw() یک فرمان raw به سرور FTP ارسال می‌کند. 5
ftp_rawlist() لیست جزئیات فایل‌های موجود در دایرکتوری مشخص شده را برمی‌گرداند. 3
ftp_rename() فایل یا دایرکتوری روی سرور FTP را تغییر نام می‌دهد. 3
ftp_rmdir() دایرکتوری روی سرور FTP را حذف می‌کند. 3
ftp_set_option() تنظیمات مختلفی را برای اجرای FTP تنظیم می‌کند. 4
ftp_site() فرمان SITE به سرور ارسال می‌کند. 3
ftp_size() اندازه فایل مشخص شده را برمی‌گرداند. 3
ftp_ssl_connect() یک اتصال SSL-FTP امن باز می‌کند. 4
ftp_systype() شناسه نوع سیستم سرور FTP دور را برمی‌گرداند. 3

مقدارهای ثابت FTP PHP

PHP:نشان‌دهنده‌ای است که قدیمی‌ترین نسخه PHP که از این مقدار پشتیبانی می‌کند را نشان می‌دهد.

مقدارهای ثابت توضیحات PHP
FTP_ASCII   3
FTP_TEXT   3
FTP_BINARY   3
FTP_IMAGE   3
FTP_TIMEOUT_SEC   3
FTP_AUTOSEEK   4
FTP_AUTORESUME

موقعیت شروع و ادامه برای درخواست‌های GET و PUT به صورت خودکار تعیین می‌شوند

فقط در حالتی که FTP_AUTOSEEK باز باشد می‌توانند کار کنند

4
FTP_FAILED انتقال‌های همزمان شکست‌خورده‌اند 4
FTP_FINISHED انتقال‌های همزمان موفقیت‌آمیز بودند 4
FTP_MOREDATA انتقال‌های همزمان در حالت فعال هستند 4