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
Список параметров
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.
За включение функции в код отвечает программист.