svn_add

(PECL svn >= 0.1.0)

svn_add — Prévoit l'ajout d'un élément dans le dossier de travail

Description

function svn_add(string $path, bool $recursive = true, bool $force = false): bool

Ajoute un fichier, un dossier ou un lien symbolique, en utilisant le chemin path dans le dossier de travail. L'élément sera ajouté au référentiel au prochain appel de la fonction svn_commit() sur la copie de travail.

Liste de paramètres

path

Chemin de l'élément à ajouter.

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

recursive

Si l'élément est un dossier, si l'on doit ou non ajouter récursivement tout son contenu. Par défaut, vaut true

force

Si vaut true, Subversion cherchera récursivement dans les dossiers versionnés existants afin d'ajouter tous les fichiers qui ne sont actuellement pas versionnés. Par défaut, vaut false

Valeurs de retour

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

Exemples

Exemple #1 Exemple avec svn_add()

Dans un dossier de travail où la commande svn status retourne : 

$ svn status
?      foobar.txt

...ce code:

<?php
svn_add('foobar.txt');
?>

...marquera le fichier foobar.txt comme fichier à ajouter dans le dossier.

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.