Skip to content
This repository has been archived by the owner on Jan 28, 2021. It is now read-only.

Latest commit

 

History

History
executable file
·
83 lines (58 loc) · 2.51 KB

README-german.md

File metadata and controls

executable file
·
83 lines (58 loc) · 2.51 KB
Raw

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

Lizenz

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