Home/ Manual/ svn / functions/ svn_log

svn_log

PHP function Edit on GitHub ✎

(PECL svn >= 0.1.0)

Returns the commit log messages of a repository URL

Description

svn_log(string $repos_url, [int $start_revision], [int $end_revision], int $limit = 0, int $flags = SVN_DISCOVER_CHANGED_PATHS | SVN_STOP_ON_COPY): array

svn_log() returns the complete history of the item at the repository URL repos_url, or the history of a specific revision if start_revision is set. This function is equivalent to svn log --verbose -r $start_revision $repos_url.

Parameters

repos_url: Repository URL of the item to retrieve log history from.
start_revision: Revision number of the first log to retrieve. Use SVN_REVISION_HEAD to retrieve the log from the most recent revision.
end_revision: Revision number of the last log to retrieve. Defaults to start_revision if specified or to SVN_REVISION_INITIAL otherwise.
limit: Number of logs to retrieve.
flags: Any combination of SVN_OMIT_MESSAGES, SVN_DISCOVER_CHANGED_PATHS and SVN_STOP_ON_COPY.

Return Values

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

output

[0] => Array, ordered most recent (highest) revision first
(
    [rev] => integer revision number
    [author] => string author name
    [msg] => string log message
    [date] => string date formatted per ISO 8601, i.e. date('c')
    [paths] => Array, describing changed files
        (
            [0] => Array
                (
                    [action] => string letter signifying change
                    [path] =>  absolute repository path of changed file
                )
            [1] => ...
        )
)
[1] => ...

Note

The output will always be a numerically indexed array of arrays, even when there are none or only one log message(s).

The value of action is a subset of the status output in the first column, where possible values are:

Letter	Description
M	Item/props was modified
A	Item was added
D	Item was deleted
R	Item was replaced

If no changes were made to the item, an empty array is returned.

Examples

svn_log() example

php

<?php
print_r( svn_log('http://www.example.com/', 23) );
?>

The above example will output something similar to: