<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.dir.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'zh',
  ),
  'this' => 
  array (
    0 => 'function.getcwd.php',
    1 => 'getcwd',
    2 => '取得当前工作目录',
  ),
  'up' => 
  array (
    0 => 'ref.dir.php',
    1 => '目录函数函数',
  ),
  'prev' => 
  array (
    0 => 'function.dir.php',
    1 => 'dir',
  ),
  'next' => 
  array (
    0 => 'function.opendir.php',
    1 => 'opendir',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'zh',
    'path' => 'reference/dir/functions/getcwd.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.getcwd" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">getcwd</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">getcwd</span> &mdash; <span class="dc-title">取得当前工作目录</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.getcwd-description">
  <h3 class="title">说明</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>getcwd</strong></span>(): <span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   取得当前工作目录。
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.getcwd-parameters">
  <h3 class="title">参数</h3>
  <p class="para">此函数没有参数。</p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.getcwd-returnvalues">
  <h3 class="title">返回值</h3>
  <p class="para">
   成功则返回当前工作目录，失败返回 <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。
  </p>
  <p class="para">
   在某些 Unix 的变种下，如果任何父目录没有设定可读或搜索模式，即使当前目录设定了，<span class="function"><strong>getcwd()</strong></span>
   还是会返回 <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>。有关模式与权限的更多信息见 <span class="function"><a href="function.chmod.php" class="function">chmod()</a></span>。
  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.getcwd-examples">
  <h3 class="title">示例</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>示例 #1 <span class="function"><strong>getcwd()</strong></span> 例子</strong></p>
     <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #FF8000">// 当前目录<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">getcwd</span><span style="color: #007700">() . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">chdir</span><span style="color: #007700">(</span><span style="color: #DD0000">'cvs'</span><span style="color: #007700">);<br /><br /></span><span style="color: #FF8000">// 当前目录<br /></span><span style="color: #007700">echo </span><span style="color: #0000BB">getcwd</span><span style="color: #007700">() . </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
     </div>

     <div class="example-contents"><p>以上示例的输出类似于：</p></div>
     <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">/home/didou
/home/didou/cvs</pre>
</div>
     </div>
   </div>
  </p>
 </div>


 <div class="refsect1 notes" id="refsect1-function.getcwd-notes">
  <h3 class="title">注释</h3>
  <div class="caution"><strong class="caution">警告</strong>
   <p class="para">
    如果是启用 ZTS（Zend 线程安全）构建的 PHP 解释器，则 <span class="function"><strong>getcwd()</strong></span>
    返回的当前工作目录可能与操作系统接口返回的不同。当前工作目录的外部库依赖（通过
    <a href="book.ffi.php" class="link">FFI</a> 调用）可能会受到影响。
   </p>
  </div>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.getcwd-seealso">
  <h3 class="title">参见</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.chdir.php" class="function" rel="rdfs-seeAlso">chdir()</a> - 改变目录</span></li>
    <li><span class="function"><a href="function.chmod.php" class="function" rel="rdfs-seeAlso">chmod()</a> - 改变文件模式</span></li>
   </ul>
  </p>
 </div>

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