# svn_add

(PECL svn >= 0.1.0)

svn_add — 计划在工作目录添加项

### 说明

svn_add ( string `$path` [, bool `$recursive` = true [, bool `$force` = false ]] ) : bool

添加文件, 目录或者链接在`路径` 到工作目录。将在下一次执行svn_commit() 时把工作副本添加到项目中。

### 参数

`path`

  添加项的路径。

  > Note: 相对路径将会以PHP执行文件所在目录作为当前工作目录进行解析。如果希望依据脚本所在目录解析, 使用realpath() 或 dirname(__FILE__)。

`recursive`

  如果添加项为目录是否递归目录下所有文件。 默认为 `TRUE`

`force`

  If true, Subversion will recurse into already versioned directories in order to add unversioned files that may be hiding in those directories. Default is `FALSE`

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 注释

Warning

此函数是实验性的。此函数的表象，包括名称及其相关文档都可能在未来的 PHP 发布版本中未通知就被修改。使用本函数风险自担 。

### 范例

Example #1 svn_add() 例子

在工作目录使用命令 `svn status` 返回值:

    $ svn status
    ?      foobar.txt

...代码:

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

...计划 foobar.txt 文件添加到版本库。

### 参见

- » SVN documentation on svn add