Returns a detailed list of files in the given directory

ftp_raw
ftp_rename
FTP Functions
PHP Manual

# ftp_rawlist

(PHP 4, PHP 5)

ftp_rawlist — Returns a detailed list of files in the given directory

### Description

array ftp_rawlist ( resource `$ftp_stream` , string `$directory` [, bool `$recursive` = false ] )

ftp_rawlist() executes the FTP LIST command, and returns the result as an array.

### Parameters

`ftp_stream`

  The link identifier of the FTP connection.

`directory`

  The directory path. May include arguments for the LIST command.

`recursive`

  If set to `TRUE`, the issued command will be LIST -R.

### Return Values

Returns an array where each element corresponds to one line of text.

The output is not parsed in any way. The system type identifier returned by ftp_systype() can be used to determine how the results should be interpreted.

### Examples

Example #1 ftp_rawlist() 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 the file list for /
$buff = ftp_rawlist($conn_id, '/');
// close the connection
ftp_close($conn_id);
// output the buffer
var_dump($buff);
?>`

The above example will output something similar to:

    array(3) {
      [0]=>
      string(65) "drwxr-x---   3 vincent  vincent      4096 Jul 12 12:16 public_ftp"
      [1]=>
      string(66) "drwxr-x---  15 vincent  vincent      4096 Nov  3 21:31 public_html"
      [2]=>
      string(73) "lrwxrwxrwx   1 vincent  vincent        11 Jul 12 12:16 www -> public_html"
    }

### Changelog

Version | Description
--- | ---
4.3.0 | `recursive` was added.

### See Also

- ftp_nlist() - Returns a list of files in the given directory

ftp_raw
ftp_rename
FTP Functions
PHP Manual