Função rmdir

A função rmdir exclui o diretório especificado. O diretório deve estar vazio e o script deve ter permissão de gravação no diretório pai. A função aceita um parâmetro obrigatório - o caminho para o diretório.

Sintaxe

phprmdir(string $directory, resource $context = ?): bool

Exemplo

Excluindo um diretório vazio:

php<?php
  $dir = 'empty_folder';
  if (rmdir($dir)) {
    echo "Directory $dir was successfully removed";
  } else {
    echo "Failed to remove directory $dir";
  }
?>

Resultado da execução do código:

php'Directory empty_folder was successfully removed'

Exemplo

Tentativa de excluir um diretório não vazio:

php<?php
  $dir = 'non_empty_folder';
  if (@rmdir($dir)) {
    echo "Directory $dir was removed";
  } else {
    echo "Cannot remove $dir - directory is not empty";
  }
?>

Resultado da execução do código:

php'Cannot remove non_empty_folder - directory is not empty'

Exemplo

Verificando a existência do diretório antes da exclusão:

php<?php
  $dir = 'temp_folder';
  if (is_dir($dir)) {
    if (rmdir($dir)) {
      echo 'directory removed successfully';
    } else {
      echo 'failed to remove directory';
    }
  } else {
    echo 'directory does not exist';
  }
?>

Resultado da execução do código:

php'directory removed successfully'

Veja também

  • a função mkdir,
    que cria um diretório
  • a função unlink,
    que exclui um arquivo
  • a função scandir,
    que lê o conteúdo de um diretório