Laravel Storage FTP登录失败，如何验证凭据并返回布尔值？

我明白你的需求——现在用Storage::createFtpDriver创建FTP驱动时，调用exists()会直接抛出登录失败的异常，而你希望得到一个布尔值来优雅处理验证结果对吧？其实核心就是捕获FTP连接时的异常，把抛出异常的逻辑转换成返回布尔值的逻辑。

下面给你两种实用的解决方案：

方案一：封装通用的凭据验证方法 #

把验证逻辑抽成一个可复用的方法，方便在任何地方调用：

use Illuminate\Filesystem\FilesystemAdapter;
use Illuminate\Support\Facades\Storage;
use League\Flysystem\Ftp\FtpConnectionFailedException;
use League\Flysystem\Ftp\FtpConnectionRefusedException;

/**
 * 验证FTP凭据是否有效
 * @param array $ftpConfig FTP配置数组
 * @return bool 凭据有效返回true，无效返回false
 */
public function validateFtpCredentials(array $ftpConfig): bool
{
    try {
        // 创建FTP驱动实例
        /** @var FilesystemAdapter $ftp */
        $ftp = Storage::createFtpDriver($ftpConfig);
        
        // 执行一个轻量的连接验证操作（比如检查根目录是否存在）
        // 这里用根目录而不是你的目标文件，避免因目标文件本身不存在导致误判
        $ftp->exists('/');
        
        return true;
    } catch (FtpConnectionFailedException | FtpConnectionRefusedException $e) {
        // 捕获FTP连接/登录失败的特定异常
        return false;
    } catch (\Exception $e) {
        // 兜底捕获其他可能的异常（比如配置错误）
        return false;
    }
}

调用示例 #

// 组装你的FTP配置
$ftpConfig = [
    'host' => getSetting(SettingRepository::FTP_HOST)->getvalue(),
    'username' => getSetting(SettingRepository::FTP_USERNAME)->getvalue(),
    'password' => getSetting(SettingRepository::FTP_PASSWORD)->getvalue(),
    'port' => 21, // 根据你的FTP服务器端口调整
    'passive' => true, // 大多数情况下需要开启被动模式
    // 其他可选配置：root、timeout、ssl等
];

// 验证凭据
if ($this->validateFtpCredentials($ftpConfig)) {
    // 凭据有效，继续后续操作
    $ftp = Storage::createFtpDriver($ftpConfig);
    if ($ftp->exists(self::REMOTE_FILE_DEST)) {
        // 目标文件存在的处理逻辑
    } else {
        // 目标文件不存在的处理逻辑
    }
} else {
    // 凭据无效，提示用户或记录错误日志
}

方案二：直接在业务代码中捕获异常 #

如果只是在某个特定场景下验证，也可以直接在exists()操作外层加try-catch：

$ftpConfig = [
    // 你的FTP配置
];

try {
    $ftp = Storage::createFtpDriver($ftpConfig);
    $fileExists = $ftp->exists(self::REMOTE_FILE_DEST);
    
    // 这里处理文件存在/不存在的逻辑
} catch (FtpConnectionFailedException | FtpConnectionRefusedException $e) {
    // 登录失败，标记凭据无效
    $fileExists = false;
    // 可以在这里记录错误日志：logger()->error('FTP登录失败：'.$e->getMessage());
}

关键注意点 #

• 要引入正确的异常类：Flysystem的FTP驱动抛出的连接异常都在League\Flysystem\Ftp命名空间下，记得提前use这些类。
• 验证操作尽量选轻量的：比如检查根目录存在，而不是直接检查你的目标文件——避免因目标文件本身不存在，误判成凭据无效。
• 如果验证后要执行后续操作，建议重新创建驱动实例：因为验证时的连接可能在闲置后断开，重新创建能保证连接活跃。

内容的提问来源于stack exchange，提问作者Bas