svn_ls
(PECL svn >= 0.1.0)
svn_ls — Retourne la liste du contenu d'un dossier d'un référentiel, optionnellement à la révision fournie
Description
$repos_url
[, int $revision_no
= SVN_REVISION_HEAD
[, bool $recurse
= false
[, bool $peg
= false
]]] )
Cette fonction interroge l'URL du référentiel et retourne une liste
des fichiers et dossiers, optionnellement depuis une révision
spécifique. C'est l'équivalent de la commande
svn list $repos_url[@$revision_no]
Note:
Cette fonction ne fonctionne pas avec les copies de travail.
repos_url
DOIT être une URL de référentiel.
Liste de paramètres
-
url
-
URL du référentiel, e.g.
http://www.example.com/svnroot
. Pour accéder à un référentiel local Subversion via le système de fichiers, utilisez l'URI suivant :file:///home/user/svn-repos
-
revision
-
Numéro de révision à utiliser. S'il est omis, HEAD sera utilisé.
-
recurse
-
Active la récursivité.
Valeurs de retour
En cas de succès, cette fonction retourne un tableau de fichiers, listés sous la forme :
[0] => Array ( [created_rev] => numéro de révision de la dernière édition [last_author] => nom de l'auteur de la dernière édition [size] => taille du fichier [time] => date et heure de la dernière édition, au format 'M d H:i' ou 'M d Y', suivant l'âge du fichier [time_t] => timestamp Unix de la dernière édition [name] => nom du fichier ou du dossier [type] => type, peut être 'file' ou 'dir' ) [1] => ...
Notes
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.
Exemples
Exemple #1 Exemple avec svn_ls()
<?php print_r( svn_ls('http://www.example.com/svnroot/') ); ?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array ( [0] => Array ( [created_rev] => 20 [last_author] => Joe [size] => 0 [time] => Apr 02 09:28 [time_t] => 1175520529 [name] => tags [type] => dir ) [1] => Array ( [created_rev] => 23 [last_author] => Bob [size] => 0 [time] => Apr 02 15:15 [time_t] => 1175541322 [name] => trunk [type] => dir ) )