<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.svn.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'fr',
  ),
  'this' => 
  array (
    0 => 'function.svn-ls.php',
    1 => 'svn_ls',
    2 => 'Retourne la liste du contenu d\'un dossier d\'un r&eacute;f&eacute;rentiel, optionnellement &agrave; la r&eacute;vision fournie',
  ),
  'up' => 
  array (
    0 => 'ref.svn.php',
    1 => 'Fonctions SVN',
  ),
  'prev' => 
  array (
    0 => 'function.svn-log.php',
    1 => 'svn_log',
  ),
  'next' => 
  array (
    0 => 'function.svn-mkdir.php',
    1 => 'svn_mkdir',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'fr',
    'path' => 'reference/svn/functions/svn-ls.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.svn-ls" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">svn_ls</h1>
  <p class="verinfo">(PECL svn &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">svn_ls</span> &mdash; <span class="dc-title">Retourne la liste du contenu d&#039;un dossier d&#039;un référentiel, optionnellement à la révision fournie</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.svn-ls-description">
  <h3 class="title">Description</h3>
  <div class="methodsynopsis dc-description">
   <span class="modifier">function</span> <span class="methodname"><strong>svn_ls</strong></span>(<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.string.php" class="type string">string</a></span> <code class="parameter">$repos_url</code></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$revision_no</code><span class="initializer"> = SVN_REVISION_HEAD</span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$recurse</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong></span></span>,<br>&nbsp;&nbsp;&nbsp;&nbsp;<span class="methodparam"><span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span> <code class="parameter">$peg</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong></span></span><br>): <span class="type"><a href="language.types.array.php" class="type array">array</a></span></div>

  <p class="simpara">
   Cette fonction interroge l&#039;URL du référentiel et retourne une liste
   des fichiers et dossiers, optionnellement depuis une révision
   spécifique. C&#039;est l&#039;équivalent de la commande
   <strong class="userinput"><code>svn list $repos_url[@$revision_no]</code></strong>
  </p>
  <blockquote class="note"><p><strong class="note">Note</strong>: 
   <p class="simpara">
    Cette fonction ne fonctionne pas avec les copies de travail.
    <code class="parameter">repos_url</code> <em>DOIT</em> être une URL de référentiel.
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.svn-ls-parameters">
  <h3 class="title">Liste de paramètres</h3>
  <dl>
   
    <dt><code class="parameter">url</code></dt>
    <dd>
     <p class="simpara">
      URL du référentiel, e.g. <strong class="userinput"><code>http://www.example.com/svnroot</code></strong>.
      Pour accéder à un référentiel local Subversion via le système de fichiers,
      utiliser l&#039;URI suivant : <strong class="userinput"><code>file:///home/user/svn-repos</code></strong>
     </p>
    </dd>
   
   
    <dt><code class="parameter">revision</code></dt>
    <dd>
     <p class="simpara">
      Numéro de révision à utiliser. S&#039;il est omis, HEAD sera utilisé.
     </p>
    </dd>
   
   
    <dt><code class="parameter">recurse</code></dt>
    <dd>
     <p class="simpara">
      Active la récursivité.
     </p>
    </dd>
   
  </dl>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.svn-ls-returnvalues">
  <h3 class="title">Valeurs de retour</h3>
  <p class="para">
   En cas de succès, cette fonction retourne un tableau de fichiers,
   listés sous la forme :
   <div class="example-contents screen">
<div class="returnvaluescode"><pre class="returnvaluescode">[0] =&gt; Array
    (
        [created_rev] =&gt; numéro de révision de la dernière édition
        [last_author] =&gt; nom de l&#039;auteur de la dernière édition
        [size] =&gt; taille du fichier
        [time] =&gt; date et heure de la dernière édition, au format &#039;M d H:i&#039;
                  ou &#039;M d Y&#039;, suivant l&#039;âge du fichier
        [time_t] =&gt; timestamp Unix de la dernière édition
        [name] =&gt; nom du fichier ou du dossier
        [type] =&gt; type, peut être &#039;file&#039; ou &#039;dir&#039;
    )
[1] =&gt; ...</pre>
</div>
    </div>
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.svn-ls-examples">
  <h3 class="title">Exemples</h3>
  <div class="example" id="example-1">
   <p><strong>Exemple #1 Exemple avec <span class="function"><strong>svn_ls()</strong></span></strong></p>
   <div class="example-contents">
<div class="phpcode"><pre><code style="color: #000000"><span style="color: #0000BB">&lt;?php
print_r</span><span style="color: #007700">( </span><span style="color: #0000BB">svn_ls</span><span style="color: #007700">(</span><span style="color: #DD0000">'http://www.example.com/svnroot/'</span><span style="color: #007700">) );
</span><span style="color: #0000BB">?&gt;</span></code></pre></div>
   </div>

   <div class="example-contents"><p>Résultat de l&#039;exemple ci-dessus est similaire à :</p></div>
   <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Array
(
    [0] =&gt; Array
        (
            [created_rev] =&gt; 20
            [last_author] =&gt; Joe
            [size] =&gt; 0
            [time] =&gt; Apr 02 09:28
            [time_t] =&gt; 1175520529
            [name] =&gt; tags
            [type] =&gt; dir
        )
    [1] =&gt; Array
        (
            [created_rev] =&gt; 23
            [last_author] =&gt; Bob
            [size] =&gt; 0
            [time] =&gt; Apr 02 15:15
            [time_t] =&gt; 1175541322
            [name] =&gt; trunk
            [type] =&gt; dir
        )
)</pre>
</div>
   </div>
  </div>
 </div>


 <div class="refsect1 notes" id="refsect1-function.svn-ls-notes">
  <h3 class="title">Notes</h3>
  <div class="warning"><strong class="warning">Avertissement</strong><p class="simpara">
 Cette fonction est <em>EXPERIMENTALE</em>. Le comportement de cette fonction, son nom, et toute la
 documentation autour de cette fonction peuvent changer sans préavis dans une prochaine version de PHP.
 Cette fonction doit être utilisée aux risques et périls de l&#039;utilisateur.
</p></div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.svn-ls-seealso">
  <h3 class="title">Voir aussi</h3>
  <ul class="simplelist">
   <li>
    <a href="http://svnbook.red-bean.com/en/1.2/svn.ref.svn.c.list.html" class="link external">&raquo;&nbsp;Documentation SVN sur la commande <code class="literal">&quot;svn list&quot;</code></a>
   </li>
  </ul>
 </div>

</div><?php manual_footer($setup); ?>