php phpseclib搞定SFTP文件上传下载，原来可以这么简单！

发布日期： 2025-10-08 阅读量： 作者： admin

得，今天说说我捣鼓 phpseclib 这玩意儿的经历。前阵子接了个活儿，要跟一个第三方商家对接，他们那边要求用 SFTP 传文件，给了个服务器地址、用户名、密码啥的，让咱们把生成的文件传到他们指定的目录，还得从他们那儿下载些对账文件回来。

一开始有点懵

之前对 PHP 直接操作 SFTP 这块儿接触不多。第一反应是，PHP 有没有自带的函数能搞定？查了下，好像有是有，但是依赖一些 PHP 扩展，比如那个 `ssh2` 扩展。我看了看我的开发环境和服务器，默认都没装这个扩展。要去服务器上装扩展，有时候挺麻烦的，得编译，还得看服务器环境允不允许，万一搞坏了啥就不好了。我就想着，有没有更省事儿的法子。

找到 phpseclib

后来搜了一圈，发现了 phpseclib 这个库。看介绍说它是纯 PHP 实现的，不需要装任何额外的 PHP 扩展，直接用 Composer 装上就能用。这听起来靠谱多了，纯 PHP 代码，兼容性应该好不少，部署也方便。当下就决定试试它。

开始动手搞

第一步，那肯定是安装了。我项目里用了 Composer，这事儿就简单了，直接在项目根目录下敲命令：

composer require phpseclib/phpseclib

看着它跑完，依赖装好了，心里踏实了一半。

尝试连接

接下来就是写代码了。我先找了个地方写测试代码，主要是试试连接能不能通。照着文档，大概是这么个路子：

先 `use` 引入那个 SFTP 类，好像是 `phpseclib3\Net\SFTP` 这么个路径。
然后 `new SFTP('对方服务器地址', 端口号)`，端口号对方没特殊说的话，默认就是 22。我这边对接的商家给的是默认的，所以就没写端口。
接着就是登录了，用 `login('用户名', '密码')` 这个方法。

我把商家给我的地址、用户名、密码填进去，跑了一下。第一次还真没连上，报了个错。我仔细看了看，发现是服务器地址填错了，少了个字母... 改正了再试，通了！没报错，说明连接和登录都成功了。

上传和下载文件

连接没问题了，下面就是核心功能：传文件和下文件。

上传： 我本地先准备了一个测试文件，比如叫 `*`。然后用 `put()` 这个方法。用法大概是 `put('远程服务器上的路径/文件名', '本地文件的路径')`。比如我要上传到对方服务器的 `/upload/` 目录下，文件名还叫 `*`，本地文件就在当前目录下，那差不多就是 `$sftp->put('/upload/*', '*')`。试了一下，返回了 `true`，我去 SFTP 工具里看了下，文件确实传上去了。成功！
下载： 下载也类似，用的是 `get()` 方法。比如我要下载对方 `/download/` 目录下的 `*` 文件，保存到我本地的 `downloads` 文件夹里，那就是 `$sftp->get('/download/*', 'downloads/*')`。也试了下，文件顺利下载回来了。搞定！

其他一些操作

在实际对接中，可能还需要些别的操作，我也顺便试了试：

列出目录里的文件：用了 `nlist()` 方法，能拿到一个文件名数组，挺方便。
判断文件或目录是否存在：有个 `file_exists()` 方法，跟 PHP 自带的函数名差不多，用起来很顺手。
切换目录：`cd()` 方法，跟 Linux 命令一样。

这些基本都试了下，跑起来都没啥问题。

总的感觉

折腾下来，感觉 phpseclib 这库确实挺好用的。最大的优点就是不依赖 PHP 扩展，纯代码，用 Composer 管理起来特方便。对于我这种不想或者不能随便动服务器环境的人来说，简直是福音。代码写起来也还算直观，常用的 SFTP 操作都有对应的方法。这回对接商家的文件传输需求，靠它顺利搞定了。

以后再碰到这种 SFTP 的活儿，心里就有底了，直接上 phpseclib 就行了。分享给大家，要是你也遇到类似的需求，可以考虑试试看。

上一篇: SEO优化如何提升网站搜索排名？掌握这几点轻松搞定

php phpseclib搞定SFTP文件上传下载，原来可以这么简单！

随便看看