htmlSQL - Version 0.5
=====================

htmlSQL ist eine experimentelle PHP Klasse mit der man auf HTML
Elemente über eine SQL ähnliche Syntax zugreifen kann. Das
bedeutet das man nicht mehr über komplizierte Funktionen
bestimmte Tags extrahieren muss, sondern einfach eine Query
wie diese ausführt:

    SELECT href,title   FROM  a   WHERE $class == "liste"
           ^ HTML Attrib.     ^         ^ Abfrage (kann auch leer sein)
             die zurück-      ^
             gegeben          ^ HTML Tags die durchsucht werden sollen
             werden sollen      "*" ist hier möglich = alle Tags

Diese Abfrage gibt einen Array aller Links mit dem Attribut class="liste"
zurück.

Alle HTTP Verbindungen in htmlSQL benützen die Snoopy Klasse
(Package Version 1.2.3 - URL: http://sourceforge.net/projects/snoopy/).
Allerdings wird Snoopy nicht für "file" oder "string" Queries benötigt.
Alle Snoopy betreffenden Dokumente (z.B: Copyright-Infos, Readme, usw.)
befinden sich im "snoopy_data/" Unterordner.


Installation / Anwendung
------------------------

Um htmlSQL in eigenen Projekten zu benützen ist es nur notwendig die
zwei Dateien "snoopy.class.php" und die "htmlsql.class.php" zu laden
(mit include oder z.B. require). Danach kann htmlSQL, wie in den
Beispielen (siehe examples/-Ordner), angesprochen werden. Dies sollte
nicht allzu schwer sein :-)


Hintergrund / Geschichte
------------------------

Ich hatte die Idee zu dieser Klasse als ich Daten von einer Web-Seite
extrahiert habe und dabei merkte das sich die Funktionen und Quelltexte
oftmals wiederholen. Da kam mir die Idee das ganze zu vereinfachen und
eine universelle Klasse dafür zu entwickeln.


Warnung
-------

Für die Abfragen wird die `eval()` Funktion benützt. Deshalb sollten alle
vom Besucher abhängige Daten wie z.b. IDs geprüft oder ggf. gefiltert
werden da es ansonsten möglich wäre schadhaften PHP Quelltext auszuführen.
Vertraue niemals Benutzereingaben!


Todo
----

- Den internen HTML Parser verbessern
- Ein eigenes Query system entwickeln und nicht das PHP eigene nutzen 
  (Die eval()-Lösung ist nicht wirklich schön)
- Mehr Fehlerprüfungen
- Unit tests
- LIMIT Funktion (wie in SQL)


Anwendungsgebiete von htmlSQL
-----------------------------

- Daten von anderen Web-Seiten auslesen
- HTML basierte Datenbanken?
- XML Daten auslesen


Author
------

- [Jonas John](http://www.jonasjohn.de/)


Lizenz
------

htmlSQL benützt eine modifizierte BSD Lizenz, welche ziemlich offen ist.
Der Lizenztext befindet sich in der "htmlsql.class.php".