QT5使用QFtp的详细步骤

陈广荣 發表於 2026-1-5 09:03:11

<div id="navCategory"><h5 class="catalogue">目录</h5><ul class="first_class_ul"><li>1、QFtp编译</li><ul class="second_class_ul"><li>1.1 下载</li><li>1.2 修改</li><li>1.3 编译</li><li>1.4 部署</li><li>2.5 使用</li><ul class="third_class_ul"><li>客户端</li></ul></ul></ul></div><p class="maodian"></p><h2>1、QFtp编译</h2>
<p class="maodian"></p><h3>1.1 下载</h3>
<p>下载QFtp源码，https://github.com/qt/qtftp</p>
<div class="jb51code"><pre class="brush:bash;">git clone https://github.com/qt/qtftp.git
</pre></div>
<p class="maodian"></p><h3>1.2 修改</h3>
<p>打开qt工程，修改qftp.pro文件中框选的部分，修改为下图所示。修改qftp.h文件的qurlinfo.h头文件，改为下图，该头文件路径有问题</p>
<div class="jb51code"><pre class="brush:cpp;">CONFIG += static
CONFIG += shared
</pre></div>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032391.png" /></p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032358.png" /></p>
<p class="maodian"></p><h3>1.3 编译</h3>
<p>只构建src</p>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032385.png" /></p>
<p class="maodian"></p><h3>1.4 部署</h3>
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032342.png" /></p>
<ul><li>创建一个文件夹“qtftp”</li><li>复制“ bin、lib、include”文件夹至“qtftp”文件夹中</li><li>把源码 src中的头文件复制到 include 文件夹中<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032359.png" /></p>lib
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032343.png" /></p>include
<p style="text-align:center"><img alt="" src="https://img.jbzj.com/file_images/article/202601/2026010509032331.png" /></p></li></ul>
<p class="maodian"></p><h3>2.5 使用</h3>
<p>在.pro中添加组件，然后程序包含头文件就行。</p>
<div class="jb51code"><pre class="brush:cpp;"># QT += ftp

LIBS += $$XLDFLAGS\
            -L/usr/qtftp/lib -lQt5Ftp

INCLUDEPATH += /usr/qtftp/include
</pre></div>
<div class="jb51code"><pre class="brush:cpp;">#include <QFtp>
</pre></div>
<p class="maodian"></p><h4>客户端</h4>
<div class="jb51code"><pre class="brush:cpp;">#ifndef FTPMANAGER_H
#define FTPMANAGER_H

#include <QObject>
//#include <QFtp>
#include <QFile>
//#include <QUrlInfo>
#include <QTimer>
#include <QFileInfo>
#include "qftp.h"

class FtpManager : public QObject
{
Q_OBJECT

public:
explicit FtpManager(QObject *parent = nullptr);
void connectToHost(const QString& host, int port, const QString& user, const QString& pass);
void uploadFile(const QString& fileName);
void downloadFile(const QString& remoteFile, const QString& localFile);
void uploadFolder(const QString &localFolderPath, const QString &remoteFolderPath);
void deleteFile(const QString& fileName);
void listDirectory();
void DelayMsec(unsigned int msec);
signals:
void fileListUpdated(const QStringList& files);
void progressUpdated(int percent);
void statusUpdated(const QString& status);

private slots:
void ftpCommandStarted(int id);
void ftpCommandFinished(int id, bool error);
void ftpListInfo(const QUrlInfo& urlInfo);
void ftpDataTransferProgress(qint64 done, qint64 total);

private:
QFtp* m_ftp;
QStringList m_fileList;
QString m_currentLocalFile;
QFile* m_file;
QTimer* m_refreshTimer;
};

#endif // FTPMANAGER_H

</pre></div>
<div class="jb51code"><pre class="brush:cpp;">#include "ftpmanager.h"
#include <QMessageBox>
#include <QApplication>

FtpManager::FtpManager(QObject *parent)
: QObject(parent)
, m_ftp(new QFtp(this))
, m_file(nullptr)
, m_refreshTimer(new QTimer(this))
{
connect(m_ftp, &QFtp::commandStarted, this, &FtpManager::ftpCommandStarted);
connect(m_ftp, &QFtp::commandFinished, this, &FtpManager::ftpCommandFinished);
connect(m_ftp, &QFtp::listInfo, this, &FtpManager::ftpListInfo);
connect(m_ftp, &QFtp::dataTransferProgress, this, &FtpManager::ftpDataTransferProgress);

connect(m_refreshTimer, &QTimer::timeout, this, &FtpManager::listDirectory);
m_refreshTimer->setSingleShot(true);
}

void FtpManager::connectToHost(const QString& host, int port, const QString& user, const QString& pass)
{
emit statusUpdated("正在连接...");
m_ftp->connectToHost(host, port);
m_ftp->login(user, pass);
}

void FtpManager::uploadFile(const QString& fileName)
{
m_file = new QFile(fileName, this);
if (!m_file->open(QIODevice::ReadOnly)) {
   emit statusUpdated("无法打开文件");
   return;
}

QString remoteName = QFileInfo(fileName).fileName();
m_currentLocalFile = fileName;
emit statusUpdated(QString("正在上传: %1").arg(remoteName));
m_ftp->put(m_file, remoteName);
}

void FtpManager::uploadFolder(const QString &localFolderPath, const QString &remoteFolderPath) {
QDir dir(localFolderPath);
QFileInfoList entries = dir.entryInfoList(QDir::NoDotAndDotDot | QDir::Dirs | QDir::Files);
QString remoteEntryPath = remoteFolderPath + "/"+dir.dirName();
m_ftp->mkdir(remoteEntryPath);
DelayMsec(1000);
m_ftp->cd(remoteEntryPath);
DelayMsec(2000);

foreach (const QFileInfo &entryInfo, entries) {
   QString localEntryPath = entryInfo.absoluteFilePath();

   remoteEntryPath += "/" + entryInfo.fileName();
   if (entryInfo.isFile()) { // 如果是文件，则上传文件
         uploadFile(localEntryPath);
         DelayMsec(100);
      // QFile file(localEntryPath);
      // if (file.open(QIODevice::ReadOnly)) {
            // m_ftp->put(&file, remoteEntryPath); // 上传文件
            // DelayMsec(2000);

            // file.close();
      // }

   }
}

}

void FtpManager::downloadFile(const QString& remoteFile, const QString& localFile)
{
m_file = new QFile(localFile, this);
if (!m_file->open(QIODevice::WriteOnly)) {
   emit statusUpdated("无法创建本地文件");
   return;
}

m_currentLocalFile = localFile;
emit statusUpdated(QString("正在下载: %1").arg(remoteFile));
m_ftp->get(remoteFile, m_file);
}

void FtpManager::deleteFile(const QString& fileName)
{
emit statusUpdated(QString("正在删除: %1").arg(fileName));
m_ftp->remove(fileName);
}

void FtpManager::listDirectory()
{
m_fileList.clear();
m_ftp->list();
}

void FtpManager::ftpCommandStarted(int id)
{
Q_UNUSED(id);
}

void FtpManager::ftpCommandFinished(int id, bool error)
{
Q_UNUSED(id);

if (error) {
   emit statusUpdated(QString("错误: %1").arg(m_ftp->errorString()));
   if (m_file && m_file->isOpen()) {
         m_file->close();
         m_file->deleteLater();
         m_file = nullptr;
   }
   return;
}

switch (m_ftp->currentCommand()) {
case QFtp::ConnectToHost:
   emit statusUpdated("连接成功");
   m_ftp->list();
   break;
case QFtp::Login:
   emit statusUpdated("登录成功");
   m_ftp->list();
   break;
case QFtp::List:
   emit fileListUpdated(m_fileList);
   emit statusUpdated("目录列表更新完成");
   break;
case QFtp::Put:
   if (m_file) {
         m_file->close();
         m_file->deleteLater();
         m_file = nullptr;
   }
   emit statusUpdated("上传完成");
   m_refreshTimer->start(1000); // 延迟刷新
   break;
case QFtp::Get:
   if (m_file) {
         m_file->close();
         m_file->deleteLater();
         m_file = nullptr;
   }
   emit statusUpdated("下载完成");
   break;
case QFtp::Remove:
   emit statusUpdated("删除完成");
   m_refreshTimer->start(1000); // 延迟刷新
   break;
default:
   break;
}
}

void FtpManager::ftpListInfo(const QUrlInfo& urlInfo)
{
if (urlInfo.name() != "." && urlInfo.name() != "..") {
   QString item = urlInfo.name();
   if (urlInfo.isDir()) {
         item += "/";
   }
   m_fileList << item;
}
}

void FtpManager::ftpDataTransferProgress(qint64 done, qint64 total)
{
if (total > 0) {
   int percent = static_cast<int>((done * 100) / total);
   emit progressUpdated(percent);
}
}
void FtpManager::DelayMsec(unsigned int msec)
{
QEventLoop loop;
QTimer::singleShot(msec, &loop, SLOT(quit()));
loop.exec(); // 在这里会阻塞，直到QTimer超时退出循环

}

</pre></div>
<div class="jb51code"><pre class="brush:cpp;">#ifndef MAINWINDOW_H
#define MAINWINDOW_H

#include <QMainWindow>
#include <QLabel>
#include <QDockWidget>
#include <QMenu>
#include <QSystemTrayIcon>
#include <QStyle>

class MainWindow : public QMainWindow
{
Q_OBJECT

public:
MainWindow(QWidget *parent = nullptr);
~MainWindow();

protected:

private slots:

private:

};
#endif // MAINWINDOW_H

</pre></div>
<div class="jb51code"><pre class="brush:cpp;">#include "mainwindow.h"
#include <QWidget>
#include <QVBoxLayout>
#include <QHBoxLayout>
#include <QLabel>
#include <QLineEdit>
#include <QPushButton>
#include <QListWidget>
#include <QProgressBar>
#include <QFileDialog>
#include <QMessageBox>

#include "ftpmanager.h"

MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent)
{
   setWindowTitle("Qt5 QFtp客户端");
   resize(600, 500);

   // 创建FTP管理器
   FtpManager* ftpManager = new FtpManager(this);

   // 服务器设置区域
   QWidget* serverWidget = new QWidget(this);
   serverWidget->setFixedSize(500,50);

   QHBoxLayout* serverLayout = new QHBoxLayout(serverWidget);

   QLabel* hostLabel = new QLabel("主机:");
   QLineEdit* hostEdit = new QLineEdit("ftp.example.com");
   hostEdit->setObjectName("hostEdit");

   QLabel* portLabel = new QLabel("端口:");
   QLineEdit* portEdit = new QLineEdit("21");
   portEdit->setObjectName("portEdit");
   portEdit->setMaximumWidth(60);

   QLabel* userLabel = new QLabel("用户:");
   QLineEdit* userEdit = new QLineEdit("anonymous");
   userEdit->setObjectName("userEdit");

   QLabel* passLabel = new QLabel("密码:");
   QLineEdit* passEdit = new QLineEdit();
   passEdit->setObjectName("passEdit");
   passEdit->setEchoMode(QLineEdit::Password);

   QPushButton* connectBtn = new QPushButton("连接");
   connectBtn->setObjectName("connectBtn");

   serverLayout->addWidget(hostLabel);
   serverLayout->addWidget(hostEdit);
   serverLayout->addWidget(portLabel);
   serverLayout->addWidget(portEdit);
   serverLayout->addWidget(userLabel);
   serverLayout->addWidget(userEdit);
   serverLayout->addWidget(passLabel);
   serverLayout->addWidget(passEdit);
   serverLayout->addWidget(connectBtn);

   // 文件操作按钮
   QWidget* controlWidget = new QWidget(this);
   controlWidget->setFixedSize(500,50);
   controlWidget->move(0,45);
   QHBoxLayout* controlLayout = new QHBoxLayout(controlWidget);

   QPushButton* uploadBtn = new QPushButton("上传");
   uploadBtn->setObjectName("uploadBtn");
   QPushButton* downloadBtn = new QPushButton("下载");
   downloadBtn->setObjectName("downloadBtn");
   QPushButton* deleteBtn = new QPushButton("删除");
   deleteBtn->setObjectName("deleteBtn");
   QPushButton* refreshBtn = new QPushButton("刷新");
   refreshBtn->setObjectName("refreshBtn");

   controlLayout->addWidget(uploadBtn);
   controlLayout->addWidget(downloadBtn);
   controlLayout->addWidget(deleteBtn);
   controlLayout->addWidget(refreshBtn);
   controlLayout->addStretch();

   // 文件列表
   QListWidget* fileList = new QListWidget(this);
   fileList->setFixedSize(500,300);
   fileList->move(20,100);
   fileList->setObjectName("fileList");

   // 进度条
   QProgressBar* progressBar = new QProgressBar(this);
   progressBar->setObjectName("progressBar");
   progressBar->setVisible(false);

   // 状态标签
   QLabel* statusLabel = new QLabel("就绪",this);
   statusLabel->move(20,400);
   statusLabel->setObjectName("statusLabel");

   // 布局
   QVBoxLayout* mainLayout = new QVBoxLayout();
   mainLayout->addWidget(serverWidget);
   mainLayout->addWidget(controlWidget);
   mainLayout->addWidget(fileList);
   mainLayout->addWidget(progressBar);
   mainLayout->addWidget(statusLabel);

   this->setLayout(mainLayout);

   // 连接信号槽
   QObject::connect(connectBtn, &QPushButton::clicked, [=]() {
         QString host = hostEdit->text();
         int port = portEdit->text().toInt();
         QString user = userEdit->text();
         QString pass = passEdit->text();
         ftpManager->connectToHost(host, port, user, pass);
   });

   QObject::connect(uploadBtn, &QPushButton::clicked, [=]() {
         QString fileName = QFileDialog::getOpenFileName(this, "选择上传文件");
         if (!fileName.isEmpty()) {
            ftpManager->uploadFile(fileName);
         }
   });

   QObject::connect(downloadBtn, &QPushButton::clicked, [=]() {
         QListWidgetItem* item = fileList->currentItem();
         if (item) {
            QString fileName = item->text();
            QString savePath = QFileDialog::getSaveFileName(this, "保存文件", fileName);
            if (!savePath.isEmpty()) {
               ftpManager->downloadFile(fileName, savePath);
            }
         } else {
            QMessageBox::warning(this, "警告", "请选择要下载的文件");
         }
   });

   QObject::connect(deleteBtn, &QPushButton::clicked, [=]() {
         QListWidgetItem* item = fileList->currentItem();
         if (item) {
            QString fileName = item->text();
            int ret = QMessageBox::question(this, "确认", QString("确定删除文件 %1?").arg(fileName));
            if (ret == QMessageBox::Yes) {
               ftpManager->deleteFile(fileName);
            }
         } else {
            QMessageBox::warning(this, "警告", "请选择要删除的文件");
         }
   });

   QObject::connect(refreshBtn, &QPushButton::clicked, [=]() {
         ftpManager->listDirectory();
   });

   QObject::connect(ftpManager, &FtpManager::fileListUpdated, [=](const QStringList& files) {
         fileList->clear();
         fileList->addItems(files);
   });

   QObject::connect(ftpManager, &FtpManager::progressUpdated, [=](int percent) {
         progressBar->setVisible(true);
         progressBar->setValue(percent);
         if (percent >= 100) {
            QTimer::singleShot(1000, [=]() {
               progressBar->setVisible(false);
            });
         }
   });

   QObject::connect(ftpManager, &FtpManager::statusUpdated, [=](const QString& status) {
         statusLabel->setText(status);
   });

}

MainWindow::~MainWindow()
{
}

</pre></div>
<div class="jb51code"><pre class="brush:cpp;">#include <QApplication>
#include <QWidget>

#include "mainwindow.h"

int main(int argc, char *argv[])
{
QApplication app(argc, argv);

MainWindow mainWindow;

mainWindow.show();

return app.exec();
}

</pre></div>
<p>到此这篇关于QT5使用QFtp的详细步骤的文章就介绍到这了,更多相关QT5使用QFtp内容请搜索琼殿技术社区以前的文章或继续浏览下面的相关文章希望大家以后多多支持琼殿技术社区！</p>
<p></p>

                        <div class="art_xg">
                           <b>您可能感兴趣的文章:</b><ul><li>QT5编译使用QFtp的方法步骤</li></ul>
                        </div>

                     </div>

頁: [1]

琼殿技术论坛's Archiver

QT5使用QFtp的详细步骤