(PECL svn:0.1-0.2)
svn_status — Récupère le statut des fichiers et des dossiers de la copie de travail
Retourne le statut des fichiers et des dossiers de la copie de travail, en fournissant les modifications, les ajouts, les suppressions, ainsi que les autres modifications des éléments de la copie de travail.
Chemin local vers le fichier ou le dossier dont on souhaite récupérer le statut.
Note: Les chemins relatifs peuvent être résolus si le dossier de travail courant est l'un de ceux qui contiennent le binaire PHP. Pour utiliser le dossier de travail, utilisez la fonction realpath(), ou l'instruction dirname(__FILE__).
Si l'on doit ou non récupérer récursivement les statuts. Par défaut, vaut TRUE.
Si l'on doit ou non retourner tous les éléments, d'un point de vue des modifications du statut. Par défaut, vaut FALSE.
Si l'on doit ou non retourner les informations depuis le serveur suivant si la copie de travail est à jour ou non (les entrées seront ajoutées pour les éléments qui sont à jour). Par défaut, vaut FALSE.
Si l'on doit ou non ignorer les propriétés svn:ignore lors de l'analyse des nouveaux fichiers. Par défaut, vaut FALSE.
Retourne un tableau indexé numériquement de tableaux associatifs détaillant le statut des éléments du dépôt :
Array ( [0] => Array ( // information sur l'élément ) [1] => ... )
L'information sur un élément est un tableau associatif qui peut contenir les clés suivantes :
Ces clés ne sont définies que si l'élément est versionné :
<?php
if (!defined('svn_wc_schedule_normal')) {
define('svn_wc_schedule_normal', 0); // rien de spécial
define('svn_wc_schedule_add', 1); // élément a ajouté
define('svn_wc_schedule_delete', 2); // élément a supprimé
define('svn_wc_schedule_replace', 3); // élément a ajouté et effacé
}
?>
Cette fonction est EXPERIMENTALE. Cela signifie que le comportement de cette fonction, son nom et, concrètement, TOUT ce qui est documenté ici peut changer dans un futur proche, SANS PREAVIS ! Soyez-en conscient, et utilisez cette fonction à vos risques et périls.
Exemple #1 Exemple d'utilisation
Cet exemple montre une utilisation basique de cette fonction.
<?php
print_r(svn_status(realpath('wc')));
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array ( [0] => Array ( [path] => /home/bob/wc/sandwich.txt [text_status] => 8 // l'élément a été modifié [repos_text_status] => 1 // Aucune information disponible, utilisez update [prop_status] => 3 // aucun changement [repos_prop_status] => 1 // Aucune information disponible, utilisez update [name] => sandwich.txt [url] => http://www.example.com/svnroot/deli/trunk/sandwich.txt [repos] => http://www.example.com/svnroot/ [revision] => 123 [kind] => 1 // fichier [schedule] => 0 // aucune action de prévue [cmt_date] => 1165543135 [cmt_rev] => 120 [cmt_author] => Alice [prop_time] => 1180201728 [text_time] => 1180201729 ) )