svn_cat

(PECL svn >= 0.1.0)

svn_cat — Returns the contents of a file in a repository

说明

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.

参数

repos_url: String URL path to item in a repository.
revision_no: Integer revision number of item to retrieve, default is the HEAD revision.

返回值

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

注释

Warning

此函数是实验性的。此函数的表象，包括名称及其相关文档都可能在未来的 PHP 发布版本中未通知就被修改。使用本函数风险自担。

范例

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)
?>

参见

svn_list()
» SVN documentation on svn cat

User Contributed Notes

colm 21-Feb-2014 07:16


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.

Adam 27-Mar-2013 11:16


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.