文件传输协议（FTP）是用来在网络主机之间传输文件的协议。就像使用HTTP连接一样，使用PHP，可以在FTP中使用fopen函数和其他不同的文件函数来连接一个FTP服务器，并在客户端和FTP服务器之间传送文件。但是，标准的PHP安装也提供了一整套专门适用于FTP的函数。
在默认情况下，这些函数并没有内置在PHP的标准安装中。要在UNIX下使用这些函数，必须运行带有--enable-ftp命令选项的configure程序，然后再次运行make文件。如果使用标准的Windows安装，FTP函数将被自动启用。（关于如何配置PHP的详细信息，请参阅附录A“安装PHP和MySQL”。）
20.5.1 使用FTP备份或镜像一个文件
对于从一台主机到另一台主机之间的文件移动和复制来说，FTP函数是非常有用的。FTP最常见的应用可能就是在另一个位置备份Web站点或者镜像文件。接下来，我们来了解一个使用FTP函数镜像文件的简单例子，如程序清单20-4所示。
程序清单20-4 ftp_mirror.php——一个从FTP服务器下载新版本文件的脚本
＜html＞
＜head＞
＜title＞Mirror update＜/title＞
＜/head＞
＜body＞
＜h1＞Mirror update＜/h1＞
＜?php
//set up variables-change these to suit application
$host=/'ftp.cs.rmit.edu.au/';
$user=/'anonymous/';
$password=/'[email protected]/';
$remotefile=/'/pub/tsg/teraterm/ttssh14.zip/';
$localfile=/'/tmp/writable/ttssh14.zip/';
//connect to host
$conn=ftp_connect($host);
if(!$conn)
{
echo/'Error:Could not connect to ftp server＜br/＞/';
exit;
}
echo/"Connected to$host.＜br/＞/";
//log in to host
[email protected]_login($conn,$user,$pass);
if(!$result)
{
echo/"Error:Could not log on as$user＜br/＞/";
ftp_quit($conn);
exit;
}
echo/"Logged in as$user＜br/＞/";
//check file times to see if an update is required
echo/'Checking file time...＜br/＞/';
if(file_exists($localfile))
{
$localtime=filemtime($localfile);
echo/'Local file last updated/';
echo date(/'G:i j-M-Y/',$localtime);
echo/'＜br/＞/';
}
else
$localtime=0;
$remotetime=ftp_mdtm($conn,$remotefile);
if(!($remotetime＞=0))
{
//This doesn/'t mean the file/'s not there,server may not support mod
time
echo/'Can/'t access remote file time.＜br/＞/';
$remotetime=$localtime+1;//make sure of an update
}
else
{
echo/'Remote file last updated/';
echo date(/'G:i j-M-Y/',$remotetime);
echo/'＜br/＞/';
}
if(!($remotetime＞$localtime))
{
echo/'Local copy is up to date.＜br/＞/';
exit;
}
//download file
echo/'Getting file from server...＜br/＞/';
$fp=fopen($localfile,/'w/');
if(!$success=ftp_fget($conn,$fp,$remotefile,FTP_BINARY))
{
echo/'Error:Could not download file/';
ftp_quit($conn);
exit;
}
fclose($fp);
echo/'File downloaded successfully/';
//close connection to host
ftp_quit($conn);
?＞
＜/body＞
＜/html＞
在特定情况下，运行以上脚本的输出结果如图20-4所示。
图 20-4 该FTP镜像脚本将检查文件的本地版本是否是最新版本，如果不是，就下载一个新的版本这是一个非常普通的脚本。可以看到，在此脚本的开始处设置了一些变量：
$host=/'ftp.cs.rmit.edu.au/';
$user=/'anonymous/';
$password=/'[email protected]/';
$remotefile=/'/pub/tsg/teraterm/ttssh14.zip/';
$localfile=/'/tmp/writable/ttssh14.zip/';
变量$host包含了即将连接的FTP服务器的名称，$user和$password对应于登录的用户名和密码。
许多FTP网站都支持匿名登录（anony-mous），匿名登录是指任何人都可以使用这个用户名来连接FTP服务器。匿名登录不需要密码，但通常的做法是把电子邮件作为密码，这样管理员能够知道用户来自什么地方。在这里，我们沿袭了这个惯例。
变量$remotefile包含我们将要下载的文件的路径。在这个例子中，我们要下载并镜像Tera Term SSH的一个本地拷贝，以及一个适用于Windows平台的SSH客户端（SSH表示安全Shell。它是Telnet的加密形式）。
变量$localfile包含了下载文件存储在机器上的本地路径。在这个例子中，我们创建了/tmp/writable目录，该目录的权限设置允许PHP对其执行写操作，也就是可以写入一个文件。无论操作系统是什么，必须创建这个目录，这样这个脚本才能正确运行。如果操作系统具有严格的权限机制，必须确认它们允许这个脚本执行写操作。我们应该能够根据需要修改这些变量和脚本。
该脚本的基本执行步骤与在命令行中手动使用FTP传输文件一样：
1.连接远程FTP服务器。
2.登录（通过用户名或匿名登录）。
3.检查远程文件是否已经更新。
4.如果更新过，下载此文件。
5.关闭FTP连接。
下面，让我们依次讨论这些步骤。
1.连接远程FTP服务器
这一步与在Windows或者UNIX平台的命令提示符下输入如下命令等价：
ftp hostname
在PHP中，通过如下所示代码完成此步骤：
$conn=ftp_connect($host);
if(!$conn)
{
echo/'Error:Could not connect to ftp server＜br/＞/';
exit;
}
echo/"Connected to$host.＜br/＞/";
在这里，我们调用的函数是ftp_connect。此函数以主机名作为参数并返回连接的句柄或者false（如果不能建立连接）。这个函数也能够以要连接的主机端口号作为可选的第二个参数（这里没有用到）。如果不指定一个端口号，此函数将使用默认值21（FTP的默认端口）。
2.登录到FTP服务器
下一步是使用一个使用特定用户名和密码登录到FTP服务器上。可以通过函数ftp_login来完成此步骤：
[email protected]_login($conn,$user,$pass);
if(!$result)
{
echo/"Error:Could not log on as$user＜br/＞/";
ftp_quit($conn);
exit;
}
echo/"Logged in as$user＜br/＞/";
这个函数需要3个参数：一个FTP连接句柄（通过函数ftp_connect获得）、用户名和密码。如果用户能够登录，此函数将返回true，如果不能登录，函数将返回false。注意我们在这一行的开始处放置一个“@”符号来抑制错误。这是因为如果用户不能登录，他将在浏览器窗口中获得一个PHP警告信息。通过测试$result变量的内容，可以捕获这个错误，并可以自己定制更多的、更友好的用户出错信息。
请注意，如果登录尝试失败，实际上将通过ftp_quit函数关闭FTP连接；稍后将详细介绍该函数。
3.检查文件更新时间
假设我们打算更新文件的本地副本，比较明智的做法是首先检查文件是否需要更新，因为如果文件是最新的，就无须重新下载此文件，特别是当它是一个很大的文件的时候。这将避免不必要的网络通信量。现在，让我们来查看实现检查文件更新时间的代码。
文件时间是我们使用FTP函数而不是其他更简单的文件函数的原因。文件函数可以很容易读，而且在某些情况下，也可以通过网络接口写文件，但是大多数状态函数，例如filemtime，无法执行远程操作。这一点将在以后发生变化。
要确定是否需要下载一个文件，可以通过函数file_exists确认一个文件的本地副本是否存在。如果没有，显然需要下载此文件。如果此文件存在，通过函数filemtime获得文件的最后修改时间，并把它存储在变量$localtime中。如果此文件不存在，设置变量$localtime为0，这样，此文件将会比任何可能的远程文件修改时间都要“老”。
echo/'Checking file time...＜br/＞/';
if(file_exists($localfile))
{
$localtime=filemtime($localfile);
echo/'Local file last updated/';
echo date(/'G:i j-M-Y/',$localtime);
echo/'＜br/＞/';
}
else
$localtime=0;
（在第2章“数据的存储与检索”和第19章“与文件系统和服务器的交互”中，我们已经分别介绍了函数file_exists和filemtime的使用）。
解决了本地时间的问题后，我们需要获得远程文件的修改时间。可以通过函数ftp_mdtm获得此信息，如下所示：
$remotetime=ftp_mdtm($conn,$remotefile);
这个函数带有两个参数（FTP连接句柄和远程文件的路径），并返回文件最后修改时间的UNIX时间戳或者-1（如果存在某种错误的话）。不是所有的FTP服务器都支持这种特性，因此通过这个函数可能得不到一个有用的结果。在这种情况下，可以选择手动设置，将变量$localtime加1，使变量$remotetime比$localtime“新”。这样，就可以确保能够下载文件，如下代码所示：
if(!($remotetime＞=0))
{
//This doesn/'t mean the file/'s not there,server may not support mod time
echo/'Can/'t access remote file time.＜br＞/';
$remotetime=$localtime+1;//make sure of an update
}
else
{
echo/'Remote file last updated/';
echo date(/'G:i j-M-Y/',$remotetime);
echo/'＜br＞/';
}
当我们拥有二者的时间时，就可以对它们进行比较，确认是否需要下载这个文件：
if(!($remotetime＞$localtime))
{
echo/'Local copy is up to date.＜br＞/';
exit;
}
4.下载文件
到这一步，我们就可以从服务器上下载文件。
echo/'Getting file from server...＜br＞/';
$fp=fopen($localfile,/'w/');
if(!$success=ftp_fget($conn,$fp,$remotefile,FTP_BINARY))
{
echo/'Error:Could not download file/';
fclose($fp);
ftp_quit($conn);
exit;
}
fclose($fp);
echo/'File downloaded successfully/';
正如我们在前面代码所见到的，我们通过函数fopen打开一个本地文件。在成功打开该文件后，调用函数ftp_fget，该函数将下载这个文件并存储到本地文件中。ftp_fget函数带有4个参数。前3个非常简单：FTP连接句柄、本地文件句柄和远程文件路径。第4个参数是FTP模式。
对于FTP传输，有两种模式：ASCII和二进制。ASCII模式用于传输文本文件（也就是说，文件全部由ASCII字符组成），二进制模式用于传输所有其他类型的文件。二进制模式在传输一个文件的过程中不会修改这个文件，而ASCII模式将回车换行字符转换成适用于系统的特定字符（在UNIX下为n，Windows下为rn，而Macintosh下为r）。
PHP的FTP库有两个预定义的常量，FTP_ASCII和FTP_BINARY，它们分别代表这两种模式。我们需要确定哪种模式适合文件，并将相应的常量作为第4个变量传给函数ftp_fget。在这个例子中，传输的是一个压缩文件，因此我们使用了FTP_BINARY模式。
如果所有的这些操作都是正常执行，ftp_fget函数将返回true；如果遇到错误，此函数将返回false。函数执行结果存储在变量$success中，这样用户可以知道此函数的运行情况。
在文件下载完成之后，需要调用函数fclose关闭本地文件。
除了ftp_fget函数外，还可以使用函数ftp_get来实现此目的，此函数具有如下所示的原型：
int ftp_get(int ftp_connection,string localfile_path,
string remotefile_path,int mode)
此函数在许多方面与函数ftp_fget相同，但是它不需要打开本地文件。传递给此函数的参数为本地文件的系统文件名而不是文件句柄。
请注意，PHP中还没有与FTP命令mget等价的函数，此命令能够一次下载多个文件。我们必须多次调用ftp_fget函数或者ftp_get函数来代替mget命令。
5.关闭连接
在完成FTP连接之后，应该通过函数ftp_quit来关闭此连接。
ftp_quit($conn);
你必须将FTP连接的句柄传递给此函数。