(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_url
URL 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
.
limit
Nú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) );
?>
El resultado del ejemplo sería algo 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 ha sido declarada EXPERIMENTAL. Su funcionamiento, nombre y la documentación que le acompaña puede cambiar sin previo aviso en futuras versiones de PHP. Utilícela bajo su propia responsabilidad.