【学无止境】关于通过PHP链接FTP或SFTP的问题及解决--FTP篇

前言

前段时间在做项目的时候，接到一个需求，就是链接别人的FTP服务器，从别人的服务器获取资源下载到自己的服务器上展示，我前期认真查阅了资料，其实链接FTP并不会太难，逼近链接FTP的函数PHP早有了，只是到后来给我FTP账号时，我才发现，对方服务器是用了ssh的SFTP链接，这样的话自带的PHP函数是无法完成链接的，至于如何链接和使用，接下来就让我们一起探究FTP和SFTP吧！

FTP

建立FTP链接资源

在开始使用FTP前我们要向服务器申请一个FTP的资源，就如同

fopen()

一样，我们要在栈堆里面保留一个资源，这点用我们PHP自带函数就能解决

ftp_connect（）

注意：FTP函数php早有集成，不需要下载扩展了，但是你也要确保你有开扩展，请用

phpinfo（）

验证一下

ftp_connect(host,port,timeout)

若成功，则返回一个连接标识，否则返回 false。

参数	描述
host	必需。规定要连接的 FTP 服务器。可以是域名或 IP 地址。后面不应以斜线结尾，前面也不需要用 ftp:// 开头。
port	可选。规定 FTP 服务器的端口。默认是21。
timeout	可选。规定该 FTP 服务器的超时时间。默认是 90 秒。

我们先用

ftp_connect()

申请资源。

<?php
$conn = ftp_connect("ftp.testftp.com") or die("不能连接");
?>

如果成功产生资源会返回一个id，否则就检查一下自己的地址是否写错，端口是否是21，22端口是SFTP连接。

资源申请到手，我们进行登录。

注意：FTP的特性就是必须要登录，如果只是想拿到域名一个公开权限的文件的话，建议是用文档流来拿。

ftp_login(ftp_connection,username,password)

ftp_login() 函数登录 FTP 服务器。

若成功则返回 true，失败则返回 false 并发出一个警告。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
username	必需。规定用于登录的用户名。
password	必需。规定用于登录的密码。

登录到ftp服务器

ftp_login($conn,"admin","1");

至此ftp上的资源已经建立好连接，可以直接操作了。

使用FTP资源，下载，上传，更名，删除。

下载 ftp_get(ftp_connection,local,remote,mode,resume)

从 FTP 服务器上下载一个文件。

若成功则返回 true，失败则返回 false。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
local	必需。规定本地文件。
remote	必需。规定从中进行拷贝的文件的路径。
mode	必需。规定传输模式。可能的值有：FTP_ASCII(文本模式),FTP_BINARY(二进制模式)
resume	必需。规定在远程文件中的何处开始拷贝。默认是 0。

注意：最后这个参数是要带上的！！

上传 ftp_put(ftp_connection,remote,local,mode,resume)

把文件上传到服务器。

若成功则返回 true，失败则返回 false。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
remote	必需。上传到服务器上的文件名。
local	必需。规定要上传的本地文件的路径。
mode	必需。规定传输模式。可能的值有：FTP_ASCII(文本模式),FTP_BINARY(二进制模式)
resume	必需。规定在远程文件中的何处开始拷贝。默认是 0。

更名 ftp_rename(ftp_connection,from,to)

更改 FTP 服务器上的文件或目录名。

如果成功，则返回 true，否则返回 false。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
from	必需。规定要改名的文件或目录。
to	必需。规定文件或目录的新名称。

注意：不管是文件或者目录都是要带绝对路径的

删除 ftp_delete(ftp_connection,path)

删除 FTP 服务器上的一个文件。

若成功，则返回 true，否则返回 false。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
path	必需。规定要删除的文件的路径。

一个问题：很多同学有这样的问题，可以从ftp软件上打开的文件，用php就是下不下来，这个问题其实和ftp的主动被动性有关

被动模式 ftp_pasv(ftp_connection,mode)

在被动模式中，数据连接是由客户机来初始化的，而不是服务器。这在客户机位于防火墙之后时比较有用。

参数	描述
ftp_connection	必需。规定要使用的 FTP 连接（FTP 连接的标识符）。
mode	必需。规定模式。

说明：

如果参数 mode 为真，打开被动模式传输 (PASV MODE) ，否则，如果参数 mode 为假，则关闭被动传输模式。在被动模式打开
4000
的情况下，数据的传送由客户机启动，而不是由服务器开始。

关于一个FTP的操作类

分享这个操作类给大家

class Ftp {

private $hostname   = '';
private $username   = '';
private $password   = '';
private $port       = 21;
private $passive    = TRUE;
private $debug      = TRUE;
private $conn_id    = FALSE;

/**
* 构造函数
*
* @param   array   配置数组 : $config = array('hostname'=>'','username'=>'','password'=>'','port'=>''...);
*/
public function __construct($config = array()) {
if(count($config) > 0) {
$this->_init($config);
}
}

/**
* FTP连接
*
* @access  public
* @param   array   配置数组
* @return  boolean
*/
public function connect($config = array()) {
if(count($config) > 0) {
$this->_init($config);
}

if(FALSE === ($this->conn_id = @ftp_connect($this->hostname,$this->port))) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_connect");
}
return FALSE;
}

if( ! $this->_login()) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_login");
}
return FALSE;
}

if($this->passive === TRUE) {
ftp_pasv($this->conn_id, TRUE);
}

return TRUE;
}

/**
* 目录改变
*
* @access  public
* @param   string  目录标识(ftp)
* @param   boolean
* @return  boolean
*/
public function chgdir($path = '', $supress_debug = FALSE) {
if($path == '' OR ! $this->_isconn()) {
return FALSE;
}

$result = @ftp_chdir($this->conn_id, $path);

if($result === FALSE) {
if($this->debug === TRUE AND $supress_debug == FALSE) {
$this->_error("ftp_unable_to_chgdir:dir[".$path."]");
}
return FALSE;
}

return TRUE;
}

/**
* 目录生成
*
* @access  public
* @param   string  目录标识(ftp)
* @param   int     文件权限列表
* @return  boolean
*/
public function mkdir($path = '', $permissions = NULL) {
if($path == '' OR ! $this->_isconn()) {
return FALSE;
}

$result = @ftp_mkdir($this->conn_id, $path);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_mkdir:dir[".$path."]");
}
return FALSE;
}

if( ! is_null($permissions)) {
$this->chmod($path,(int)$permissions);
}

return TRUE;
}

/**
* 上传
*
* @access  public
* @param   string  本地目录标识
* @param   string  远程目录标识(ftp)
* @param   string  上传模式 auto || ascii
* @param   int     上传后的文件权限列表
* @return  boolean
*/
public function upload($localpath, $remotepath, $mode = 'auto', $permissions = NULL) {
if( ! $this->_isconn()) {
return FALSE;
}

if( ! file_exists($localpath)) {
if($this->debug === TRUE) {
$this->_error("ftp_no_source_file:".$localpath);
}
return FALSE;
}

if($mode == 'auto') {
$ext = $this->_getext($localpath);
$mode = $this->_settype($ext);
}

$mode = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;

$result = @ftp_put($this->conn_id, $remotepath, $localpath, $mode);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_upload:localpath[".$localpath."]/remotepath[".$remotepath."]");
}
return FALSE;
}

if( ! is_null($permissions)) {
$this->chmod($remotepath,(int)$permissions);
}

return TRUE;
}

/**
* 下载
*
* @access  public
* @param   string  远程目录标识(ftp)
* @param   string  本地目录标识
* @param   string  下载模式 auto || ascii
* @return  boolean
*/
public function download($remotepath, $localpath, $mode = 'auto') {
if( ! $this->_isconn()) {
return FALSE;
}

if($mode == 'auto') {
$ext = $this->_getext($remotepath);
$mode = $this->_settype($ext);
}

$mode = ($mode == 'ascii') ? FTP_ASCII : FTP_BINARY;

$result = @ftp_get($this->conn_id, $localpath, $remotepath, $mode);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_download:localpath[".$localpath."]-remotepath[".$remotepath."]");
}
return FALSE;
}

return TRUE;
}

/**
* 重命名/移动
*
* @access  public
* @param   string  远程目录标识(ftp)
* @param   string  新目录标识
* @param   boolean 判断是重命名(FALSE)还是移动(TRUE)
* @return  boolean
*/
public function rename($oldname, $newname, $move = FALSE) {
if( ! $this->_isconn()) {
return FALSE;
}

$result = @ftp_rename($this->conn_id, $oldname, $newname);

if($result === FALSE) {
if($this->debug === TRUE) {
$msg = ($move == FALSE) ? "ftp_unable_to_rename" : "ftp_unable_to_move";
$this->_error($msg);
}
return FALSE;
}

return TRUE;
}

/**
* 删除文件
*
* @access  public
* @param   string  文件标识(ftp)
* @return  boolean
*/
public function delete_file($file) {
if( ! $this->_isconn()) {
return FALSE;
}

$result = @ftp_delete($this->conn_id, $file);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_delete_file:file[".$file."]");
}
return FALSE;
}

return TRUE;
}

/**
* 删除文件夹
*
* @access  public
* @param   string  目录标识(ftp)
* @return  boolean
*/
public function delete_dir($path) {
if( ! $this->_isconn()) {
return FALSE;
}

//对目录宏的'/'字符添加反斜杠'\'
$path = preg_replace("/(.+?)\/*$/", "\\1/", $path);

//获取目录文件列表
$filelist = $this->filelist($path);

if($filelist !== FALSE AND count($filelist) > 0) {
foreach($filelist as $item) {
//如果我们无法删除,那么就可能是一个文件夹
//所以我们递归调用delete_dir()
if( ! @delete_file($item)) {
$this->delete_dir($item);
}
}
}

//删除文件夹(空文件夹)
$result = @ftp_rmdir($this->conn_id, $path);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_delete_dir:dir[".$path."]");
}
return FALSE;
}

return TRUE;
}

/**
* 修改文件权限
*
* @access  public
* @param   string  目录标识(ftp)
* @return  boolean
*/
public function chmod($path, $perm) {
if( ! $this->_isconn()) {
return FALSE;
}

//只有在PHP5中才定义了修改权限的函数(ftp)
if( ! function_exists('ftp_chmod')) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_chmod(function)");
}
return FALSE;
}

$result = @ftp_chmod($this->conn_id, $perm, $path);

if($result === FALSE) {
if($this->debug === TRUE) {
$this->_error("ftp_unable_to_chmod:path[".$path."]-chmod[".$perm."]");
}
return FALSE;
}
return TRUE;
}

/**
* 获取目录文件列表
*
* @access  public
* @param   string  目录标识(ftp)
* @return  array
*/
public function filelist($path = '.') {
if( ! $this->_isconn()) {
return FALSE;
}

return ftp_nlist($this->conn_id, $path);
}

/**
* 关闭FTP
*
* @access  public
* @return  boolean
*/
public function close() {
if( ! $this->_isconn()) {
return FALSE;
}

return @ftp_close($this->conn_id);
}

/**
* FTP成员变量初始化
*
* @access  private
* @param   array   配置数组
* @return  void
*/
private function _init($config = array()) {
foreach($config as $key => $val) {
if(isset($this->$key)) {
$this->$key = $val;
}
}

//特殊字符过滤
$this->hostname = preg_replace('|.+?://|','',$this->hostname);
}

/**
* FTP登陆
*
* @access  private
* @return  boolean
*/
private function _login() {
return @ftp_login($this->conn_id, $this->username, $this->password);
}

/**
* 判断con_id
*
* @access  private
* @return  boolean
*/
private function _isconn() {
if( ! is_resource($this->conn_id)) {
if($this->debug === TRUE) {
$this->_error("ftp_no_connection");
}
return FALSE;
}
return TRUE;
}

/**
* 从文件名中获取后缀扩展
*
* @access  private
* @param   string  目录标识
* @return  string
*/
private function _getext($filename) {
if(FALSE === strpos($filename, '.')) {
return 'txt';
}

$extarr = explode('.', $filename);
return end($extarr);
}

/**
* 从后缀扩展定义FTP传输模式  ascii 或 binary
*
* @access  private
* @param   string  后缀扩展
* @return  string
*/
private function _settype($ext) {
$text_type = array (
'txt',
'text',
'php',
'phps',
'php4',
'js',
'css',
'htm',
'html',
'phtml',
'shtml',
'log',
'xml'
);

return (in_array($ext, $text_type)) ? 'ascii' : 'binary';
}

/**
* 错误日志记录
*
* @access  prvate
* @return  boolean
*/
private function _error($msg) {
return @file_put_contents('ftp_err.log', "date[".date("Y-m-d H:i:s")."]-hostname[".$this->hostname."]-username[".$this->username."]-password[".$this->password."]-msg[".$msg."]\n", FILE_APPEND);
}
}

可以加1577452412 一起讨论