w3-tools.com - Free Webmaster Tools and Resources
  		w3-tools.com - Free Webmaster Tools and Resources
 Free Webmaster Tools and Resources

 



PEAR Manual

This manual is provided as a courtesy. It is not an official source. Please check pear.php.net for updated information.

PEAR Manual

PEAR Manual
PEAR Manual
PrevNext

Net_FTP::ls()

Net_FTP::ls() -- returns the listing of a directory in a specified way.

Synopsis

require_once 'Net/FTP.php';

mixed Net_FTP::ls ([string $dir = null [, string $mode = NET_FTP_DIRS_FILES]])

Description

this function gives you a listing of either the files / directories / both or an unformated array (like the PHP function ftp_rawlist()).

Parameter

  • string [$dir = null] - The directory to list. You can either use a relative or an absolute path. This optional parameter will be set to the current path.

  • int $mode = NET_FTP_DIRS_FILES - A constant representing the nodes list (directories, files, both or a ram directory listing). This parameter is determined by the constants ( see: Constants). This parameter is optional and will be set for listing directories and files structured in an array.

Return value

mixed - a directory listing in the form you determine on success, otherwise PEAR::Error.

Throws

Several errors may be returned by ls. The errornumber is unspecific (until now) and will not tell you anything about the errormessage. Possible errors are:

Table 47-1. Possible PEAR_Error values

Error messageDescriptionSolution
Raw directory-list in wrong format. The format given by the server on PHP function ftp_rawlist()was wrong. Check if the directory you wanted to be listed is correct and you have access to listing it. Specify a correct directory path (eg. /my/file/path/, ../) and check (maybe change) the rights on it.
Could not get last-modification-date of '$file'. The last-modification date could not be determined by PHP. Reasons for this might be that your FTP-server does not support the used command or that you gave the function a non existent file as reference.

  • check the given file for existence

  • contact the FTP server's admin

Date-format failed on timestamp '$res'. The given format-string was not well formated. Check the documentation of the PHP function date().

Note

This function can not be called statically.

Example

Example 47-1. Using ls()

<?php
     
    var_dump($test->ls('/foo/bar'));
    
?>
PrevHomeNext
Net_FTP::size()UpNet_FTP::rm()

Newsletter
Join to our newsletter and receive news and updates about our site.
Your name: 
E-mail address: 
Action: 
 

Hosted by

Search
Google
Web w3-tools.com

Links
  What is my IP? Find your IP address!     Valid XHTML 1.0 Transitional  
Copyright © 2006. by w3-tools.com. All rights reserved