ConFoo: Call for paper is now Open

svn_cat

(PECL svn >= 0.1.0)

svn_catReturns the contents of a file in a repository

Description

string svn_cat ( string $repos_url [, int $revision_no ] )

Returns the contents of the URL repos_url to a file in the repository, optionally at revision number revision_no.

Parameters

repos_url

String URL path to item in a repository.

revision_no

Integer revision number of item to retrieve, default is the HEAD revision.

Return Values

Returns the string contents of the item from the repository on success, and FALSE on failure.

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 Basic example

This example retrieves the contents of a file at revision 28:

<?php
$contents 
svn_cat('http://www.example.com/svnroot/calc/gui.c'28)
?>

See Also

add a note add a note

User Contributed Notes 2 notes

up
1
colm
6 months ago
Just to add to Adam's comment, when retrieving a file contents I found I got the best results using the same revision in both places every time; ie. as follows:

<?php
svn_cat
($url.'@'.$revision, $revision);
?>

The one appended to the URL is the peg revision, and the one in the second paramer is the operative revision.

This seems to cover all the bases.
up
1
Adam
1 year ago
There is a difference how svn cat works for deleted files. For deleted file commandline `svn cat -r xxx <full_url>` will give error, but 'svn cat <full_url>@xxx` will cat file from the past.
Unfortunately this method will not cat deleted file.
To Top