array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.svn-log.php', 1 => 'svn_log', 2 => 'Возвращает комментарии к правкам в репозитории', ), 'up' => array ( 0 => 'ref.svn.php', 1 => 'Функции SVN', ), 'prev' => array ( 0 => 'function.svn-import.php', 1 => 'svn_import', ), 'next' => array ( 0 => 'function.svn-ls.php', 1 => 'svn_ls', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/svn/functions/svn-log.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

svn_log

(PECL svn >= 0.1.0)

svn_log — Возвращает комментарии к правкам в репозитории

Описание

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() возвращает полную историю изменений конкретного элемента репозитория, расположенного по URL repos_url, или историю правок в конкретном диапазоне, если указан параметр start_revision. Данная функция эквивалентна команде SVN svn log --verbose -r $start_revision $repos_url.

Список параметров

repos_url
URL-адрес репозитория для получения истории правок элемента.
start_revision
Начальный номер ревизии для получения. Используйте константу SVN_REVISION_HEAD для получения самой последней ревизии.
end_revision
Конечный номер ревизии для получения. По умолчанию при использовании параметра start_revision идентичен ему, в противном случае равен SVN_REVISION_INITIAL.
limit
Количество записей для получения.
flags
Любая комбинация SVN_OMIT_MESSAGES, SVN_DISCOVER_CHANGED_PATHS и SVN_STOP_ON_COPY.

Возвращаемые значения

В случае успешного выполнения, функция возвращает массив формата: 

[0] => Массив, отсортированный по сначала самой последней (самой большей) ревизии
(
    [rev] => Номер ревизии (целое число)
    [author] => Автор правки (строка)
    [msg] => Комментарий к изменениям (строка)
    [date] => Дата правки в формате ISO 8601, т.е. date('c')
    [paths] => Массив с путями к изменённым файлам
        (
            [0] => Array
                (
                    [action] => Обозначение характера изменений
                    [path] =>  Абсолютный путь репозитория к изменённому файлу
                )
            [1] => ...
        )
)
[1] => ...

Замечание: Вывод всегда представлен как пронумерованный массив, содержащий массивы, кроме случаев отсутствия или только единственного экземпляра ревизий.

Значение action является подмножеством » первых букв состояний SVN, где возможные значения - это:

Действия
Буква Описание
M Элемент был изменён
A Элемент был добавлен
D Элемент был удалён
R Элемент был заменён

Если изменений элемента нет, возвращается пустой массив.

Примеры

Пример #1 Пример использования svn_log()

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

Вывод приведённого примера будет похож на: 

Array
(
    [0] => Array
    (
        [rev] => 23
        [author] => 'joe'
        [msg] => 'К нашему бутерброду добавлены сыр и колбаса.'
        [date] => '2007-04-06T16:00:27-04:00'
        [paths] => Array
            (
                [0] => Array
                    (
                        [action] => 'M'
                        [path] =>  '/sandwich.txt'
                    )
            )
    )
)

Примечания

Внимание

Это ЭКСПЕРИМЕНТАЛЬНАЯ функция. Поведение, название и документацию к функции в новых версиях PHP изменяют без уведомления. За включение функции в код отвечает программист.

Смотрите также