[PHP学习教程 - 类库]002.FTP操作(FTP)

引言：FTP是大家上传至站点服务器必须要使用的协议。现在常用的FTP客户端工具也很多，如：8uftp，FlashFXP，...。但是使用客户端工具就无法真正与自动化联系起来。所以今天，我们为大家讲一下怎么用PHP使用FTP命令，实现文件的上传与下载。

导航索引：

• 概念
• FTP常用API
• FTP封装类
• 其他

大家请看下文。

概念

---

百科定义：

FTP 是File Transfer Protocol（文件传输协议）的英文简称，而中文简称为“文传协议”。用于Internet上的控制文件的双向传输。同时，它也是一个应用程序（Application）。 基于不同的操作系统有不同的FTP应用程序，而所有这些应用程序都遵守同一种协议以传输文件。在FTP的使用当中，用户经常遇到两个概念："下载" （Download）和"上传"（Upload）。"下载"文件就是从远程主机拷贝文件至自己的计算机上；"上传"文件就是将文件从自己的计算机中拷贝至远程主机上。用Internet语言来说，用户可通过客户机程序向（从）远程主机上传（下载）文件。

使用方式：

TCP/IP协议中，FTP标准命令TCP端口号为21，Port方式数据端口为20。FTP的任务是从一台计算机将文件传送到另一台计算机，不受操作系统的限制。

1．在本地电脑上登陆到国际互联网。

2．搜索有文件共享主机或者个人电脑(一般有专门的FTP服务器网站上公布的,上面有进入该主机或个人电脑的名称，口令和路径).

3．当与远程主机或者对方的个人电脑建立连接后,用对方提供的用户名和口令登陆到该主机或对方的个人电脑。

4．在远程主机或对方的个人电脑登陆成功后，就可以上传你想跟别人分享的东西或者下载别人授权共享的东西(这里的东西是指能放到电脑里去又能在显示屏上看到的东西).

5．完成工作后关闭FTP下载软件,切断连接。

更多介绍请跳转至百科。

 

FTP常用API

---

函数API很多，我们直接上代码：

<?php
// 连接FTP服务器
$conn = ftp_connect("ftp.server.com");

// 使用“账号”和“密码”登录
ftp_login($conn, "ac", "superdo");

// 获取远端系统类型
ftp_systype($conn);

// 列出文件清单
$filelist = ftp_nlist($conn, ".");

// 下载文件
ftp_get($conn, "data.zip", "data.zip", FTP_BINARY);

// 关闭连接
ftp_quit($conn);

// 说明：初结化一个FTP联接，PHP提供了ftp_connect()这个函数，它使用主机名称和端口作为参数。在上面的例子里，主机名字为 "ftp.server.com"；如果端口没指定，PHP将会使用"21"作为缺省端口来建立联接。

// 联接成功后ftp_connect()传回一个handle句柄；这个handle将被以后使用的FTP函数使用。
$conn = ftp_connect("ftp.server.com");

// 一旦建立联接，使用ftp_login()发送一个用户名称和用户密码。你可以看到，这个函数ftp_login()使用了 ftp_connect()函数传来的handle，以确定用户名和密码能被提交到正确的服务器。
ftp_login($conn, "ac", "superdo");

// 关闭连接
ftp_quit($conn);

// 登录了FTP服务器，PHP提供了一些函数，它们能获取一些关于系统和文件以及目录的信息。
ftp_pwd()

// 获取当前所在的目录
$here = ftp_pwd($conn);

// 获取服务器端系统信息ftp_systype()
$server_os = ftp_systype($conn);

// 被动模式（PASV）的开关，打开或关闭PASV（1表示开）
ftp_pasv($conn, 1);

// 进入目录中用ftp_chdir()函数，它接受一个目录名作为参数。
ftp_chdir($conn, "public_html");

// 回到所在的目录父目录用ftp_cdup()实现
ftp_cdup($conn);

// 建立或移动一个目录，这要使用ftp_mkdir()和ftp_rmdir()函数；注意：ftp_mkdir()建立成功的话，就会返回新建立的目录名。
ftp_mkdir($conn, "test");
ftp_rmdir($conn, "test");

// 上传文件，ftp_put()函数能很好的胜任，它需要你指定一个本地文件名，上传后的文件名以及传输的类型。比方说：如果你想上传 "abc.txt"这个文件，上传后命名为"xyz.txt"，命令应该是这样：
ftp_put($conn, "xyz.txt", "abc.txt", FTP_ASCII);

// 下载文件：PHP所提供的函数是ftp_get()，它也需要一个服务器上文件名，下载后的文件名，以及传输类型作为参数，例如：服务器端文件为his.zip，你想下载至本地机，并命名为hers.zip，命令如下：
ftp_get($conn, "hers.zip", "his.zip", FTP_BINARY);

// 说明：PHP提供两种方法：一种是简单列示文件名和目录，另一种就是详细的列示文件的大小，权限，创立时间等信息。

// 第一种使用ftp_nlist()函数，第二种用ftp_rawlist().两种函数都需要一个目录名做为参数，都返回目录列做为一个数组，数组的每一个元素相当于列表的一行。
$filelist = ftp_nlist($conn, ".");

// 函数ftp_size()，它返回你所指定的文件的大小，使用BITES作为单位。要指出的是，如果它返回的是 "-1"的话，意味着这是一个目录
$filelist = ftp_size($conn, "data.zip");

FTP封装类

---

直接上高清无MSK的工具类：

<?php
// +----------------------------------------------------------------------
// | Tool.Pub [ All tools in it! ]
// +----------------------------------------------------------------------
// | Copyright (c) 2015 http://www.tool.pub All rights reserved.
// +----------------------------------------------------------------------
// | Author: AC.Cai <c1985@vip.qq.com> <http://do.org.cn>
// +----------------------------------------------------------------------
/**
 * FTP工具类
 */
class FTP
{
    public $off;                          // 返回操作状态(成功/失败)
    public $conn_id;                      // FTP连接

    /**
     * 方法：FTP连接
     *
     * @FTP_HOST -- FTP主机
     * @FTP_PORT -- 端口
     * @FTP_USER -- 用户名
     * @FTP_PASS -- 密码
     */
    public function __construct($FTP_HOST,$FTP_PORT,$FTP_USER,$FTP_PASS)
    {
        $this->conn_id = @ftp_connect($FTP_HOST, $FTP_PORT) or die("FTP服务器连接失败");
        @ftp_login($this->conn_id, $FTP_USER, $FTP_PASS) or die("FTP服务器登陆失败");
        @ftp_pasv($this->conn_id, 1); // 打开被动模拟
    }

    /**
     * 方法：上传文件
     *
     * @path    -- 本地路径
     * @newpath -- 上传路径
     * @type    -- 若目标目录不存在则新建
     */
    public function up_file($path, $newpath, $type = true)
    {
        if ($type)
        {
            $this->dir_mkdirs($newpath);
        }
        $this->off = @ftp_put($this->conn_id, $newpath, $path, FTP_BINARY);
        if (!$this->off)
        {
            echo "文件上传失败,请检查权限及路径是否正确！";
        }
    }

    /**
     * 方法：移动文件
     *
     * @path    -- 原路径
     * @newpath -- 新路径
     * @type    -- 若目标目录不存在则新建
     */
    public function move_file($path, $newpath, $type = true)
    {
        if ($type)
        {
            $this->dir_mkdirs($newpath);
        }
        $this->off = @ftp_rename($this->conn_id, $path, $newpath);
        if (!$this->off)
        {
            echo "文件移动失败,请检查权限及原路径是否正确！";
        }
    }

    /**
     * 方法：复制文件
     * 说明：由于FTP无复制命令,本方法变通操作为：下载后再上传到新的路径
     *
     * @path    -- 原路径
     * @newpath -- 新路径
     * @type    -- 若目标目录不存在则新建
     */
    public function copy_file($path, $newpath, $type = true)
    {
        $downpath = "c:/tmp.dat";
        $this->off = @ftp_get($this->conn_id, $downpath, $path, FTP_BINARY);// 下载
        if (!$this->off)
        {
            echo "文件复制失败,请检查权限及原路径是否正确！";
        }
        $this->up_file($downpath, $newpath, $type);
    }

    /**
     * 方法：删除文件
     *
     * @path -- 路径
     */
    public function del_file($path)
    {
        $this->off = @ftp_delete($this->conn_id, $path);
        if (!$this->off)
        {
            echo "文件删除失败,请检查权限及路径是否正确！";
        }
    }

    /**
     * 方法：生成目录
     * @path -- 路径
     */
    public function dir_mkdirs($path)
    {
        $path_arr = explode('/', $path);                  // 取目录数组
        $file_name = array_pop($path_arr);                // 弹出文件名
        $path_div = count($path_arr);                    // 取层数

        foreach ($path_arr as $val)                        // 创建目录
        {
            if (@ftp_chdir($this->conn_id, $val) == FALSE)
            {
                $tmp = @ftp_mkdir($this->conn_id, $val);
                if ($tmp == FALSE)
                {
                    echo "目录创建失败,请检查权限及路径是否正确！";
                    exit;
                }
                @ftp_chdir($this->conn_id, $val);
            }
        }

        for ($i = 1; $i <= $path_div; $i++)               // 回退到根
        {
            @ftp_cdup($this->conn_id);
        }
    }

    /**
     * 方法：关闭FTP连接
     */
    public function close()
    {
        @ftp_close($this->conn_id);
    }
}
// class class_ftp end

示例1：

$ftp = new FTP('127.0.0.1', 21, 'ac','superdo');           // 打开FTP连接
$ftp->up_file('h.wav', 'xxoo/h.wav');                      // 上传文件
// $ftp->move_file('h/h.php','h.php');                     // 移动文件
// $ftp->copy_file('h.php','h/h.php');                     // 复制文件
// $ftp->del_file('h.php');                                // 删除文件
$ftp->close();                                             // 关闭FTP连接

其他

---

功能说明：

　　PHP用FTP函数创建目录

函数说明：

　　只是抛砖引玉供大家参 考学习,做网站时考虑前后台分离,可以使用这种文法,直接把静态页生成到另一台服务器上使用。

<?php
// create directory through FTP connection
function ftpMkdir($path, $newDir)
{
    $server = 'ftp.yourserver.com'; // ftp server
    $connection = ftp_connect($server); // connection

    // login to ftp server
    $user = "me";
    $pass = "password";
    $result = ftp_login($connection, $user, $pass);

    // check if connection was made
    if ((!$connection) || (!$result))
    {
        return false;
        exit();
    }
    else
    {
        ftp_chdir($connection, $path); // go to destination dir
        if (ftp_mkdir($connection, $newDir)) // create directory
        {
            return $newDir;
        }
        else
        {
            return false;
        }
        ftp_close($conn_id); // close connection
    }
}

结束语

---

FTP虽然古老，但是的确是一个好东西，近几个月我们在利用shell及python做框架及工具环境的自动化同步，出包(ios/and/win)。传输途径主要是借助于shell，大家知道，shell是无法在windows机器上直接运行的，需要借助其他的容器，也就是要借尸还魂。不利于屏蔽操作系统来操作，也就是不能做到全兼容，无奈之下，之前的几个月购了一台Mac Pro，其实现在回头想想，如果当时有想到FTP来解决，Mac Pro就不用买了，经验之谈，发发牢骚！谢谢大家的观看。

未完，待更新...

本站文章为宝宝巴士 SD.Team原创，转载务必在明显处注明：（作者官方网站：宝宝巴士) 
转载自【宝宝巴士SuperDo团队】 原文链接: http://www.cnblogs.com/superdo/p/4825137.html