PHP 8.5.0 Alpha 1 available for testing

svn_log

(PECL svn >= 0.1.0)

svn_logRecupera el mensaje de historial de una URL del repositorio

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) );
?>

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

Notas

Advertencia

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.

add a note

User Contributed Notes 1 note

up
0
php dot net at gnur dot nl
14 years ago
Please not that using svn_log without giving revisions is much, much slower then with revisions. Examples:

$ time php -r "svn_log('http://localhost/svn/shopadsl');"

real 0m2.140s
user 0m0.140s
sys 0m0.000s

VS

$ time php -r "svn_log('http://localhost/svn/shopadsl', 0, 45);"

real 0m0.063s
user 0m0.024s
sys 0m0.016s
To Top