mitmario.dev

Verzeichnisse

PHP Sandbox 4 Min Lesezeit 5 BeispieleLektion 5 von 7

Sobald ein Ordner Uploads enthält, Protokolle oder Bilder, kennst du die Namen vorher nicht. Dann musst du fragen, was drinliegt. Ein Ordner heißt in PHP und im Handbuch Verzeichnis (englisch directory), daher die Namen scandir() und is_dir().

Was require tut

In den Beispielen dieser Lektion steht ganz oben require "vorbereiten.php". So eine Zeile steht seit Abschnitt 4 auch in den Aufgaben, und hier holt sie zwei kleine Dateien herein.

Was require hereinholt
<?php

declare(strict_types=1);

require "ort.php";
echo "Aus ort.php: ", $ordner, "\n";

$endungen = require "endungen.php";
echo "Aus endungen.php: ", implode(", ", $endungen), "\n";

echo "Und ohne return:\n";
var_dump(require "ort.php");

require nimmt eine andere PHP-Datei und führt sie aus, als stünde ihr Inhalt an dieser Stelle. Was die Datei an Variablen anlegt, ist danach da, im Beispiel $ordner aus ort.php. Endet die Datei mit return, gibt require diesen Wert zurück. Eine Zuweisung fängt ihn auf, so wie $endungen hier und die Werte in den Aufgaben von Abschnitt 5. Ohne return kommt eine 1 zurück.

Fehlt die Datei, bricht require das Programm ab, mit Failed opening required auf dem Fehlerkanal. In vorbereiten.php lege ich den Ordner daten/ samt Inhalt an, damit es überhaupt etwas aufzulisten gibt, und ohne diese eine Zeile stünde derselbe Code in jedem Beispiel noch einmal. Der Bruder include warnt bei einer fehlenden Datei nur und macht weiter, und den gibt es in Abschnitt 10.

scandir gibt dir alles, wirklich alles

Was scandir wirklich zurückgibt
<?php

declare(strict_types=1);

require "vorbereiten.php";

var_dump(scandir("daten"));

echo "Einträge insgesamt: ", count(scandir("daten")), "\n";

scandir() liefert eine Liste der Namen in einem Verzeichnis, sortiert nach den Bytes der Namen. Nur Namen, keine Pfade. Für Kleinbuchstaben ohne Umlaut ist das alphabetisch, sonst nicht. Zebra.txt steht vor apfel.txt, Äpfel.txt ganz hinten, und Ziffern liest es als Zeichen, also bild10.png vor bild2.png. Wo das stört, ordnet natsort() eine Ziffernfolge als Zahl.

Dazu kommen immer . und .., das Verzeichnis selbst und das darüber. Bei gewöhnlichen Namen stehen sie ganz vorn. Sortierst du sie nicht aus, versucht dein Programm früher oder später, sie als Datei zu lesen. ls -a daten zeigt sie an erster Stelle, ls daten lässt sie weg, und in PHP triffst du diese Auswahl selbst.

Loswerden kannst du sie mit einem continue ganz oben in der Schleife, wie beim Überspringen in Abschnitt 4. Oder mit array_diff($liste, [".", ".."]), das die erste Liste ohne alles zurückgibt, was in der zweiten steht.

glob nimmt ein Muster

glob nimmt ein Muster
<?php

declare(strict_types=1);

require "vorbereiten.php";

echo "Nur die Textdateien:\n";
var_dump(glob("daten/*.txt"));

echo "\nAlles, was drinliegt:\n";
var_dump(glob("daten/*"));

glob() sucht die Pfade, die auf ein Muster passen. Der Stern steht für beliebig viele Zeichen, das Fragezeichen für genau eines.

Drei Unterschiede zu scandir zählen im Alltag:

  • glob gibt Pfade zurück, nicht bloße Namen. daten/liste.txt statt liste.txt. Das ist meist praktischer, denn damit kannst du sofort weiterarbeiten.
  • . und .. sind nicht dabei. Das Muster passt nicht auf sie.
  • Ein Muster wie *.txt sortiert Verzeichnisse gleich mit aus, jedenfalls solange keines auf .txt endet. Ohne Muster, also mit daten/*, sind sie wieder dabei.

Das Muster ist dasselbe wie in der Shell. ls daten/*.txt im Terminal zeigt dieselben drei Pfade, nur löst dort die Shell den Stern auf, bevor ls überhaupt läuft.

Ordner aussieben

Zählen, was im Ordner liegt
<?php

declare(strict_types=1);

require "vorbereiten.php";

$dateien = 0;
$ordner = 0;

foreach (scandir("daten") as $eintrag) {
    if ($eintrag === "." || $eintrag === "..") {
        continue;
    }

    if (is_dir("daten/" . $eintrag)) {
        $ordner++;
        echo "Ordner: ", $eintrag, "\n";
        continue;
    }

    $dateien++;
    echo "Datei:  ", $eintrag, "\n";
}

echo "\n", $dateien, " Dateien und ", $ordner, " Ordner\n";

Ob ein Eintrag ein Verzeichnis ist, beantwortet is_dir(). Die Funktion braucht dafür den vollen Pfad und nicht den Namen aus scandir. is_dir("archiv") sucht im Arbeitsverzeichnis und findet nichts, is_dir("daten/archiv") findet den Ordner.

Diese Verwechslung ist besonders unangenehm, denn is_dir sagt einfach false und sonst nichts. Dein Programm behandelt den Ordner dann als Datei.

Zählst du beim Durchgehen mit, hast du am Ende eine Zuordnung von Endung auf Anzahl. Die willst du meistens nach der Anzahl sortiert ausgeben, und dafür gibt es arsort(). Es sortiert absteigend nach dem Wert und lässt die Schlüssel dran, wie asort() aus dem Abschnitt über Arrays, nur andersherum. Die größte Anzahl steht dann oben.

Zusammengesetzt wird ein Pfad mit dem Punkt, der Texte verbindet, also $ordner . "/" . $eintrag. Der Schrägstrich funktioniert auch unter Windows, ein Backslash umgekehrt nicht überall.

Namen zerlegen

Namen zerlegen
<?php

declare(strict_types=1);

$pfad = "daten/archiv/alt.txt";

echo "basename:      ", basename($pfad), "\n";
echo "dirname:       ", dirname($pfad), "\n";
echo "ohne Endung:   ", basename($pfad, ".txt"), "\n\n";

var_dump(pathinfo($pfad));

echo "\nNur die Endung: ", pathinfo("archiv.tar.gz", PATHINFO_EXTENSION), "\n";

echo "Und bei einer Datei ganz ohne Punkt:\n";
var_dump(pathinfo("liesmich", PATHINFO_EXTENSION));

Für das Zerschneiden von Pfaden gibt es drei Funktionen:

  • basename() gibt den Dateinamen ohne Verzeichnis. Mit einem zweiten Argument schneidet es zusätzlich die Endung (englisch extension) ab.
  • dirname() gibt das Verzeichnis ohne Dateinamen. vorbereiten.php benutzt es in den Beispielen, um den Ordner anzulegen.
  • pathinfo() gibt alles auf einmal als Zuordnung mit dirname, basename, extension und filename. Mit einer Konstante als zweitem Argument bekommst du nur ein Feld.

Bei archiv.tar.gz ist die Endung gz und nicht tar.gz, denn pathinfo schneidet am letzten Punkt. Und bei einer Datei ganz ohne Punkt bekommst du einen leeren Text zurück, keinen Fehler.

Eine Endung ist nur ein Teil des Namens. Was wirklich in der Datei steht, sagt sie nicht. Verlässt du dich beim Hochladen darauf, hast du eine Lücke, und um die geht es in Abschnitt 11.

In der Aufgabe zählst du die Dateien in daten/ nach ihrer Endung.

Zum Mitnehmen

require führt eine andere PHP-Datei aus und gibt zurück, was sie mit return liefert. scandir liefert die Namen eines Verzeichnisses samt . und .., nach Bytes sortiert, glob die Pfade, die auf ein Muster passen. is_dir braucht den ganzen Pfad, und pathinfo schneidet die Endung am letzten Punkt.

Jetzt du

Basis Konto, kostenlos

Zu dieser Lektion gehört eine Aufgabe. Du schreibst den Code selbst, und nach jedem Lauf sagt dir eine Prüfliste, was schon stimmt.

Dafür brauchst du das Basis Konto. Es kostet nichts, und ein Passwort gibt es auch nicht.

In diesem Kurs läuft dein Code auf einem Server. Dafür hat das Basis Konto 1 Stunde im Monat, mehr Zeit gibt es mit dem Premium Konto.

Was in dieser Lektion steckt

  • Artikel mit 5 Beispielen zum Ausprobieren

    Steht hier, ohne Konto lesbar.

  • Aufgabe, dein Code läuft auf einem Server

    Öffnet sich mit dem Basis Konto.