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
Значення, що повертаються
У разі успішного виконання, функція повертає масив формату:
[ ] => Масив, відсортований спочатку найостаннішої (найбільшої) ревізії ( [rev] => Номер ревізії (ціле число) [author] => Автор правки (рядок) [msg] => Коментар до змін (рядок) [date] => Дата редагування у форматі ISO 8601, тобто. date('c') [paths] => Масив із шляхами до змінених файлів ( [ ] => Array ( [action] => Позначення характеру змін [path] => Абсолютний шлях репозиторію до зміненого файлу ) [ ] => ... ) ) [ ] => ...
Зауваження :
Висновок завжди представлений як пронумерований масив, що містить масиви, крім випадків відсутності або єдиного екземпляра ревізій.
Значення action є підмножиною » перших літер станів SVN, де можливі значення - це:
Дії
| Буква | Опис |
|---|---|
| M | Елемент було змінено |
| A | Елемент було додано |
| D | Елемент був вилучений |
| R | Елемент було замінено |
Якщо змін елемента немає, повертається порожній масив.
Приклади
Приклад #1 Приклад використання svn_log()****
Висновок наведеного прикладу буде схожим на:
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 без повідомлення. Використовуйте цю функцію на свій страх та ризик.