temporary directory

Cree, use y elimine rápidamente directorios temporales

Este paquete le permite crear, usar y eliminar rápidamente un directorio temporal en el directorio temporal del sistema.

Aquí hay un ejemplo rápido sobre cómo crear un directorio temporal y eliminarlo:

 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 ();

Apóyanos

Invertimos muchos recursos en la creación de los mejores paquetes de código abierto. Puedes apoyarnos comprando uno de nuestros productos pagos.

Agradecemos mucho que nos envíe una postal desde su ciudad natal, mencionando cuál de nuestros paquetes está utilizando. Encontrarás nuestra dirección en nuestra página de contacto. Publicamos todas las postales recibidas en nuestro muro virtual de postales.

Instalación

Puede instalar el paquete a través del compositor:

composer require spatie/temporary-directory

Uso

Creando un directorio temporal

Para crear un directorio temporal, simplemente llame al método create en un objeto TemporaryDirectory .

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

Alternativamente, use el método make estático en un objeto TemporaryDirectory .

TemporaryDirectory:: make ();

De forma predeterminada, el directorio temporal se creará en un directorio con marca de tiempo en el directorio temporal de su sistema (generalmente /tmp ).

Nombrar su directorio temporal

Si desea utilizar un nombre personalizado para su directorio temporal en lugar de la marca de tiempo, llame al método name con un argumento de cadena $name antes del método create .

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

De forma predeterminada, se generará una excepción si ya existe un directorio con el argumento dado. Puede anular este comportamiento llamando al método force en combinación con el método name .

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

Establecer una ubicación personalizada para un directorio temporal

Puede establecer una ubicación personalizada en la que se creará su directorio temporal pasando un argumento de cadena $location al constructor TemporaryDirectory .

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

El método make también acepta un argumento $location .

TemporaryDirectory:: make ( $ location );

Finalmente, puedes llamar al método location con un argumento $location .

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

Determinar rutas dentro del directorio temporal

Puede utilizar el método path para determinar la ruta completa a un archivo o directorio en el directorio temporal:

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

Vaciar un directorio temporal

Utilice el método empty para eliminar todos los archivos dentro del directorio temporal.

 $ temporaryDirectory -> empty ();

Eliminar un directorio temporal

Una vez que haya terminado de procesar sus datos temporales, puede eliminar todo el directorio temporal utilizando el método delete . Todos los archivos que contenga se eliminarán.

 $ temporaryDirectory -> delete ();

Eliminar un directorio temporal cuando se destruye el objeto

Si desea que el directorio del sistema de archivos se elimine automáticamente cuando la instancia del objeto no tenga más referencias en su alcance definido, puede habilitar deleteWhenDestroyed() en el objeto TemporaryDirectory.

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

    // ... use the temporary directory

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

handleTemporaryFiles ();

También puedes llamar unset() en una instancia de objeto.

Pruebas

composer test 

Registro de cambios

Consulte CHANGELOG para obtener más información sobre los cambios recientes.

Contribuyendo

Consulte CONTRIBUCIÓN para obtener más detalles.

Vulnerabilidades de seguridad

Revise nuestra política de seguridad sobre cómo informar vulnerabilidades de seguridad.

Tarjetas postales

Eres libre de utilizar este paquete, pero si llega a tu entorno de producción, te agradeceremos mucho que nos envíes una postal desde tu ciudad natal, mencionando cuál de nuestros paquetes estás utilizando.

Nuestra dirección es: Spatie, Kruikstraat 22, 2018 Amberes, Bélgica.

Publicamos todas las postales recibidas en el sitio web de nuestra empresa.

Créditos

• Alex Vanderbist
• Todos los contribuyentes

Licencia

La Licencia MIT (MIT). Consulte el archivo de licencia para obtener más información.