大网数据广告活动
PHP 语言与运行手册

ftp_nlist · 返回给定目录的文件列表

· 52CE 我爱测

指定要列表的目录。本参数接受带参数的形式,例如:ftp_nlist($ftp, "-la /your/dir");;注意此参数不对传入值做处理,在目录或者文件名包括空格或特殊的情况下,可能会存在问题。

ftp_nlist

(PHP 4, PHP 5, PHP 7, PHP 8)

ftp_nlist — 返回给定目录的文件列表

说明

function ftp_nlist(FTP\Connection $ftp, string $directory): array|false

参数

ftp

FTP\Connection 实例。

directory

指定要列表的目录。本参数接受带参数的形式,例如:ftp_nlist($ftp, "-la /your/dir");;注意此参数不对传入值做处理,在目录或者文件名包括空格或特殊的情况下,可能会存在问题。

返回值

如果成功则返回给定目录下的文件名组成的数组,否则返回 false。

更新日志

版本 说明
8.1.0 现在 ftp 参数接受 FTP\Connection 实例,之前接受 resource。

示例

示例 #1 ftp_nlist() 示例

<?php

// set up basic connection
$ftp = ftp_connect($ftp_server);
$login_result = ftp_login($ftp, $ftp_user_name, $ftp_user_pass);

// check connection
if ((!$ftp) || (!$login_result)) {
    die("FTP connection has failed !");
}
 
// get contents of the root directory
$contents = ftp_nlist($ftp, "/");

// output $contents
var_dump($contents);

?>

以上示例的输出类似于:

array(3) {
  [0]=>
  string(11) "public_html"
  [1]=>
  string(10) "public_ftp"
  [2]=>
  string(3) "www"

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。