svn_checkout

(PECL svn >= 0.1.0)

svn_checkout — Extrait une copie de travail depuis un référentiel

Description

function svn_checkout(
    string $repos,
    string $targetpath,
    int $revision = ?,
    int $flags = 0
): bool

Extrait une copie de travail depuis le référentiel repos vers targetpath à la révision revision.

Liste de paramètres

repos

URL du dossier dans le référentiel à extraire.

targetpath

Chemin local du dossier dans lequel on effectue l'extraction

Note:

Les chemins relatifs peuvent être résolus comme si le dossier de travail courant était celui qui contient le binaire PHP. Pour utiliser le dossier de travail du script appelant, il faut utiliser la fonction realpath() ou dirname(__FILE__).

revision

Numéro de révision du référentiel à extraire. Par défaut, vaut HEAD, la révision la plus récente.

flags

Toute combinaison de SVN_NON_RECURSIVE et SVN_IGNORE_EXTERNALS.

Valeurs de retour

Cette fonction retourne true en cas de succès ou false si une erreur survient.

Exemples

Exemple #1 Exemple d'utilisation

Cet exemple montre comment extraire un dossier depuis un référentiel vers un dossier nommé "calc" :

<?php
svn_checkout('http://www.example.com/svnroot/calc/trunk', dirname(__FILE__) . '/calc');
?>

L'utilisation de dirname(__FILE__) est nécessaire afin de convertir le chemin relatif du dossier calc en un chemin absolu. Si calc existe, il est possible d'également utiliser realpath() pour récupérer un chemin absolu.

Notes

Avertissement

Cette fonction est EXPERIMENTALE. 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'utilisateur.

Voir aussi