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 caso de sucesso ou false em caso de 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

Example #1 Exemplo de getcwd()

<?php

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

chdir('cvs');

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

?>

O exemplo acima produzirá algo semelhante a:

/home/didou
/home/didou/cvs

Notas

Caution

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