Abschnitt 8 · Lektion 5
Verzeichnisse
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.
<?php
declare(strict_types=1);
$ordner = "daten"; <?php
declare(strict_types=1);
return ["txt", "md", "json"]; <?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
<?php
declare(strict_types=1);
// Legt den Ordner daten/ mit ein paar Dateien an, damit es
// etwas aufzulisten gibt. Aendern musst du hier nichts.
$inhalte = [
"daten/anleitung.md" => "## So geht es",
"daten/einstellungen.json" => '{"sprache":"de"}',
"daten/liesmich.md" => "# Ordner daten",
"daten/liste.txt" => "Eins\nZwei\nDrei",
"daten/notizen.txt" => "Milch, Brot, Kaffee",
"daten/protokoll.txt" => "Start",
"daten/archiv/alt.txt" => "Alter Kram",
];
foreach ($inhalte as $pfad => $inhalt) {
if (!is_dir(dirname($pfad))) {
mkdir(dirname($pfad), recursive: true);
}
file_put_contents($pfad, $inhalt);
} <?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
<?php
declare(strict_types=1);
// Legt den Ordner daten/ mit ein paar Dateien an, damit es
// etwas aufzulisten gibt. Aendern musst du hier nichts.
$inhalte = [
"daten/anleitung.md" => "## So geht es",
"daten/einstellungen.json" => '{"sprache":"de"}',
"daten/liesmich.md" => "# Ordner daten",
"daten/liste.txt" => "Eins\nZwei\nDrei",
"daten/notizen.txt" => "Milch, Brot, Kaffee",
"daten/protokoll.txt" => "Start",
"daten/archiv/alt.txt" => "Alter Kram",
];
foreach ($inhalte as $pfad => $inhalt) {
if (!is_dir(dirname($pfad))) {
mkdir(dirname($pfad), recursive: true);
}
file_put_contents($pfad, $inhalt);
} <?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:
globgibt Pfade zurück, nicht bloße Namen.daten/liste.txtstattliste.txt. Das ist meist praktischer, denn damit kannst du sofort weiterarbeiten..und..sind nicht dabei. Das Muster passt nicht auf sie.- Ein Muster wie
*.txtsortiert Verzeichnisse gleich mit aus, jedenfalls solange keines auf.txtendet. Ohne Muster, also mitdaten/*, 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
<?php
declare(strict_types=1);
// Legt den Ordner daten/ mit ein paar Dateien an, damit es
// etwas aufzulisten gibt. Aendern musst du hier nichts.
$inhalte = [
"daten/anleitung.md" => "## So geht es",
"daten/einstellungen.json" => '{"sprache":"de"}',
"daten/liesmich.md" => "# Ordner daten",
"daten/liste.txt" => "Eins\nZwei\nDrei",
"daten/notizen.txt" => "Milch, Brot, Kaffee",
"daten/protokoll.txt" => "Start",
"daten/archiv/alt.txt" => "Alter Kram",
];
foreach ($inhalte as $pfad => $inhalt) {
if (!is_dir(dirname($pfad))) {
mkdir(dirname($pfad), recursive: true);
}
file_put_contents($pfad, $inhalt);
} <?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
<?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.phpbenutzt es in den Beispielen, um den Ordner anzulegen.pathinfo()gibt alles auf einmal als Zuordnung mitdirname,basename,extensionundfilename. 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, kostenlosZu 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.