array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.chdir.php', 1 => 'chdir', 2 => 'Muda o diretório', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Funções de Diretórios', ), 'prev' => array ( 0 => 'ref.dir.php', 1 => 'Funções de Diretórios', ), 'next' => array ( 0 => 'function.chroot.php', 1 => 'chroot', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/dir/functions/chdir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

chdir

(PHP 4, PHP 5, PHP 7, PHP 8)

chdir — Muda o diretório

Descrição

chdir(string $directory): bool

Muda o diretório atual do PHP para directory.

Parâmetros

directory

O novo diretório atual

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Erros/Exceções

Dispara um aviso E_WARNING em caso de falha.

Exemplos

Exemplo #1 Exemplo de chdir()

<?php

// diretório atual
echo getcwd() . "\n";

chdir('public_html');

// diretório atual
echo getcwd() . "\n";

?>

O exemplo acima produzirá algo semelhante a:

/home/vincent
/home/vincent/public_html

Notas

Cuidado

Se o interpretador PHP foi compilado com ZTS (Zend Thread Safety) habilitado, quaisquer mudanças ao diretório atual através de chdir() serão invisíveis ao sistema operacional. Todas as funções internas do PHP ainda irão respeitar a mudança do diretório atual; mas funções de bibliotecas externas, chamadas usando FFI não irão. Pode-se verificar se a cópia do PHP foi compilada com ZTS habilitado usando o comando php -i ou a constante interna PHP_ZTS.

Veja Também