(PECL svn >= 0.1.0)
svn_log — Recupera el mensaje de historial de una URL del repositorio
$repos_url,$start_revision = ?,$end_revision = ?,$limit = 0,$flags = SVN_DISCOVER_CHANGED_PATHS | SVN_STOP_ON_COPY
svn_log() recupera el historial completo del elemento
correspondiente a la URL repos_url, o el historial de una revisión específica
si start_revision está especificado. Esta función es equivalente
al comando svn log --verbose -r $start_revision $repos_url.
repos_urlURL en el repositorio del elemento del que se debe recuperar el historial.
start_revision
Número de revisión del primer historial a recuperar. Utilice
la constante SVN_REVISION_HEAD para recuperar
el historial de la revisión más reciente.
end_revision
Número de revisión del último historial a recuperar. Por omisión vale
start_revision si está especificado, de lo contrario vale la
constante SVN_REVISION_INITIAL.
limitNúmero de historiales a recuperar.
flags
Cualquier combinación de SVN_OMIT_MESSAGES,
SVN_DISCOVER_CHANGED_PATHS y
SVN_STOP_ON_COPY.
En caso de éxito, esta función devuelve un array de ficheros en el formato:
[0] => Array, ordenado del número de revisión más grande al más pequeño
(
[rev] => número de revisión
[author] => nombre del autor
[msg] => mensaje de historial
[date] => fecha, en formato ISO 8601, es decir, date('c')
[paths] => Array, describiendo los ficheros modificados
(
[0] => Array
(
[action] => letra, especificando la modificación
[path] => ruta absoluta del repositorio al fichero modificado
)
[1] => ...
)
)
[1] => ...
Nota:
La salida será siempre un array indexado numéricamente de arrays, incluso si no hay ninguno, o solo un mensaje de historial.
El valor de action es una subparte de » la salida de estado en la primera columna, donde los valores posibles son:
| Letra | Descripción |
|---|---|
| M | El elemento ha sido modificado |
| A | El elemento ha sido añadido |
| D | El elemento ha sido eliminado |
| R | El elemento ha sido reemplazado |
Si no se ha realizado ninguna modificación al elemento, se devolverá un array vacío.
Ejemplo #1 Ejemplo con svn_log()
<?php
print_r( svn_log('http://www.example.com/', 23) );
?>Resultado del ejemplo anterior es similar a :
Array
(
[0] => Array
(
[rev] => 23
[author] => 'joe'
[msg] => 'Add cheese and salami to our sandwich.'
[date] => '2007-04-06T16:00:27-04:00'
[paths] => Array
(
[0] => Array
(
[action] => 'M'
[path] => '/sandwich.txt'
)
)
)
)
Esta función es EXPERIMENTAL. El comportamiento de esta función, su nombre, y toda la documentación alrededor de esta función puede cambiar sin previo aviso en una próxima versión de PHP. Esta función debe ser utilizada bajo su propio riesgo.