Installation

Wer keine Zeit oder Lust hat etwas über die Technik dahinter zu lesen, lädt sich alle Dateien bei GitHub herunter und schiebt sie in einen Ordner den er über seinen Webserver erreicht. Anschließend in der index.php den Zugang zur Datenbank und den Pfad zur lokalen phpMyAdmin Installation eintragen.

Fertig! Aber vorsicht: Es sind absolut keine Sicherheitsmaßnahmen vorhanden, eine Installation auf einem Server würde ich tunlichst vermeiden!!

Die Technik

Die komplette Seite besteht aus der index.php Datei. Im oberen Teil sind ein paar Einstellungen zu treffen. Darunter werden mit mysql_connect und mysql_list_dbs alle Datenbanken ausgelesen und in $db_list gespeichert. Die Funktion mysql_list_dbs gibt ein Objekt zurück das mit einer while() Schleife durchlaufen werden kann. In Kurzform:

Das eigentlich schöne passiert mal wieder mit jQuery: das geniale Plugin Quicksearch erlaubt das blitschnelle durchsuchen während der Eingabe. Das einzige was der Entwickler tun muss ist ein Formularfeld mit einer zu durchsuchenden Datenmenge (z.B. einer Tabelle) verknüpfen:

Damit das Formularfeld beim Aufruf der Seite den Fokus erhält erweitert man die Zeile noch um einen einfachen Aufruf:

Fazit

Nach dem der erste Schritt geschafft ist, drängen sich natürlich eine ganze Reihe weiterer Ideen auf:

• Navigation mit Pfeiltasten
• Automatische Vervollständigung
• Anlegen von neuen Datenbanken

Wer Lust hat mitzumachen, ist dazu herzlich auf GitHub herzlich eingeladen. Neue Ideen und Verbesserungsvorschläge gerne in den Kommentaren.

Und immer wieder sucht man die selben Begriffe und landet auf den gleichen Seiten, das hat mit diesem Eintrag ein Ende, wenn man ein mehrdimensionales Array mit einer eigenen Funktion sortieren will.

Anforderungen

In meinem Projekt stand ich vor folgendem Array:

$data = array(
  array('title' => 'Ape Unit', 'value' => '5'),
  array('title' => 'faf', 'value' => '1'),
  array('title' => 'Kiwi Service', 'value' => '3')
);

Aus diesen (dynamisch generierten) Daten wird ein Diagramm erzeugt. Die Daten kommen aus einer TYPO3 Extension, und das Diagramm wird ebenfalls über eine Extension eingebunden. Die Redaktion kann verschiedene Datensätze auswählen welche dargestellt werden sollen.

Da sich die Werte ständig ändern, das Corporate Design aber vorschreibt, dass der größte Wert immer am Anfang des Diagramms steht, landete also die Anfrage auf meinem Tisch die Datensätze nach ihrem Inhalt zu sortieren.

Erster Gedanke

Kein Problem, in PHP gibt es eine ganze Menge Funktionen um Arrays zu sortieren. Die Funktion usort erlaubt es eine benutzerdefinierte Funktion zum sortieren zu benutzen. Das sieht dann ungefähr so aus:

$data = array(); //siehe oben
function cmp($a, $b) {
  return $a['value'] > $b['value'] ? 1 : -1;
}
usort($data, 'cmp');

Funktioniert. Aber was wenn das Corporate Design beim nächsten Kunden vorschreibt das der niedrigste Wert als Erstes angezeigt werden soll? Und wir programmieren ja wiederverwendbare Objekte, also auf zum zweiten Gedanken.

Zweiter Gedanke

Die Sortierung passiert in einer Klasse welche beim Initialisieren eine Variable übergeben bekommt, die die Richtung anzeigt. An diese Variable kommt man aber gar nicht ohne weiteres ran, denn die User Function zum sortieren wird direkt vor dem Aufruf definiert oder muss eine statische Klasse vom Objekt sein.

Aber zum Glück gibt es auch hier eine Lösung, das Zauberwort, respektive die Zauberfunktion ist create_function. Mit der erstellt man onthefly eine PHP Funktion, die man dann wiederum usort als Parameter übergibt:

$cmp = create_function('$a, $b', 'if('.$order.' == 2) {
  return $a["value"] < $b["value"] ? -1 : 1;
}
if('.$order.' == 3) {
  return $a["value"] > $b["value"] ? -1 : 1;
}');
usort($table, $cmp);

Nett, oder? Das war eine schwere Geburt, und ich bin mir nicht sicher ob ich das Ergebnis perfekt finde. Wirklich schön sieht es im Code nicht aus. Vielleicht hat jemand eine bessere Idee?

Tja, einfach ist das natürlich nicht und jedes Programm erstellt andere CSV Dateien. Ich habe eine Funktion geschrieben die versucht automatisch zu erkennen wie eine CSV Datei aufgebaut ist. Hier ist eine Demo und im folgenden Artikel kommt die Funktionsweise.Die Funktion erwartet einen String, z.B.

"spalte1", "spalte2", "spalte3"

Array(  [delimiter] => ;   [enclosure] => ")

Hier kommt die komplette Funktion und anschließend ein paar erklärende Worte.

function csv_autodetect($string) {
  $str = trim($string);
  $char = '';
  $e = '';
  $d = array();
  $open = false;
  $strip = false;
  for($i = 0; $i < strlen($str); $i++) {
    $char = $str[$i];
    if(preg_match('=[\W]=', $char) && ord($char) != 32) {      
      if($i == 0)
        $e = $char;
      
      if($char == '\\')
        $strip = true;
      else
        $strip = false;
      
      if($char == $e && !$strip) {
        $open = $open ? false : true;
      }
      else {
        if(!$open && !$strip)
          $d[$char]++;
      }
    }
  }
  
  asort($d);
  $dd = array_keys($d, array_pop($d));
  $return['delimiter'] = $dd[0];
  $return['enclosure'] = $e;
  return $return;  
}

Nachdem einige Variablen vorbelegt wurden, erfolgt die zeichenweise Untersuchung des Strings. Wenn es sich um ein Sonderzeichen handelt, dann beginnt die Untersuchung.

if($i == 0)
  $e = $char;

if($char == '\\')
  $strip = true;
else
  $strip = false;

if($char == $e && !$strip)
$open = $open ? false : true;

if(!$open && !$strip)
  $d[$char]++;

Der Grund dafür ist das eventuelle Auftreten von Sonderzeichen in einer Spaltenbezeichnung ohne Enclosure (z.B. spalte1, spalte2&3, spalte4). Am Ende wird das Zeichen als Delimeter erwartet welches am häufigsten gefunden wurde. Das gibt zwar ein Problem bei einem String wie c&a, p&c, m&m - aber dann muss man seine Felder halt mit einem Zeichen umschließen.

Ende! Wer jetzt in seinem Kopf die Idee spinnt daraus ein Tool zu bauen welches CSV Dateien in eine Datenbank importiert, dem sei geraten noch ein paar Tage zu warten oder mir eine Mail zu schicken. Hab da was tolles in der mache was demnächst veröffentlicht wird .

Wer Ideen, Probleme und Verbesserungsvorschläge hat kann diese gerne in den Kommentaren los werden.

Herrlich und sehr einfach mit einer Schleife in JavaScript zu verändern. Aber wie um alles in der Welt kriegt man die Bar dazu den aktuellen Status einer langwierigen PHP Operation wider zu spiegeln?

Ich habe eine ganze Weile herumprobiert und das folgende ist dabei heraus gekommen. Hier ist die Demo und im Beitrag folgt die Beschreibung.

Vorüberlegungen

Was man in dieser Situation braucht ist eine Push-Funktion. Die Webseite soll eine Verbindung zu einem serverseitigen Script aufbauen und halten. Wenn sich bei dem Script etwas tut, dann kriegt die Seite bescheid und kann darauf reagieren. Opera unterstützt diese Funktion bereits, und sagt dazu Event Streaming to Web Browsers, aber leider zum Glück entwickeln wir Applikationen für alle Browser.

Es gibt eine PHP Klasse, die Progressbar von David Bongard, welche eine eigene Progressbar auf die Seite bringt. Die ist wirklich gut und funktioniert zuverlässig, aber hat zwei entscheidene Nachteile: Erstens sitzt der User immer vor einer unfertigen Seite (bis die Progressbar fertig geladen ist) und zweitens kann man damit nicht ohne weiteres die Progressbar des UI benutzen.

Erster Gedanke

Ich gucke mir die Funktionen von Davids Progressbar ab und greife per Ajax auf die dynamisch generierte Datei zu. In der steht dann, je nach Fortschritt, immer etwas anderes drin.
Nun wird die Ausgabe aber über flush() erzwungen, welches zwar eine Ausgabe erzeugt aber nicht dem Browser sagt, dass die Seite fertig geladen wurde.  Diese fehlende Information bringt jQuery dazu solange zu warten, bis alle Schritte ausgeführt wurden, also die Datei vollständig geladen ist und dann erst den Callback auszuführen. Funktioniert nicht, bzw. springt von Null auf Hundert.

Zweiter Gedanke

Im PHP Script muss eine neue Datei erzeugt werden, welche nur den aktuellen Fortschritt als Inhalt hat. Diese kann per jQuery abgefragt werden und das Ergebnis auf der Progressbar dargestellt werden.
Los gehts!

Das PHP Script

Das PHP Script sieht natürlich bei jedem anders aus. In der Demo ist es einfach nur eine Schleife mit einer Sleep-Anweisung.

  ob_start();
  $filename = 'remote-bar-'.$_GET['fn'].'.temp';
  for($i = 1; $i <= 10; $i++) {
    echo $i.'0<br>';
    ob_flush(); flush();
    $fh = fopen($filename, 'w');
    fwrite($fh, $i."0");
    fclose($fh);
    sleep(1);
  }
  
  unlink('remote-bar-'.$_GET['fn'].'.temp');

Der Parameter fn wird gleich per JavaScript gesetzt, damit nicht alle Benutzer in die gleiche Datei schreiben.

jQuery

Kurz angemerkt sei, dass im HTML ein Container mit der ID bar vorhanden sein muss, logisch oder? Der Rest ist mehr oder weniger dem aktuellen Layout geschuldet.

var res = 0;
var fn = Math.random(0, 999)+"";
fn = fn.substr(5, 10);

jQuery(function($) {
  $("#bar").progressbar({value: 0});
  $.ajax({
    url: "remote.php",
    type: "get",
    data: {fn: fn},
    success: function() {
      $("#watcher").html("Fertig!");
    }
  });
  get_remote();
});

function get_remote() {
  $.ajax({
    url: "remote-bar-"+fn+".temp",
    dataType: "text",
    ifModified: true,
    success: function(response) {
      $("#bar").progressbar('option', 'value', response);
      $("#watcher").html(response);
      if(response < 100)
        setTimeout("get_remote()", 100);
    }
  });
}

Das wars.

Fazit

In der Demo kann man sich das Resultat ansehen und ich bin gespannt ob der Server sofort zusammen bricht unter der Last eurer fleißigen und interessierten Tests. Außerdem bin ich mir unsicher, ob das ein sinnvolles Vorgehen war, denn wirklich effektiv scheint es mir nicht zu sein.

Aber es funktioniert und ist bestimmt für eine Applikation die nicht von mehreren Benutzern gleichzeitig aufgerufen werden kann (dazu demnächst mehr!). Wenn jemand einen Verbesserungsvorschlag hat, dann bin ich offen und dankbar dafür!

Bis dahin frohes ausprobieren und voranschreiten!

Anders als bei TYPO3 wird der Inhalt nicht über Marker in den HTML Code transportiert, sondern direkt über dynamischen PHP Code. Diese Art der Templates finde ich sehr gut, weil man auf verschiedene Bedingungen einfacher reagieren kann als, z.B. mit Typoscript.

Allerdings erfordern solche Templates auch mehr Konsequenz vom Entwickler, denn Präsentation und Logik gehören nicht vermischt.

Jetzt kommt eine Übersicht der praktischen Kurzschreibweisen zum Verwenden in eigenen Projekten, WordPress oder TYPOlight.

Ausgaben

Um Variablen auszugeben wird das = Zeichen benutzt.

<?=$welcome_msg?>

<? echo $welcome_msg; ?>

Bedingungen

Die gute alte If-Abfrage kann auf zwei Weisen dargestellt werden. Die erste ist für Fälle in denen mehr Inhalt ausgegeben werden soll.

<? if($user == "admin"): ?>
  Hallo <b>Admin</b>, hier sind deine <a href="#" class="admin">Optionen</a><br>
  <div id="status"><h1>Projektstatus</h1></div> <!-- usw. usf. -->
<? endif; ?>

Alternativen lassen sich darin natürlich auch einbauen

<? if($user == "admin"): ?>
  ... viele Ausgaben ...
<? elseif($user == "redakteur"): ?>
  --- andere Ausgaben ----
<? else: ?>
  ___ alternative Ausgaben ___
<? endif; ?>

Die zweite ist noch kürzer. Wenn man keine komplexen Ausgaben hat sondern nur, z.B. einzelne Worte ausgeben möchte

<?=$owner == $user ? "meins" : "fremd"?>

Die Syntax ist etwas gewöhnungsbedürftig, aber schnell gelernt: Der erste Block ist die Abfrage, sie wird beendet vom Fragezeichen welches auch gleichzeitig den Block einleitet der bei erfüllter Bedingung ausgeführt wird. Abgeschlossen und gleichbedeutend mit else folgt dann der Doppelpunkt und die Else-Anweisung. Alle Teile müssen vorhanden sein, sonst funktioniert es nicht.

Ausgeschrieben ist die Abfrage gleichbedeutend mit:

<? if($owner == $user) {
  echo "meins";
}
else {
  echo "fremd";
}

Ein praktisches Beispiel wäre z.B. innerhalb einer Schleife:

<li class="<?=$i%2 == 0 ? "even" : "odd"?>"><=$content?></li>

Gut, dann weiter mit

Schleifen

Die Syntax der Schleifen ist im Prinzip genau die selbe. Die For-Schleife:

<? for($i = 0; $i < 10; $i++): ?>
  Zeile <?=$i?> von 10
<? endfor; ?>

hat die gleiche Syntax wie die Foreach-Schleife:

<? foreach($array as $key => $value): ?>
  Array: <?=$key?> = <?=$value?><br>
<? endforeach; ?>

Und die While-Schleife darf natürlich auch nicht fehlen:

<? while($row = mysql_fetch_object($hdl)): ?>
  Zeile <?=$row->uid?> gehört <?=$row->name?><br>
<? endwhile; ?>

Fazit

Das waren Kurzschreibweisen in PHP. Sind schon sehr schmal und können für ein übersichtliches Template sorgen, wenn der fleißige Entwickler sich an die Einrückung hält und Logik mit Präsentation nicht vermischt wird. Frohes Nachdenken!

UPDATE: Aufgrund von unendlich vielen unverständlichen, russichen Spamkommentaren habe ich die Kommentare geschlossen. Bei Fragen einfach bei der Ape Unit GmbH melden.

Das Geheimnis liegt in meiner aktuellen Lieblingsfunktion strtotime($str). Diese versucht aus dem übergebenen String einen Timestamp zu machen. Das funktioniert nicht nur mit Daten (10.03.1985 oder 3/10/85) sondern auch mit relativen Angaben!!

for($i = 0; $i <= 10; $i++) {
  $timestamp = strtotime("-{$i} days");
  echo $timestamp." = ".date("d.m.Y", $timestamp). "<br>";
}

Das ist leicht zu verhindern! Um den Timestamp von -X Tagen von 0:00 bis 23:59 Uhr zu bekommen sind nur kleine Modifikationen nötig. Die Funktion strtotime() bekommt als zweiten Parameter einen Timestamp zugewiesen mit der aktuellen Uhrzeit. Es hilft: mktime().

for($i = 0; $i <= 10; $i++) {
  $start = strtotime("-{$i} days", mktime(0, 0, 01));
  $ende = strtotime("-{$i} days", mktime(23, 59, 59));
  echo "Von ".date("d.m.Y H:i", $start). " bis ".date("d.m.Y H:i", $ende)."<br>";
}

Die Timestamps kann man jetzt wunderbar benutzen um statistische Datenbankabfragen zu erstellen, E-Mails zu verschicken oder Textdateien zu speichern; der Entwicklung sind keine Grenzen gesetzt. Und um die Tücken vom Kalender kümmern sich andere Leute. Herrlich!

Kennt jemand eine bessere Lösung?

Prüfen ob Filter verfügbar sind

Die Funktionen um die es geht sind erst mit PHP 5 dazu gekommen. Deshalb ist vor dem Gebrauch zu überprüfen ob sie überhaupt zur Verfügung stehen:

if (!function_exists('filter_list')) {
  die('Sorry, dieses PHP ist zu alt.');
}

(Falls nicht, lassen wir die Filter einfach weg - haha)

Ach ja, und welche sind da?

Okay, wir sind nicht gestorben. Mit ein paar einfachen Zeilen können wir ausgeben welche Filter im System vorhanden sind:

$filters = filter_list();
foreach ($filters as $filter) {
  echo "- ".$filter."<br>";
}

Mit leuchtenden Augen entdecken wir dann Perlen wie int, email und url. Klingt schon mal gut.

Filter einsetzen

PHP bietet eine einfache Funktion um eine Variable zu überprüfen. Sie nennt sich filter_var($daten, FLAG). Die Variable ($daten) beinhaltet die zu überprüfenden Daten. Mit FLAG wird eine Konstante übergeben um anzusagen was geprüft wird. Hier ein einfaches Beispiel um die Eingabe auf ganze Zahlen zu überprüfen:

if(filter_var($_GET["input"], FILTER_VALIDATE_INT)) {
  echo "Es ist eine Zahl!";
}

Der letzte, mit Unterstrich getrennte Teil gibt den Filternamen an (siehe Liste oben). Mit FILTER_VALIDATE weisen wir die Funktion an die Variable zu überprüfen. Aber damit noch nicht genug!

Daten mit Hilfe von Filtern verändern

Es ist möglich die übergebenen Daten auch zu verändern. Dafür nehmen wir statt VALIDATE einfach SANITIZE. Ein Beispiel:

echo filter_var($_GET["input"], FILTER_SANITIZE_STRING);

Mit dieser Super-Funktion wird bei dem Aufruf

index.php?input=<script>alert("Böse!");</script>

nichts weiter als alert(\"Böse!\"); ausgegeben. Schön, nicht wahr?

Mehr Informationen

Das wars - sehr knapp zusammen gefasst um den ganzen Kram nicht zu vergessen. Ausführliche Informationen, und einen angekündigten zweiten Teil gibt es bei Devolio oder direkt im PHP Manual.