temporary directory

Crie, use e exclua rapidamente diretórios temporários

Este pacote permite criar, usar e excluir rapidamente um diretório temporário no diretório temporário do sistema.

Aqui está um exemplo rápido de como criar um diretório temporário e excluí-lo:

 use Spatie  TemporaryDirectory  TemporaryDirectory ;

$ temporaryDirectory = ( new TemporaryDirectory ())-> create ();

// Get a path inside the temporary directory
$ temporaryDirectory -> path ( ' temporaryfile.txt ' );

// Delete the temporary directory and all the files inside it
$ temporaryDirectory -> delete ();

Apoie-nos

Investimos muitos recursos na criação dos melhores pacotes de código aberto. Você pode nos apoiar comprando um de nossos produtos pagos.

Agradecemos muito que você nos envie um cartão postal de sua cidade natal, mencionando qual(is) de nossos pacotes você está usando. Você encontrará nosso endereço em nossa página de contato. Publicamos todos os cartões postais recebidos em nosso mural virtual de cartões postais.

Instalação

Você pode instalar o pacote via compositor:

composer require spatie/temporary-directory

Uso

Criando um diretório temporário

Para criar um diretório temporário, basta chamar o método create em um objeto TemporaryDirectory .

( new TemporaryDirectory ())-> create ();

Como alternativa, use o método make estático em um objeto TemporaryDirectory .

TemporaryDirectory:: make ();

Por padrão, o diretório temporário será criado em um diretório com carimbo de data/hora no diretório temporário do seu sistema (geralmente /tmp ).

Nomeando seu diretório temporário

Se você quiser usar um nome personalizado para seu diretório temporário em vez do carimbo de data e hora, chame o método name com um argumento string $name antes do método create .

( new TemporaryDirectory ())
   -> name ( $ name )
   -> create ();

Por padrão, uma exceção será lançada se já existir um diretório com o argumento fornecido. Você pode substituir esse comportamento chamando o método force em combinação com o método name .

( new TemporaryDirectory ())
   -> name ( $ name )
   -> force ()
   -> create ();

Configurando um local personalizado para um diretório temporário

Você pode definir um local personalizado no qual seu diretório temporário será criado, passando um argumento de string $location para o construtor TemporaryDirectory .

( new TemporaryDirectory ( $ location ))
   -> create ();

O método make também aceita um argumento $location .

TemporaryDirectory:: make ( $ location );

Finalmente, você pode chamar o método location com um argumento $location .

( new TemporaryDirectory ())
   -> location ( $ location )
   -> create ();

Determinando caminhos dentro do diretório temporário

Você pode usar o método path para determinar o caminho completo para um arquivo ou diretório no diretório temporário:

 $ temporaryDirectory = ( new TemporaryDirectory ())-> create ();
$ temporaryDirectory -> path ( ' dumps/datadump.dat ' ); // return  /tmp/1485941876276/dumps/datadump.dat

Esvaziando um diretório temporário

Use o método empty para excluir todos os arquivos dentro do diretório temporário.

 $ temporaryDirectory -> empty ();

Excluindo um diretório temporário

Quando terminar de processar seus dados temporários, você poderá excluir todo o diretório temporário usando o método delete . Todos os arquivos dentro dele serão excluídos.

 $ temporaryDirectory -> delete ();

Excluindo um diretório temporário quando o objeto é destruído

Se você deseja que o diretório do sistema de arquivos seja excluído automaticamente quando a instância do objeto não tiver mais referências em seu escopo definido, você pode ativar deleteWhenDestroyed() no objeto TemporaryDirectory.

 function handleTemporaryFiles ()
{
    $ temporaryDirectory = ( new TemporaryDirectory ())
        -> deleteWhenDestroyed ()
        -> create ();

    // ... use the temporary directory

    return ; // no need to manually call $temporaryDirectory->delete()!
}

handleTemporaryFiles ();

Você também pode chamar unset() em uma instância de objeto.

Teste

composer test 

Registro de alterações

Consulte CHANGELOG para obter mais informações sobre o que mudou recentemente.

Contribuindo

Consulte CONTRIBUINDO para obter detalhes.

Vulnerabilidades de segurança

Revise nossa política de segurança sobre como relatar vulnerabilidades de segurança.

Cartões postais

Você é livre para usar este pacote, mas se ele chegar ao seu ambiente de produção, agradecemos muito que você nos envie um cartão postal de sua cidade natal, mencionando quais de nossos pacotes você está usando.

Nosso endereço é: Spatie, Kruikstraat 22, 2018 Antuérpia, Bélgica.

Publicamos todos os cartões postais recebidos no site da nossa empresa.

Créditos

• Alex Vanderbist
• Todos os colaboradores

Licença

A licença MIT (MIT). Consulte Arquivo de licença para obter mais informações.