SVN_LS(3)								 1								 SVN_LS(3)

svn_ls - Returns list of directory contents in repository URL, optionally at revision number

SYNOPSIS

       array svn_ls (string  $repos_url, [int  $revision_no = SVN_REVISION_HEAD], [bool  $recurse = false], [bool  $peg = false])

DESCRIPTION

	This function queries the repository URL and returns a list of files and directories, optionally from a specific revision. This is equiva-
       lent to svn list $repos_url[@$revision_no]

       Note

	       This function does not work with working copies. $repos_url must be a repository URL.

PARAMETERS

	      o $url
		- URL of the repository, eg.  http://www.example.com/svnroot. To access a local Subversion repository via filesystem, use the file
		URI scheme, eg.  file:///home/user/svn-repos

	      o $revision
		- Integer revision number to retrieve listing of. When omitted, the HEAD revision is used.

	      o $recurse
		- Enables recursion.

RETURN VALUES

	On success, this function returns an array file listing in the format of:

       [0] => Array
	   (
	       [created_rev] => integer revision number of last edit
	       [last_author] => string author name of last edit
	       [size] => integer byte file size of file
	       [time] => string date of last edit in form 'M d H:i'
			 or 'M d Y', depending on how old the file is
	       [time_t] => integer unix timestamp of last edit
	       [name] => name of file/directory
	       [type] => type, can be 'file' or 'dir'
	   )
       [1] => ...

NOTES

       Warning

	      This  function is EXPERIMENTAL. The behaviour of this function, its name, and surrounding documentation may change without notice in
	      a future release of PHP. This function should be used at your own risk.

EXAMPLES

       Example #1

	      svn_ls(3) example

	      <?php
	      print_r( svn_ls('http://www.example.com/svnroot/') );
	      ?>

	      The above example will output something similar to:

	      Array
	      (
		  [0] => Array
		      (
			  [created_rev] => 20
			  [last_author] => Joe
			  [size] => 0
			  [time] => Apr 02 09:28
			  [time_t] => 1175520529
			  [name] => tags
			  [type] => dir
		      )
		  [1] => Array
		      (
			  [created_rev] => 23
			  [last_author] => Bob
			  [size] => 0
			  [time] => Apr 02 15:15
			  [time_t] => 1175541322
			  [name] => trunk
			  [type] => dir
		      )
	      )

SEE ALSO

       SVN documentation on svn list.

PHP Documentation Group 														 SVN_LS(3)