Andreas Droesch » PHP

PHP: Dateien und Ordner auflisten

Andreas — Fri, 23 Oct 2009 21:12:14 +0000

Diese Funktion liest die Namen aller Dateien und Ordner in einem Verzeichnis ein und gibt diese in einem Array zurück, welches danach etwa mit einer Schleife aufgelistet werden kann.

Die Dateien können zusätzlich auf bestimmte Typen beschränkt und die Auflistung von Ordner deaktiviert werden.


php



// Dateien und Ordner aus einem Verzeichnis ermitteln

function list_dir($path, $extensions = '', $list_folder = false) {

  // Prüfen ob das Verzeichnis existiert

  if (!file_exists($path)) {

    return array();

  }



  // Liste erlaubter Erweiterungen erstellen

  if (!empty($extensions)) {

    $extensions = explode(',', $extensions);

  }



  // Pfad um Backslash am Schluss ergänzen

  $path = rtrim($path, '/') . '/';



  // Ordner öffnen und alle Einträge durchlaufen

  $dh = opendir($path);

  $list = array();

  while ($file = readdir($dh)) {

    $is_dir = is_dir($path . $file);

    // Ordner überspringen, falls nicht erwünscht

    if ((!$list_folder && $is_dir) ||

        // Sprungmarken überspringen

        ($file == '.' || $file == '..') ||

        // Unerwünschte Dateitypen überspringen

        ($extensions && !$is_dir &&

         !in_array(strtolower(substr(strrchr($file, '.'), 1)), $extensions))) {

      continue;

    }



    // Datei zur Liste hinzufügen

    $list[] = $file;

  }



  // Ordner schließen und Liste zurückgeben

  closedir($dh);

  return $list;

}



?>

Als Parameter erwartet die Funktion den Pfad des auszulesenden Verzeichnisses, relativ zum Script. Optional kann als zweiter Parameter eine Liste zugelassener Dateierweiterungen angegeben werden (einzelne Erweiterungen durch ein Komma trennen). Der dritte Parameter ist ebenfalls optional und aktiviert die Auflistung von Ordnern.

Nachfolgend noch ein paar Beispielaufrufe mit verschiedenen Optionen:


php



// Beispielaufruf 1: Alle Dateien

$path = 'uploads';

$files = list_dir($path);

echo '';

foreach ($files as $file) {

  echo '' . $file . '
';

}

echo '
';



// Beispielaufruf 2: Alle Dateien und Ordner

$files = list_dir($path, '', true);



// Beispielaufruf 3: Nur HTML und PHP Dateien

$files = list_dir($path, 'html,php');



// Beispielaufruf 4: Nur HTML und PHP Dateien, sowie Ordner

$files = list_dir($path, 'html,php', true);



?>

PHP: Monatskalender (per Table)

Andreas — Thu, 08 Oct 2009 17:56:47 +0000

In diesem kleinen Beispiel geht es um die Ausgabe aller Tage eines Monats als Kalenderansicht in einer Tabelle. Die spätere Ausgabe würde wie folgt aussehen:

Der Funktion kann optional ein bestimmter Monat mit Jahresangabe als Parameter übergeben werden, sonst wird der aktuelle Monat dargestellt:


php



// Kalender eines Monats erzeugen (per Table)

function show_calendar($month = 0, $year = 0) {

  // Timestamp für den gewählten Monat erzeugen, falls kein Datum angegeben wurde,

  // dann das aktuelle nehmen.

  $month_timestamp = ($month == 0 ? time() : mktime(12, 0, 0, $month, 1, $year));



  // Kopf der Tabelle

  $output = ''

          . ''

          . 'MoDiMiDoFr'

          . 'SaSo'

          . ''

          . '';



  // Ersten Wochentag des Monats ermitteln und bis dahin Leerzellen hinzufügen

  $first_day = date('w', $month_timestamp);

  $fill_count = ($first_day == 0 ? 6 : $first_day - 1);

  $output .= str_repeat(' ', $fill_count);



  // Monatstage auflisten

  $day_count = date('t', $month_timestamp);

  for ($i = 1; $i <= $day_count; $i++) {

    // Tageszelle einfügen

    $output .= '' . $i . '';



    // Neue Zeile nach 7 Spalten

    if (++$fill_count % 7 == 0) {

      $output .= '';

    }

  }



  // Letzte Reihe mit Leerzellen auffüllen

  while ($fill_count++ % 7 != 0) {

    $output .= ' ';

  }



  // Tabelle schließen

  $output .= ''

           . '';



  // Kalender zurückgeben

  return $output;

}



?>

Aufgerufen werden kann die Funktion wie folgt:


php



// Beispielaufruf 1: Aktueller Monat

echo show_calendar();



// Beispielaufruf 2: Vorgegebener Monat

echo show_calendar(1, 2009)



?>

PHP: HTML / XML Tag Attribute ermitteln

Andreas — Wed, 30 Sep 2009 19:43:40 +0000

Dieser Codesnippet war ursprünglich ein Beispiel aus einem Forum, wo es darum ging die Attribute aller Img-Tags aus einem HTML Code auszulesen.

Ich habe den Code noch etwas erweitert und nun kann er allgemein genutzt werden, um die Attribute beliebiger Tags aus HTML oder XML Dokumenten zu ermitteln.

Die Funktion erwartet zwei Parameter. Als ersten den zu durchsuchenden Code und als zweiten optional eine Einschränkung auf bestimmte Tagnamen:


php



// HTML/XML Tag Attribute ermitteln

function get_tag_attributes($code, $tag_search = false) {

  // Einzelnen Tagnamen in ein Array packen

  if ($tag_search && !is_array($tag_search)) {

    $tag_search = array($tag_search);

  }



  // Alle Tags auslesen

  $matches = array();

  preg_match_all('/<([a-z]*?) (.*?)\>/is', $code, $matches);



  // Funde durchlaufen und Attribute ermitteln

  $tags = array();

  foreach ($matches[1] as $key => $tag_name) {

    // Nicht zugelassene Tags überspringen

    if ($tag_search) {

      if (!in_array(strtolower($tag_name), $tag_search)) {

        continue;

      }

    }



    // Attribute austrennen

    $attributes = array();

    preg_match_all('/([a-z]*?)=(".*?"|\'.*?\')/is',

      $matches[2][$key], $attributes);



    // Attribute abspeichern

    $tag = array('tag' => $tag_name);

    foreach ($attributes[1] as $key => $value) {

      $tag[$value] = substr($attributes[2][$key], 1, -1);

    }

    $tags[] = $tag;

  }



  // Daten zurückgeben

  return $tags;

}



?>

Ein Aufruf zur Suche nach Img-Tags in einem HTML Dokument könnte wie folgt aussehen:


php



// HTML Code für die Beispielaufrufe

$html_code = <<< CODE_BLOCK





  Test







  



  



  

  Test





  Test







CODE_BLOCK;



// Beispielaufruf 1: Nur Img-Tags durchsuchen

$tags = get_tag_attributes($html_code, 'img');



// Array formatiert ausgeben

echo ''; print_r($tags); echo '
';



?>

Hier wurde als zweiter Parameter ein einzelner Tagname in einem String übergeben. Das zurückgegebene Array hat folgenden Aufbau:

Array

(

  [0] => Array

    (

      [tag] => img

      [src] => bild1.jpg

      [alt] => img1

      [style] => border:1px solid red

    )



  [1] => Array

    (

      [tag] => img

      [src] => bild2.jpg

      [alt] => img2

      [style] => border:1px solid green

    )

)

Alternativ kann als zweiter Parameter auch ein Array mit mehreren Tagnamen übergeben werden:


php



// Beispielaufruf 2: Nur Div- und P-Tags durchsuchen

$tags = get_tag_attributes($html_code, array('div', 'p'));



?>

Sollen alle Tags durchsucht werden, so wird der zweite Parameter einfach komplett weggelassen:


php



// Beispielaufruf 3: Alle Tags durchsuchen

$tags = get_tag_attributes($html_code);



?>

PHP: Datei- und Bildtyp ermitteln

Andreas — Mon, 21 Sep 2009 18:37:55 +0000

Wer beispielsweise mit Uploadformularen arbeitet oder Bilder durch eine PHP Datei weiterleitet kommt früher oder später an einen Punk, an welchem der entsprechende Dateityp der Datei ermittelt werden soll. Je nach Anwendungszweck gibt es verschiedenen Möglichkeiten die Dateierweiterung oder den MIME-Typ zu ermitteln:

MIME-Typ im $_FILES Array

Direkt nach dem Upload einer Datei stehen im $_FILES Array folgende Angaben zur Verfügung:

name: Originaler Dateiname der Datei
type: MIME-Typ der Datei
size: Größe in Bytes
tmp_name: Name unter welchem die Datei auf dem Server zwischengespeichert wurde
error: Statuscode des Uploadvorgangs

In type finden wir also den gesuchten MIME-Typ der Datei und können diesen weiterverarbeiten:


php



if ($_FILES['myUpload']['type'] == 'image/png') {

  // Nur PNG-Grafiken verarbeiten

  // ...

}



?>

MIME-Typ durch getimagesize()

Um den MIME-Typ bei Bildern auch im nachhinein noch zu ermitteln kann man die Funktion getimagesize() benutzen, welche folgende Daten zurück liefert:

0: Breite des Bildes
1: Höhe des Bildes
2: PHP spezifische Bildtyp Konstante
3: Maßangaben als HTML Attribut
mime: MIME-Typ der Datei

Hier finden wir unter mime den gesuchten Typen:


php



$file = 'bild.png';

$image_data = getimagesize($file);



if ($image_data['mime'] == 'image/png') {

  // Nur PNG-Grafiken verarbeiten

  // ...

}



?>

Kleiner Hinweis zu den gängigsten Bildtypen, neben image/png und image/gif muss für JPG Bilder immer image/jpeg, also die lange Form genutzt werden. Wer auf der sicheren Seite sein will fügt zusätzlich noch image/pjpeg seiner Abfrage hinzu. Das p steht für progressiv und gerade der IE sendet diesen Typ bei JPGs gerne mit. Hier noch eine kleine Kontrollabfrage als Beispiel:


php



// Erlaubte Bildtypen

$mime_list = array('image/jpeg', 'image/pjpeg', 'image/png', 'image/gif');



// Dateiupload auf gültigen Typ prüfen

if (!in_array($_FILES['myupload']['type'], $mime_list)) {

  echo 'Es sind nur Dateien vom Typ JPG, PNG und GIF erlaubt.';

} else {

  // Daten weiterverarbeiten

  // ...

}



?>

Erweiterung im Dateinamen

Soll dagegen die Dateierweiterung direkt ermittelt werden, so muss man den Dateinamen zerlegen:


php



// Dateierweiterung auslesen

function get_file_ext($filename) {

  return strtolower(substr(strrchr($filename, '.'), 1));

}



// Beispielaufruf

$file = 'download.zip';

echo get_file_ext($file); // = zip



?>

Die Funktion liefert immer die Erweiterung hinter dem letzten Punk in Kleinbuchstaben.

PHP: if-else mit dem Trinitäts-Operator

Andreas — Mon, 07 Sep 2009 20:14:46 +0000

Die ganz normale if-else -Bedingung ist sicher jedem geläufig, doch nicht jeder kennt den Trinitäts-Operator, welcher die Bedingung in manchen Fällen deutlich verkürzen kann.

Nachfolgend ein erstes Beispiel, bei welchem die aktuelle Uhrzeit ermittelt und eine passende Anrede ausgewählt wird:


php



// Uhrzeit ermitteln (Stunden ohne führende Null)

$time = date('G');



// Anrede ausgeben

if ($time < 18) {

  echo 'Guten Tag';

} else {

  echo 'Guten Abend';

}



?>

Nun kommt der Trinitäts-Operator “?” ins Spiel, dieser ist wie folgt aufgebaut:

(Bedingung ? wenn true : wenn false)

Auf das erste Beispiel bezogen würde dies nun so aussehen:


php



// Uhrzeit ermitteln (Stunden ohne führende Null)

$time = date('G');



// Anrede ausgeben

echo 'Guten ' . ($time < 18 ? 'Tag' : 'Abend');



?>

Zuerst kommt die Bedingung mit $time < 18, ist diese wahr (true), so wird der Code vor dem Doppelpunkt verarbeitet, andernfalls der hinter dem Doppelpunkt.

Hier noch ein zweites Beispiel zur Verdeutlichung. Eine kleine Funktion, welche die größere von zwei übergebenen Zahlen ermittelt (ähnlich der Standardfunktion max()). Zuerst die normale Schreibweise:


php



// Eigene Max-Funktion

function my_max($a, $b) {

  if ($a > $b) {

    return $a;

  } else {

    return $b;

  }

}



echo my_max(2, 5); // = 5



?>

Und hier die kürzere Fassung:


php



// Eigene Max-Funktion

function my_max($a, $b) {

  return ($a > $b ? $a : $b);

}



echo my_max(2, 5); // = 5



?>

PHP: Tageszahl zwischen zwei Daten

Andreas — Sat, 05 Sep 2009 15:19:02 +0000

Bei der Ermittlung der Tageszahl zwischen zwei Daten kann einem die kleinen Funktion gregoriantojd() sehr hilfreich sein. Diese wandelt ein Datum aus dem Gregorianischen Kalender (so wie wir ihn meist kennen) in ein Julianisches Datum um, welches ähnlich dem Timestamp ein Datum als Ganzzahl wiedergibt, jedoch nicht als Sekunden, sondern als Tage.

Die folgende Funktion erwartet zwei Daten als Parameter, wahlweise als Timestamp oder Datumsstring:


php



// Tageszahl zwischen zwei Daten ermitteln

function get_days_between($date1, $date2) {

  // Timestamp erzeugen, falls nicht gegeben

  if (!is_numeric($date1)) { $date1 = strtotime($date1); }

  if (!is_numeric($date2)) { $date2 = strtotime($date2); }



  // Daten in Julianisches Datum umwandeln

  $date1 = gregoriantojd(date('m', $date1), date('j', $date1), date('Y', $date1));

  $date2 = gregoriantojd(date('m', $date2), date('j', $date2), date('Y', $date2));



  // Differenz ermitteln und zurückgeben

  return ($date1 > $date2 ? $date1 - $date2 : $date2 - $date1);

}



?>

Ein Aufruf mit Timestamp könnte wie folgt aussehen:


php



// Beispielaufruf 1: Timestamp

$time1 = 1251756000; // 01.09.2009

$time2 = 1253829600; // 25.09.2009

echo 'Tagesdifferenz: ' . get_days_between($time1, $time2); // = 24



?>

Und mit einem normalen Datum in Textform:


php



// Beispielaufruf 2: Datumsstring

$time1 = '01.09.2009';

$time2 = '25.09.2009';

echo 'Tagesdifferenz: ' . get_days_between($time1, $time2); // = 24



?>