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 без уведомления. Функцию включают в код на свой страх и риск.

    To Top