cnangel

管理员

Rank: 9 Rank: 9 Rank: 9

UID: 1
威望: 1240 点
金钱: 24019 金币
点卡: 317 点

1^#

打印

字体大小: tT

发表于 2005-8-25 20:26 | 只看该作者

PHP的FTP学习

PHP的FTP学习
作者：unknown 更新时间： 2005-03-17

我们是一群PHP的忠实FANS，我们因各种不同的原因使用它-WEB站点的开发，画图，数据库的联接等 -我们发现，它非常的友好，强大而且易于使用……
你可能已经看到PHP是怎样被用于创建GIF和JPEG图像，从数据库中动态的获取信息等等，但这只是冰山的一角---最新版本的PHP拥有着强大的文件传输功能。
在这篇教程里，我将向你展示FTP怎样通过HTTP和FTP联接来传输文件，同时也会有一些简单的程序代码，跟我来吧！
首先，你应该知道PHP是通过HTTP和FTP联接来传输文件的。通过HTTP上传文件早在PHP3中就已经出现，现在，新的FTP函数已经在新的PHP版本中出现了！
开始之前，你需要确信你的PHP支持FTP，你可以通过以下代码查知：

<?
phpinfo();
?>

复制代码

检查输出结果，有一“Additional Modules”区，这里列示了你的PHP支持的模块；如果你没发现FTP模块，你最好重新安装PHP，并添加FTP支持！
先让我们来看看一个典型的FTP任务是怎样完成的吧！

$ ftp ftp.server.com
Connected to ftp.server.com
220 server.com FTP server ready.
Name (server:john): john
331 Password required for john.
Password:
230 User john logged in.
Remote system type is UNIX.
Using binary mode to transfer files.
ftp> ls
200 PORT command successful.
150 Opening ASCII mode data connection for /bin/ls.
drwxr-xr-x 5 john users 3072 Nov 2 11:03 .
drwxr-xr-x 88 root root 2048 Nov 1 23:26 ..
drwxr--r-- 2 john users 1024 Oct 5 13:26 bin
drwx--x--x 8 john users 1024 Nov 2 10:59 public_html
drwxr--r-- 4 john users 1024 Nov 2 11:26 tmp
-rw-r--r-- 1 john users 2941465 Oct 9 17:21 data.zip
226 Transfer complete.
ftp> bin
200 Type set to I.
ftp> get data.zip
local: data.zip remote: data.zip
200 PORT command successful.
150 Opening BINARY mode data connection for data.zip(2941465 bytes).
226 Transfer complete.
ftp> bye
221 Goodbye.

你可以看到，进程明显被分为几段：联接（与FTP服务器建立联接）、验证（确定用户是否有权力进入系统）、传输（这里包括列目录，上传或下载文件）、取消联接。
使用PHP来FTP的步骤
建立一个PHP的FTP联接必须遵守以下基本步骤：打开一个联接 - 发出认证信息 - 使用PHP函数操纵目录和传输文件。
以下具体实现：

<?
// 联接FTP服务器
$conn = ftp_connect("ftp.server.com");
// 使用username和password登录
ftp_login($conn, "john", "doe");
// 获取远端系统类型
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函数使用。

<?
// connect to FTP server
$conn = ftp_connect("ftp.server.com");
?>

复制代码

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

<?
// log in with username and password
ftp_login($conn, "john", "doe");
?>

复制代码

这时，你就能够做你想做的事情了，具体在下一部分讲：
做完你想做的事后，千万要记住使用ftp_quit()函数关闭你的FTP联接

<?
// close connection
ftp_quit($conn);
?>

复制代码

登录了FTP服务器，PHP提供了一些函数，它们能获取一些关于系统和文件以及目录的信息。
ftp_pwd()
如果你想知道你当前所在的目录时，你就要用到这个函数了。

<?
// get current location
$here = ftp_pwd($conn);
?>

复制代码

万一你需要知道服务器端运行的是什么系统呢？
ftp_systype()正好提供给你这方面的信息。

<?
// get system type
$server_os = ftp_systype($conn);
?>

复制代码

关于被动模式（PASV）的开关，PHP也提供了这样一个函数，它能打开或关闭PASV（1表示开）

<?
// turn PASV on
ftp_pasv($conn, 1);
?>

复制代码

现在，你已经知道你在“哪里”和“谁”跟你在一起了吧，现在我们开始在目录中逛逛--实现这一功能的是ftp_chdir()函数，它接受一个目录名作为参数。

<?
// change directory to "public_html"
ftp_chdir($conn, "public_html");
?>

复制代码

如果你想回到你刚才所在的目录（父目录），ftp_cdup()能帮你实现你的愿望，这个函数能回到上一级目录。

<?
// go up one level in the directory tree
ftp_cdup($conn);
?>

复制代码

你也能够建立或移动一个目录，这要使用ftp_mkdir()和ftp_rmdir()函数；注意：ftp_mkdir()建立成功的话，就会返回新建立的目录名。

<?
// make the directory "test"
ftp_mkdir($conn, "test");
// remove the directory "test"
ftp_rmdir($conn, "test");
?>

复制代码

建立一个FTP的目录通常是传输文件--- 那么就让我们开始吧！
先是上传文件，ftp_put()函数能很好的胜任这一职责，它需要你指定一个本地文件名，上传后的文件名以及传输的类型。比方说：如果你想上传“abc.txt”这个文件，上传后命名为“xyz.txt”，命令应该是这样：

<?
// upload
ftp_put($conn, "xyz.txt", "abc.txt", FTP_ASCII);
?>

复制代码

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

<?
// download
ftp_get($conn, "hers.zip", "his.zip", FTP_BINARY);
?>

复制代码

PHP定义了两种模式作为传输模式 FTP_BINARY 和 FTP_ASCII ，这两种模式的使用请看上两例，至于其详细解释，本文也不多说了，具体请参看相关书籍。

我该怎样列示文件呢？（用DIR？：））
PHP提供两种方法：一种是简单列示文件名和目录，另一种就是详细的列示文件的大小，权限，创立时间等信息。
第一种使用ftp_nlist()函数，第二种用ftp_rawlist().两种函数都需要一个目录名做为参数，都返回目录列做为一个数组，数组的每一个元素相当于列表的一行。

<?
// obtain file listing
$filelist = ftp_nlist($conn, ".");
?>

复制代码

你一定想知道文件的大小吧！别急，这里有一个非常容易的函数ftp_size()，它返回你所指定的文件的大小，使用BITES作为单位。要指出的是，如果它返回的是 “-1”的话，意味着这是一个目录，在随后的例子中，你将会看到这一功能的应用。

<?
// obtain file size of file "data.zip"
$filelist = ftp_size($conn, "data.zip");
?>

复制代码

现在，我们已经接触了PHP关于FTP的大量函数，但这仅仅只是函数，离我们的目标还远远不够，要显示出这些函数的真正力量，我们应该建立一个程序，这个程序能以WEB方式上传，下载文件---这就是我们将要做的！
在我们进入代码前，我想要告诉大家的是，这个例子仅仅只是为了向大家解释PHP的各种FTP函数的使用，很多方面还不够完善，比如说，错误分析等，至于你想应用到你自己的程序中，你应该进行一些修改！
程序包括以下几个文件：
index.html - 登录文件
actions.php - 程序必需的FTP代码
include.php - 程序主界面，它显示文件列表和控制按钮。
让我们从 "index.html"开始吧:

<table border=0 align=center>
<form action="actions.php" method=post>
<input type=hidden name=action value=CWD>
<tr>
<td>
Server
</td>
<td>
<input type=text name=server>
</td>
</tr>
<tr>
<td>
User
</td>
<td>
<input type=text name=username>
</td>
</tr>
<tr>
<td>
Password
</td>
<td>
<input type=password name=password>
</td>
</tr>
<tr>
<td colspan=2 align=center>
<input type="submit" value="Beam Me Up, Scotty!">
</td>
</tr>
</form>
</table>

复制代码

这是一个登录表单，有一个服务器名称、用户名、密码，输入框。输入的变量将会被存到$server, $username 和 $password 变量中，表单提交后，调用actions.php，它将初始化FTP联接。
注意那个“hidden” 它传给action.php一个变量$action ，值为CWD。

这是action.php文件的源码：

<html>
<head>
<basefont face=Arial>
</head>
<body>
<?
//检查表单传来的数据，不全则报错，要想程序完善的话，这里应该有更全的输入检测功能
if (!$server || !$username || !$password)
{
echo "提交数据不全!";
}
else
{
// keep reading
}
?>
</body>
</html>

复制代码

接下来是变量 "actions". 程序允许以下的action：
"action=CWD"
改变工作目录
"action=Delete"
删除指定文件
"action=Download"
下载指定文件
"action=Upload"
上传指定文件
如果你仔细检查文件include.php，在里面包括一个HTML界面，你将会看到，它包括许多表单，每一个指向一个特定的功能，每一个表单包含一个field（通常隐藏），当表单提交，相应的功能将被执行。
例如：按下“删除”，"action=Delete"就被传送给"actions.php"
为了操作这四个功能，actions.php中代码如下：

<?
// action: 改变目录
if ($action == "CWD")
{
// 具体代码
}
// action: 删除文件
else if ($action == "Delete")
{
// 具体代码
}
// action: 下载文件
else if ($action == "Download")
{
// 具体代码
}
// action: 上传文件
else if ($action == "Upload")
{
// 具体代码
}
?>

复制代码

以上的具体代码将会实现指定的功能，并退出循环，它们都包含以下步骤：

通过定制的函数联接并登录FTP服务器
connect();
转向适当的目录
执行选择的功能
刷新列表，以察看改变的结果
通过include("include.php")，显示文件列表和控制按钮
关闭联接

注意:
以下功能支持多文件操作- 即 "action=Delete" 和 "action=Download" 它们使用FOR循环来实现。
变量$cdir 和 $here 将在每一阶段实时更新。
现在终于到了我们的第三个文件，include.php 它为程序建立起一个用户界面。
"include.php" 包含三个表单，一些PHP代码获取当前的目录列表并将它们存入三个变量
$files (包括当前目录下的文件）,
$file_sizes (相应的文件大小),
and $dirs (包含子目录名)
第一个表单使用$dirs 产生一个下拉式目录列表，对应于“action=CWD”。
第二个表单使用$files $file_sizes创建一个可用的文件列表，每一个文件使用一个checkbox。这个表单的action对应于"action=Delete" and "action=Download"
第三个表单用来上传一个文件到FTP站点，如下：

<form enctype="multipart/form-data" action=actions.php4 method=post>
...
<input type=file name=upfile>
...
</form>

复制代码

当PHP以这种方式接收到一个文件名，一些变量就产生了，这些变量指定文件的大小，一个临时的文件名以及文件的类型，最初的文件名存在$upfile_name，一旦上传后文件名便存入$upfile中（这个变量是由PHP自己创建的）
通过这些信息，我们就可以创建以下的语句了：

ftp_put($result, $upfile_name, $upfile, FTP_BINARY);

复制代码

以下是代码列表：

<html>
<head>
<basefont face=arial>
</head>
<body>
<table border=0 align=center>
<form action="actions.php" method=post>
<input type=hidden name=action value=CWD>
<tr>
<td>
Server
</td>
<td>
<input type=text name=server>
</td>
</tr>
<tr>
<td>
User
</td>
<td>
<input type=text name=username>
</td>
</tr>
<tr>
<td>
Password
</td>
<td>
<input type=password name=password>
</td>
</tr>
<tr>
<td colspan=2 align=center>
<input type="submit" value="Beam Me Up, Scotty!">
</td>
</tr>
</form>
</table>
</body>
</html>

复制代码

<html>
<head>
<basefont face=Arial>
</head>
<body>
<?
/*
DISCLAIMER:
This is use-at-your-own-risk code.
It is meant only for illustrative purposes and is not meant for production environments. No warranties of any kind are provided to the user.
You have been warned!
*/
// function to connect to FTP server
function connect()
{
global $server, $username, $password;
$conn = ftp_connect($server);
ftp_login($conn, $username, $password);
return $conn;
}
// main program begins
// check for valid form entries else print error
if (!$server || !$username || !$password)
{
echo "Form data incomplete!";
}
else
{
// connect
$result = connect();
// action: change directory
if ($action == "CWD")
{
// at initial stage $rdir does not exist
// so assume default directory
if (!$rdir)
{
$path = ".";
}
// get current location $cdir and add it to requested directory $rdir
else
{
$path = $cdir . "/" . $rdir;
}
// change to requested directory
ftp_chdir($result, $path);
}
// action: delete file(s)
else if ($action == "Delete")
{
ftp_chdir($result, $cdir);
// loop through selected files and delete
for ($x=0; $x<sizeof($dfile); $x++)
{
ftp_delete($result, $cdir . "/" . $dfile[$x]);
}
}
// action: download files
else if ($action == "Download")
{
ftp_chdir($result, $cdir);
// download selected files
// IMPORTANT: you should specify a different download location here!!
for ($x=0; $x<sizeof($dfile); $x++)
{
ftp_get($result, $dfile[$x], $dfile[$x], FTP_BINARY);
}
}
// action: upload file
else if ($action == "Upload")
{
ftp_chdir($result, $cdir);
// put file
/*
a better idea would be to use
$res_code = ftp_put($result, $HTTP_POST_FILES["upfile"]["name"],
$HTTP_POST_FILES["upfile"]["tmp_name"], FTP_BINARY);
as it offers greater security
*/
$res_code = ftp_put($result, $upfile_name, $upfile, FTP_BINARY);
// check status and display
if ($res_code == 1)
{
$status = "Upload successful!";
}
else
{
$status = "Upload error!";
}
}
// create file list
$filelist = ftp_nlist($result, ".");
// and display interface
include("include.php");
// close connection
ftp_quit($result);
}
?>
</body>
</html>

复制代码

<?
// get current location
$here = ftp_pwd($result);
/*
since ftp_size() is quite slow, especially when working
on an array containing all the files in a directory,
this section performs an ftp_size() on all the files in the current
directory and creates three arrays.
*/
// array for files
$files = Array();
// array for directories
$dirs = Array();
// array for file sizes
$file_sizes = Array();
// counters
$file_list_counter = 0;
$dir_list_counter = 0;
// check each element of $filelist
for ($x=0; $x<sizeof($filelist); $x++)
{
if (ftp_size($result, $filelist[$x]) != -1)
{
// create arrays
$files[$file_list_counter] = $filelist[$x];
$file_sizes[$file_list_counter] = ftp_size($result, $filelist[$x]);
$file_list_counter++;
}
else
{
$dir_list[$dir_list_counter] = $filelist[$x];
$dir_list_counter++;
}
}
?>
<center>
You are currently working in <b><? echo $here; ?></b>
<br>
<? echo $status; ?>
</center>
<hr>
<p>
Available directories:
<form action=actions.php method=post>
<!-- a more optimal solution might be to place these in session
variables -->
<input type=hidden name=username value=<? echo $username; ?>>
<input type=hidden name=password value=<? echo $password; ?>>
<input type=hidden name=server value=<? echo $server; ?>>
<input type=hidden name=cdir value=<? echo $here; ?>>
<input type=hidden name=action value=CWD>
<select name=rdir>
<option value=".."><parent directory></option>
<?
for ($x=0; $x<sizeof($dir_list); $x++)
{
echo "<option value=" . $dir_list[$x] . ">" . $dir_list[$x] . "</option>";
}
?>
</select>
<input type=submit value=Go>
</form>
<hr>
Available files:
<form action=actions.php method=post>
<input type=hidden name=server value=<? echo $server; ?>>
<input type=hidden name=username value=<? echo $username; ?>>
<input type=hidden name=password value=<? echo $password; ?>>
<input type=hidden name=cdir value=<? echo $here; ?>>
<table border=0 width=100%>
<?
// display file listing with checkboxes and sizes
for ($y=0; $y<sizeof($files); $y++)
{
echo "<tr><td><input type=checkbox name=dfile[] value=" . $files[$y] .
">". $files[$y] . " <i>(" . $file_sizes[$y] . " bytes)</i><td>";
}
?>
</table>
<center>
<input type=submit name=action value=Delete>
<input type=submit name=action value=Download>
</center>
</form>
<p>
<hr>
File upload:
<form enctype="multipart/form-data" action=actions.php method=post>
<input type=hidden name=username value=<? echo $username; ?>>
<input type=hidden name=password value=<? echo $password; ?>>
<input type=hidden name=server value=<? echo $server; ?>>
<input type=hidden name=cdir value=<? echo $here; ?>>
<table>
<tr>
<td>
<input type=file name=upfile>
</td>
</tr>
<tr>
<td>
<input type=submit name=action value=Upload>
</td>
</tr>
</table>
</form>

复制代码

收藏分享评分

                  我是一个呼吸着现在的空气而生活在过去的人
            这样的注定孤独，孤独的身处闹市却犹如置身于荒漠
                                 我已习惯了孤独，爱上孤独
                              他让我看清了自我，还原了自我
                           让我再静静的沉思中得到快乐和满足
                                 再孤独的世界里我一遍又一遍
                                 不厌其烦的改写着自己的过去
                                          延伸到现在与未来
                                    然而那只是泡沫般的美梦
                              产生的时刻又伴随着破灭的到来
                     在灰飞烟灭的瞬间我看到的是过程的美丽
                                    而不是结果的悲哀。。。

回复引用

订阅 TOP

返回列表