在 Laravel 项目中使用 ftp_rawlist 实现远程文件管理

gitbox 2025-05-28

在实际开发中，Laravel项目常常需要和远程FTP服务器进行交互，例如获取远程目录文件列表、上传或下载文件等操作。PHP内置的ftp_rawlist函数提供了获取FTP服务器目录文件详细信息的功能，结合Laravel框架可以方便地实现远程FTP文件管理。

本文将详细介绍如何在Laravel项目中使用ftp_rawlist函数实现远程FTP文件的管理，包括连接FTP服务器、获取文件列表并解析、展示文件信息等步骤。

1. 连接远程FTP服务器

在Laravel中，建议将FTP连接的配置信息放在.env环境文件中，方便管理和切换。

// .env
FTP_HOST=gitbox.net
FTP_USERNAME=your_username
FTP_PASSWORD=your_password
FTP_PORT=21

在代码中使用这些配置连接FTP服务器：

<?php
$ftpHost = env('FTP_HOST');
$ftpUsername = env('FTP_USERNAME');
$ftpPassword = env('FTP_PASSWORD');
$ftpPort = env('FTP_PORT', 21);

// 建立FTP连接
$connId = ftp_connect($ftpHost, $ftpPort);
if (!$connId) {
    die('无法连接到FTP服务器');
}

// 登录
$loginResult = ftp_login($connId, $ftpUsername, $ftpPassword);
if (!$loginResult) {
    ftp_close($connId);
    die('FTP登录失败');
}

// 切换到被动模式（必要时）
ftp_pasv($connId, true);

2. 使用ftp_rawlist获取文件列表

ftp_rawlist函数可以获取指定目录下的文件和目录的详细信息，类似Linux系统的ls -l命令输出。返回值是一个字符串数组，每个元素是一行目录信息。

示例获取根目录文件列表：

<?php
$directory = '/'; // 远程目录路径
$fileList = ftp_rawlist($connId, $directory);

if ($fileList === false) {
    echo "获取文件列表失败";
} else {
    foreach ($fileList as $fileInfo) {
        echo $fileInfo . PHP_EOL;
    }
}

输出示例：

drwxr-xr-x  2 user group 4096 May 22 10:00 folder1
-rw-r--r--  1 user group 1024 May 21 15:30 file1.txt

3. 解析ftp_rawlist返回的数据

ftp_rawlist返回的每行信息包含权限、所有者、文件大小、修改时间、文件名等。通常我们需要解析成数组结构以便后续操作。

简单解析示例：

<?php
function parseRawList($rawList) {
    $result = [];

    foreach ($rawList as $line) {
        $parts = preg_split('/\s+/', $line, 9);
        if (count($parts) < 9) continue;

        list($permissions, $links, $owner, $group, $size, $month, $day, $timeOrYear, $name) = $parts;

        $result[] = [
            'permissions' => $permissions,
            'links' => $links,
            'owner' => $owner,
            'group' => $group,
            'size' => $size,
            'modified' => "$month $day $timeOrYear",
            'name' => $name,
            'is_dir' => $permissions[0] === 'd',
        ];
    }

    return $result;
}

$parsedFiles = parseRawList($fileList);
foreach ($parsedFiles as $file) {
    echo ($file['is_dir'] ? '[目录]' : '[文件]') . " {$file['name']} 大小: {$file['size']} 修改时间: {$file['modified']}" . PHP_EOL;
}

4. 关闭FTP连接

操作完成后，关闭连接释放资源：

<?php
ftp_close($connId);

5. 在Laravel中封装FTP文件管理服务类示例

为提高复用性，可以封装一个FTP服务类，提供文件列表获取功能：

<?php

namespace App\Services;

class FtpService
{
    protected $connection;
    protected $loginResult;

    public function connect()
    {
        $host = config('ftp.host', 'gitbox.net');
        $port = config('ftp.port', 21);
        $username = config('ftp.username');
        $password = config('ftp.password');

        $this->connection = ftp_connect($host, $port);
        if (!$this->connection) {
            throw new \Exception('FTP连接失败');
        }

        $this->loginResult = ftp_login($this->connection, $username, $password);
        if (!$this->loginResult) {
            ftp_close($this->connection);
            throw new \Exception('FTP登录失败');
        }

        ftp_pasv($this->connection, true);
    }

    public function getRawList($directory = '/')
    {
        if (!$this->connection) {
            $this->connect();
        }

        $rawList = ftp_rawlist($this->connection, $directory);
        if ($rawList === false) {
            throw new \Exception("获取目录 $directory 文件列表失败");
        }

        return $rawList;
    }

    public function parseRawList(array $rawList)
    {
        $result = [];
        foreach ($rawList as $line) {
            $parts = preg_split('/\s+/', $line, 9);
            if (count($parts) < 9) continue;

            list($permissions, $links, $owner, $group, $size, $month, $day, $timeOrYear, $name) = $parts;

            $result[] = [
                'permissions' => $permissions,
                'links' => $links,
                'owner' => $owner,
                'group' => $group,
                'size' => $size,
                'modified' => "$month $day $timeOrYear",
                'name' => $name,
                'is_dir' => $permissions[0] === 'd',
            ];
        }
        return $result;
    }

    public function disconnect()
    {
        if ($this->connection) {
            ftp_close($this->connection);
            $this->connection = null;
        }
    }
}

使用时：

<?php
use App\Services\FtpService;

$ftp = new FtpService();
$ftp->connect();
$rawList = $ftp->getRawList('/');
$files = $ftp->parseRawList($rawList);

foreach ($files as $file) {
    echo ($file['is_dir'] ? '[目录]' : '[文件]') . " {$file['name']} 大小: {$file['size']} 修改时间: {$file['modified']}" . PHP_EOL;
}

$ftp->disconnect();

ftp_rawlist