svn_status

svn_status(string $path, [int $flags]): array
```php

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.

> [!NOTE]
> 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](#svn.constants.status) 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](#svn.constants.status) para los valores posibles.

`prop_status`  
Estado de la propiedad del elemento. Refiérase a las [constantes de estado](#svn.constants.status) 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](#svn.constants.status) 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](#svn.constants.type) 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:

`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 de uso

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

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