array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'es', ), 'this' => array ( 0 => 'function.svn-status.php', 1 => 'svn_status', 2 => 'Obtiene el estado de los ficheros y directorios de la copia de trabajo', ), 'up' => array ( 0 => 'ref.svn.php', 1 => 'Funciones SVN', ), 'prev' => array ( 0 => 'function.svn-revert.php', 1 => 'svn_revert', ), 'next' => array ( 0 => 'function.svn-update.php', 1 => 'svn_update', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'es', 'path' => 'reference/svn/functions/svn-status.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

svn_status

(PECL svn >= 0.1.0)

svn_status — Obtiene el estado de los ficheros y directorios de la copia de trabajo

Descripción

svn_status(string $path, int $flags = 0): array

Devuelve el estado de los ficheros y directorios de la copia de trabajo, proporcionando las modificaciones, adiciones, eliminaciones, así como otros cambios de los elementos de la copia de trabajo.

Parámetros

path
Ruta local al fichero o directorio del que se desea obtener el estado.

Nota: Los caminos relativos pueden ser resueltos si el directorio de trabajo actual es uno de los que contienen el binario PHP. Para utilizar el directorio de trabajo, utilice la función realpath(), o la instrucción dirname(__FILE__).

flags
Cualquier combinación de Svn::NON_RECURSIVE, Svn::ALL (independientemente del estado de modificación), Svn::SHOW_UPDATES (se añadirán entradas para elementos que no están actualizados), Svn::NO_IGNORE (ignora las propiedades svn:ignore al analizar nuevos ficheros) y Svn::IGNORE_EXTERNALS.

Valores devueltos

Devuelve un array indexado numéricamente de arrays asociativos que detallan el estado de los elementos del repositorio: 

Array (
    [0] => Array (
        // información sobre el elemento
    )
    [1] => ...
)

La información sobre un elemento es un array asociativo que puede contener las siguientes claves:

path
Ruta al fichero/directorio de esta entrada en el sistema de ficheros local.
text_status
Estado del texto del elemento. Refiérase a las constantes de estado para los valores posibles.
repos_text_status
Estado del texto del elemento en el repositorio. Solo ocurre si update está definido como true. Refiérase a las constantes de estado para los valores posibles.
prop_status
Estado de la propiedad del elemento. Refiérase a las constantes de estado para los valores posibles.
repos_prop_status
Estado de la propiedad del elemento en el repositorio. Solo ocurre si update está definido como true. Refiérase a las constantes de estado para los valores posibles.
locked
Si el elemento está bloqueado. (Definido solo si true.)
copied
Si el elemento ha sido copiado o no (previsto para añadir con el registro). (Definido solo si true.)
switched
Si el elemento ha cambiado de repositorio de referencia, utilizando el comando switch. (Definido solo si true)

Estas claves solo están definidas si el elemento está versionado:

name
Nombre base del elemento en el repositorio.
url
URL del elemento en el repositorio.
repos
URL base del repositorio.
revision
Revisión del elemento en la copia de trabajo.
kind
Tipo del elemento, es decir, fichero o directorio. Refiérase a las constantes de tipo para los valores posibles.
schedule
Acción prevista para el elemento, es decir, adición o eliminación. Las constantes para estos números mágicos no están disponibles, pueden ser emuladas utilizando:
<?php
if (!defined('svn_wc_schedule_normal')) {
define('svn_wc_schedule_normal', 0); // nada especial
define('svn_wc_schedule_add', 1); // elemento a añadir
define('svn_wc_schedule_delete', 2); // elemento a eliminar
define('svn_wc_schedule_replace', 3); // elemento a añadir y eliminar
}
?>
deleted
Si el elemento ha sido eliminado, pero las revisiones padre aún existen (Definido solo si true.)
absent
Si el elemento está ausente, pero Subversion sabe que debería estar aquí. (Definido solo si true.)
incomplete
Si la entrada del fichero para un directorio está incompleta. (Definido solo si true.)
cmt_date
Timestamp Unix de la fecha del último commit. (No afectado por el parámetro update).
cmt_rev
Revisión del último commit. (No afectado por el parámetro update).
cmt_author
Nombre del autor del último commit. (No afectado por el parámetro update).
prop_time
Timestamp Unix que representa la fecha/hora de la última actualización de las propiedades.
text_time
Timestamp Unix que representa la fecha/hora de la última actualización del texto.

Ejemplos

Ejemplo #1 Ejemplo de uso

Este ejemplo muestra un uso básico de esta función.

<?php
print_r(svn_status(realpath('wc')));
?>

Resultado del ejemplo anterior es similar a:

Array (
    [0] => Array (
        [path] => /home/bob/wc/sandwich.txt
        [text_status] => 8 // el elemento ha sido modificado
        [repos_text_status] => 1 // Ninguna información disponible, use update
        [prop_status] => 3 // ningún cambio
        [repos_prop_status] => 1 // Ninguna información disponible, use update
        [name] => sandwich.txt
        [url] => http://www.example.com/svnroot/deli/trunk/sandwich.txt
        [repos] => http://www.example.com/svnroot/
        [revision] => 123
        [kind] => 1 // fichero
        [schedule] => 0 // ninguna acción prevista
        [cmt_date] => 1165543135
        [cmt_rev] => 120
        [cmt_author] => Alice
        [prop_time] => 1180201728
        [text_time] => 1180201729
    )
)

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