uTools-Manuals/docs/php/svn_checkout.html
2019-04-08 23:22:26 +08:00

154 lines
6.1 KiB
HTML
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Checks out a working copy from the repository</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.svn-checkout" class="refentry">
<div class="refnamediv">
<h1 class="refname">svn_checkout</h1>
<p class="verinfo">(PECL svn &gt;= 0.1.0)</p><p class="refpurpose"><span class="refname">svn_checkout</span> &mdash; <span class="dc-title">Checks out a working copy from the repository</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.svn-checkout-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>svn_checkout</strong></span>
( <span class="methodparam"><span class="type">string</span> <code class="parameter">$repos</code></span>
, <span class="methodparam"><span class="type">string</span> <code class="parameter">$targetpath</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$revision</code></span>
[, <span class="methodparam"><span class="type">int</span> <code class="parameter">$flags</code><span class="initializer"> = 0</span></span>
]] ) : <span class="type">bool</span></div>
<p class="para rdfs-comment">
Checks out a working copy from the repository at <code class="parameter">repos</code>
to <code class="parameter">targetpath</code> at revision <code class="parameter">revision</code>.
</p>
</div>
<div class="refsect1 parameters" id="refsect1-function.svn-checkout-parameters">
<h3 class="title">参数</h3>
<p class="para">
<dl>
<dt>
<code class="parameter">repos</code></dt>
<dd>
<p class="para">
String URL path to directory in repository to check out.
</p>
</dd>
<dt>
<code class="parameter">targetpath</code></dt>
<dd>
<p class="para">
String local path to directory to check out in to
</p>
<blockquote class="note"><p><strong class="note">Note</strong>: <span class="simpara">相对路径将会以PHP执行文件所在目录作为当前工作目录进行解析。如果希望依据脚本所在目录解析, 使用<span class="function"><a href="realpath.html" class="function">realpath()</a></span> 或 dirname(__FILE__)。</span></p></blockquote>
</dd>
<dt>
<code class="parameter">revision</code></dt>
<dd>
<p class="para">
Integer revision number of repository to check out. Default is
HEAD, the most recent revision.
</p>
</dd>
<dt>
<code class="parameter">flags</code></dt>
<dd>
<p class="para">
Any combination of <strong><code>SVN_NON_RECURSIVE</code></strong> and
<strong><code>SVN_IGNORE_EXTERNALS</code></strong>.
</p>
</dd>
</dl>
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.svn-checkout-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
成功时返回 <strong><code>TRUE</code></strong> 或者在失败时返回 <strong><code>FALSE</code></strong>
</p>
</div>
<div class="refsect1 notes" id="refsect1-function.svn-checkout-notes">
<h3 class="title">注释</h3>
<div class="warning"><strong class="warning">Warning</strong><p class="simpara">此函数是<em class="emphasis">实验性</em>的。此函数的表象,包括名称及其相关文档都可能在未来的
PHP 发布版本中未通知就被修改。使用本函数风险自担 。</p></div>
</div>
<div class="refsect1 examples" id="refsect1-function.svn-checkout-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-5665">
<p><strong>Example #1 Basic example</strong></p>
<div class="example-contents"><p>
This example demonstrates how to check out a directory from
a repository to a directory named calc:
</p></div>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br />svn_checkout</span><span style="color: #007700">(</span><span style="color: #DD0000">'http://www.example.com/svnroot/calc/trunk'</span><span style="color: #007700">,&nbsp;</span><span style="color: #0000BB">dirname</span><span style="color: #007700">(</span><span style="color: #0000BB">__FILE__</span><span style="color: #007700">)&nbsp;.&nbsp;</span><span style="color: #DD0000">'/calc'</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
<div class="example-contents"><p>
The <em>dirname(__FILE__)</em> call is necessary in order
to convert the calc relative path into an absolute one. If calc
exists, you can also use <span class="function"><a href="realpath.html" class="function">realpath()</a></span> to retrieve
an absolute path.
</p></div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.svn-checkout-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="svn_add.html" class="function" rel="rdfs-seeAlso">svn_add()</a> - 计划在工作目录添加项</span></li>
<li class="member"><span class="function"><a href="svn_commit.html" class="function" rel="rdfs-seeAlso">svn_commit()</a> - 将修改的本地文件副本发送至版本库</span></li>
<li class="member"><span class="function"><a href="svn_status.html" class="function" rel="rdfs-seeAlso">svn_status()</a> - Returns the status of working copy files and directories</span></li>
<li class="member"><span class="function"><a href="svn_update.html" class="function" rel="rdfs-seeAlso">svn_update()</a> - Update working copy</span></li>
<li class="member"><a href="http://svnbook.red_bean.com/en/1.2/svn.ref.svn.c.checkout.html" class="link external">&raquo;&nbsp;SVN documentation on svn checkout</a></li>
</ul>
</p>
</div>
</div></div></div></body></html>