Descripción

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() 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.

Parámetros

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.

Valores devueltos

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:

**Acciones**
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.

Ejemplos

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'
                    )
            )
    )
)

Notas

Advertencia

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.

Ver también

» Documentación SVN para el comando "svn log"