getcwd

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

getcwdObtém o diretório atual

Descrição

getcwd(): string|false

Obtém o diretório atual.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o diretório atual em sucesso, ou false em falha.

Em algunmas variantes Unix, getcwd() irá retornar false se qualquer um dos diretórios-pai não tiver o modo leitura ou pesquisa definidos, mesmo se diretório atual tiver. Consulte chmod() para mais informação sobre modos e permissões.

Exemplos

Exemplo #1 Exemplo de getcwd()

<?php

// current directory
echo getcwd() . "\n";

chdir('cvs');

// current directory
echo getcwd() . "\n";

?>

O exemplo acima produzirá algo semelhante a:

/home/didou /home/didou/cvs

Notas

Cuidado

Se o interpretador PHP foi compilado com ZTS (Zend Thread Safety) habilitado, o diretório de trabalho atual retornado por getcwd() pode ser diferente do retornado pelas interfaces do sistema operacional. Bibliotecas externas (chamadas usando FFI) que dependem do diretório de trabalho atual serão afetadas.

Veja Também

  • chdir() - Muda o diretório
  • chmod() - Modifica as permissões do arquivo
To Top