temporary directory

Erstellen, verwenden und löschen Sie schnell temporäre Verzeichnisse

Mit diesem Paket können Sie schnell ein temporäres Verzeichnis im temporären Verzeichnis des Systems erstellen, verwenden und löschen.

Hier ist ein kurzes Beispiel, wie man ein temporäres Verzeichnis erstellt und löscht:

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

Unterstützen Sie uns

Wir investieren viele Ressourcen in die Erstellung erstklassiger Open-Source-Pakete. Sie können uns unterstützen, indem Sie eines unserer kostenpflichtigen Produkte kaufen.

Wir freuen uns sehr, dass Sie uns eine Postkarte aus Ihrer Heimatstadt schicken und erwähnen, welches unserer Pakete Sie verwenden. Unsere Adresse finden Sie auf unserer Kontaktseite. Wir veröffentlichen alle erhaltenen Postkarten auf unserer virtuellen Postkartenwand.

Installation

Sie können das Paket über Composer installieren:

composer require spatie/temporary-directory

Verwendung

Erstellen eines temporären Verzeichnisses

Um ein temporäres Verzeichnis zu erstellen, rufen Sie einfach die Methode create “ für ein TemporaryDirectory Objekt auf.

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

Alternativ können Sie die statische make Methode für ein TemporaryDirectory -Objekt verwenden.

TemporaryDirectory:: make ();

Standardmäßig wird das temporäre Verzeichnis in einem zeitgestempelten Verzeichnis im temporären Verzeichnis Ihres Systems erstellt (normalerweise /tmp ).

Benennen Sie Ihr temporäres Verzeichnis

Wenn Sie anstelle des Zeitstempels einen benutzerdefinierten Namen für Ihr temporäres Verzeichnis verwenden möchten, rufen Sie vor der Methode „ create “ die Methode name “ mit einem String-Argument $name auf.

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

Standardmäßig wird eine Ausnahme ausgelöst, wenn bereits ein Verzeichnis mit dem angegebenen Argument existiert. Sie können dieses Verhalten überschreiben, indem Sie die force -Methode in Kombination mit der name Methode aufrufen.

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

Festlegen eines benutzerdefinierten Speicherorts für ein temporäres Verzeichnis

Sie können einen benutzerdefinierten Speicherort festlegen, an dem Ihr temporäres Verzeichnis erstellt wird, indem Sie ein String-Argument „ $location an den TemporaryDirectory Konstruktor übergeben.

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

Die make -Methode akzeptiert auch ein $location Argument.

TemporaryDirectory:: make ( $ location );

Schließlich können Sie die location mit einem $location -Argument aufrufen.

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

Ermitteln von Pfaden innerhalb des temporären Verzeichnisses

Mit der path können Sie den vollständigen Pfad zu einer Datei oder einem Verzeichnis im temporären Verzeichnis ermitteln:

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

Leeren eines temporären Verzeichnisses

Verwenden Sie die empty Methode, um alle Dateien im temporären Verzeichnis zu löschen.

 $ temporaryDirectory -> empty ();

Löschen eines temporären Verzeichnisses

Sobald Sie mit der Verarbeitung Ihrer temporären Daten fertig sind, können Sie das gesamte temporäre Verzeichnis mit der delete löschen. Alle darin enthaltenen Dateien werden gelöscht.

 $ temporaryDirectory -> delete ();

Löschen eines temporären Verzeichnisses, wenn das Objekt zerstört wird

Wenn Sie möchten, dass das Dateisystemverzeichnis automatisch gelöscht wird, wenn die Objektinstanz keine weiteren Referenzen in ihrem definierten Bereich hat, können Sie deleteWhenDestroyed() für das TemporaryDirectory-Objekt aktivieren.

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

    // ... use the temporary directory

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

handleTemporaryFiles ();

Sie können unset() auch für eine Objektinstanz aufrufen.

Testen

composer test 

Änderungsprotokoll

Weitere Informationen zu den letzten Änderungen finden Sie im CHANGELOG.

Mitwirken

Weitere Informationen finden Sie unter BEITRAGEN.

Sicherheitslücken

Bitte lesen Sie unsere Sicherheitsrichtlinie zum Melden von Sicherheitslücken.

Postkartenartikel

Es steht Ihnen frei, dieses Paket zu verwenden, aber wenn es in Ihre Produktionsumgebung gelangt, würden wir uns sehr freuen, wenn Sie uns eine Postkarte aus Ihrer Heimatstadt schicken und erwähnen, welches unserer Pakete Sie verwenden.

Unsere Adresse lautet: Spatie, Kruikstraat 22, 2018 Antwerpen, Belgien.

Wir veröffentlichen alle erhaltenen Postkarten auf unserer Firmenwebsite.

Credits

• Alex Vanderbist
• Alle Mitwirkenden

Lizenz

Die MIT-Lizenz (MIT). Weitere Informationen finden Sie in der Lizenzdatei.