ftp_get_option (ftp_get_option)
با ftp_get_option می توانی «دریافت گزینه های FTP» را انجام دهی. «گزینه زمان انتظار (Timeout)» یعنی حداکثر صبر شبکه. «خودجستجو (AutoSeek)» یعنی ادامه خودکار از جای درست.
تعریف ساده
ftp_get_option() مقدار گزینه های زمان اجرا را برمی گرداند. مثلا زمان انتظار اتصال یا فعال بودن خودجستجو. این کمک می کند تنظیمات فعلی اتصال را ببینی.
سینتکس
ftp_get_option(resource $ftp_conn, int $option);
مقادیر گزینه ها
دو گزینه اصلی وجود دارد: FTP_TIMEOUT_SEC برای زمان انتظار عملیات شبکه، و FTP_AUTOSEEK برای فعال بودن ادامه خودکار.
مثال: خواندن Timeout و AutoSeek
<?php
$ftp_server = "ftp.example.com";
$ftp_conn = ftp_connect($ftp_server);
if ($ftp_conn === false) {
die("Could not connect.\n");
}
$login = ftp_login($ftp_conn, $ftp_username, $ftp_userpass);
if ($login === false) {
ftp_close($ftp_conn);
die("Login failed.\n");
}
$timeout = ftp_get_option($ftp_conn, FTP_TIMEOUT_SEC);
echo $timeout . "\n";
$autoseek = ftp_get_option($ftp_conn, FTP_AUTOSEEK);
echo ($autoseek ? "TRUE" : "FALSE") . "\n";
ftp_close($ftp_conn);
?>
گام های عملی
- با
ftp_connectوصل شو. - با
ftp_loginوارد شو. - گزینه مدنظر را انتخاب کن.
ftp_get_optionرا فراخوانی کن.- نتیجه را بررسی و اتصال را ببند.
نکات و هشدارها
نکته: اگر گزینه پشتیبانی نشود، FALSE و هشدار می گیری.
نکته: زمان انتظار زیاد، خطاها را دیرتر نشان می دهد.
هشدار: مقدار AutoSeek را فقط بخوان؛ تغییر با ftp_set_option انجام می شود.
لینک های مفید
- اتصال FTP برای شروع ضروری است.
- تنظیم گزینه های FTP برای تغییر مقدارها استفاده می شود.
- W3Schools: ftp_get_option() توضیح و مثال رسمی.
- W3Schools: PHP FTP Reference فهرست کامل توابع FTP.
جمع بندی سریع
- گزینه ها را با
ftp_get_optionبخوان. - Timeout تعداد ثانیه های صبر شبکه است.
- AutoSeek ادامه خودکار را نشان می دهد.
- برای تغییر، سراغ
ftp_set_optionبرو.