首页 » PHP和MySQL Web开发(原书第4版) » PHP和MySQL Web开发(原书第4版)全文在线阅读

《PHP和MySQL Web开发(原书第4版)》20.5 备份或镜像一个文件

关灯直达底部

文件传输协议(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连接的句柄传递给此函数。