# ftp_mlsd

(PHP 7 >= 7.2.0)

ftp_mlsd — Returns a list of files in the given directory

### 说明

ftp_mlsd ( resource `$ftp_stream` , string `$directory` ) : array

### 参数

`ftp_stream`

  The link identifier of the FTP connection.

`directory`

  The directory to be listed.

### 返回值

Returns an array of arrays with file infos from the specified directory on success or `FALSE` on error.

### 范例

Example #1 ftp_mlsd() example

    <?php

    // set up basic connection
    $conn_id = ftp_connect($ftp_server);

    // login with username and password
    $login_result = ftp_login($conn_id, $ftp_user_name, $ftp_user_pass);

    // get contents of the current directory
    $contents = ftp_mlsd($conn_id, ".");

    // output $contents
    var_dump($contents);

    ?>

以上例程的输出类似于：

    array(5) {
      [0]=>
      array(8) {
        ["name"]=>
        string(1) "."
        ["modify"]=>
        string(14) "20171212154511"
        ["perm"]=>
        string(7) "flcdmpe"
        ["type"]=>
        string(4) "cdir"
        ["unique"]=>
        string(11) "811U5740002"
        ["UNIX.group"]=>
        string(2) "33"
        ["UNIX.mode"]=>
        string(4) "0755"
        ["UNIX.owner"]=>
        string(2) "33"
      }
      [1]=>
      array(8) {
        ["name"]=>
        string(2) ".."
        ["modify"]=>
        string(14) "20171212154511"
        ["perm"]=>
        string(7) "flcdmpe"
        ["type"]=>
        string(4) "pdir"
        ["unique"]=>
        string(11) "811U5740002"
        ["UNIX.group"]=>
        string(2) "33"
        ["UNIX.mode"]=>
        string(4) "0755"
        ["UNIX.owner"]=>
        string(2) "33"
      }
      [2]=>
      array(8) {
        ["name"]=>
        string(11) "public_html"
        ["modify"]=>
        string(14) "20171211171525"
        ["perm"]=>
        string(7) "flcdmpe"
        ["type"]=>
        string(3) "dir"
        ["unique"]=>
        string(11) "811U5740525"
        ["UNIX.group"]=>
        string(2) "33"
        ["UNIX.mode"]=>
        string(4) "0755"
        ["UNIX.owner"]=>
        string(2) "33"
      }
      [3]=>
      array(8) {
        ["name"]=>
        string(10) "public_ftp"
        ["modify"]=>
        string(14) "20171211174536"
        ["perm"]=>
        string(7) "flcdmpe"
        ["type"]=>
        string(3) "dir"
        ["unique"]=>
        string(11) "811U57405EE"
        ["UNIX.group"]=>
        string(2) "33"
        ["UNIX.mode"]=>
        string(4) "0755"
        ["UNIX.owner"]=>
        string(2) "33"
      }
      [4]=>
      array(8) {
        ["name"]=>
        string(3) "www"
        ["modify"]=>
        string(14) "www"
        ["perm"]=>
        string(7) "flcdmpe"
        ["type"]=>
        string(3) "dir"
        ["unique"]=>
        string(11) "811U5740780"
        ["UNIX.group"]=>
        string(2) "33"
        ["UNIX.mode"]=>
        string(4) "0755"
        ["UNIX.owner"]=>
        string(2) "33"
      }
    }

### 参见

- ftp_rawlist() - 返回指定目录下文件的详细列表
- ftp_nlist() - 返回给定目录的文件列表