PHPackages                             royalcms/temporary-directory - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. royalcms/temporary-directory

ActiveLibrary[Utility & Helpers](/categories/utility)

royalcms/temporary-directory
============================

The Royalcms temporary-directory package.

v5.0.0(6y ago)0531MITPHPPHP >=5.5.9

Since Sep 4Pushed 6y ago1 watchersCompare

[ Source](https://github.com/royalcms/royalcms-temporary-directory)[ Packagist](https://packagist.org/packages/royalcms/temporary-directory)[ Docs](http://royalcms.cn)[ RSS](/packages/royalcms-temporary-directory/feed)WikiDiscussions master Synced 3w ago

READMEChangelogDependenciesVersions (2)Used By (1)

Quickly create, use and delete temporary directories
====================================================

[](#quickly-create-use-and-delete-temporary-directories)

This package allows you to quickly create, use and delete a temporary directory in the system's temporary directory.

Here's a quick example on how to create a temporary directory and delete it:

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

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require spatie/temporary-directory
```

Usage
-----

[](#usage)

### Creating a temporary directory

[](#creating-a-temporary-directory)

To create a temporary directory simply call the `create` method on a `TemporaryDirectory` object. By default the temporary directory will be created in a timestamped directory in your system's temporary directory (usually `/tmp`).

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

### Naming your temporary directory

[](#naming-your-temporary-directory)

If you want to use a custom name for your temporary directory instead of the timestamp call the `name` method with a string `$name` argument before the `create` method.

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

By default an exception will be thrown if a directory already exists with the given argument. You can override this behaviour by calling the `force` method in combination with the `name` method.

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

### Setting a custom location for a temporary directory

[](#setting-a-custom-location-for-a-temporary-directory)

You can set a custom location in which your temporary directory will be created by passing a string `$location` argument to the `TemporaryDirectory` constructor.

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

Optionally you can call the `location` method with a `$location` argument.

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

### Determining paths within the temporary directory

[](#determining-paths-within-the-temporary-directory)

You can use the `path` method to determine the full path to a file or directory in the temporary directory:

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

### Emptying a temporary directory

[](#emptying-a-temporary-directory)

Use the `clean` method to delete all the files inside the temporary directory.

```
$temporaryDirectory->clean();
```

### Deleting a temporary directory

[](#deleting-a-temporary-directory)

Once you're done processing your temporary data you can delete the entire temporary directory using the `delete` method. All files inside of it will be deleted.

```
$temporaryDirectory->delete();
```

###  Health Score

25

—

LowBetter than 36% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

2484d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1106638?v=4)[Hao.Dongfang](/maintainers/royalwang)[@royalwang](https://github.com/royalwang)

---

Top Contributors

[![royalwang](https://avatars.githubusercontent.com/u/1106638?v=4)](https://github.com/royalwang "royalwang (1 commits)")

### Embed Badge

![Health badge](/badges/royalcms-temporary-directory/health.svg)

```
[![Health](https://phpackages.com/badges/royalcms-temporary-directory/health.svg)](https://phpackages.com/packages/royalcms-temporary-directory)
```

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)