Zahlreiche Tools und PHP-Skripte ermöglichen zwar über die Google-Maps XML-API die Anfragen zu stellen, jedoch werden zu viele Daten und sehr verschachtelt über die XML-Struktur zurückgegebenen. Anhand dieser Kriterien (Zeitdruck, komplizierte API’s, …) wurde auf der Seite von www.favicate.de ein Google-Maps Tool veröffentlicht, welches sich mit der Ermittlung der Latitude und Longitude (Längen- und Breitengrad) befasst. Ausreichend zur Ermittlung der geographischen Länge sind Adressdaten in Form von „Straße und Hausnummer, Postleitzahl, Ort, Land“ oder noch einfacher die Eingabe eines bekannten Platzes oder Ortes. (zum Beispiel: Brandenburger Tor, Berlin)
Als optische Aufbereitung wird zu den Längen- und Breitengraden die Google-Maps-Karte via JavaScript geladen und zeigt die Zieladresse mit einem Marker (Pointer) an. Per Drag and Drop lassen sich die Koordinaten verändern und die Längen- und Breitengrade verändern sich automatisch. (on-the-fly). Für Webapplikation-Entwickler wurde ein Bereich eingerichtet, welcher die Daten direkt für die Copy & Paste-Funktion aufbereitet und direkt in eine Datenbank, kommasepariert, zur Verfügung stellt.

Erweiterungswünsche und Tipps sind immer herzlich willkommen.

Bildquelle: favicate.de, GoogleMaps-Karte (Stand: 14.06.2011)

CakePHP: the rapid development php framework

Umkreissuchen werden durch moderne Dienste wie Google-Maps auf Internetauftritten immer beliebter.
Gerade Unternehmen nutzen diesen Dienst gerne, um Partner oder Fachbetriebe in der Region für den Besucher optisch und auch bedienerfreundlich zu präsentieren. Da sich viele Programmierer an der Umkreissuche aufgrund der Längen- und Breitengrade scheuen, habe ich ein kleines Codesnippet aufbereitet.

Dieses Codesnippet benutze ich selbst bei meinen Umkreissuchen und die Abweichung ist recht gering. Die mySQL-Query ist ein Standard, der auch bei der OpenGeoDB und mySQL-Queries eingesetzt wird.
Das Framework CakePHP arbeitet auf dem Model-View-Controller-Prinzip und um diese Umkreissuche recht CakePHP-konform zu gestalten, habe ich mir die Mühe gemacht und die Fields, Conditions, Groups und Ergebnisse als Array aufzuteilen, sodass die Anpassung sehr einfach zu gestalten ist.

Auf www.codeblocks.de könnt ihr den Codesnippet für die Umkreissuche in CakePHP einsehen. Dort gehe ich auf ein Beispiel mit Firmen,  diese eine Postleitzahl und Längen- und Breitengrade enthalten, und der OpenGeoDB ein.

Sicherlich gibt es viele weitere Ansätze die Umkreissuche zu gestalten. - Dies soll nur als Beispiel und Hilfe für die Entwicklung einer Umkreissuche in CakePHP dienen.

Codesnippet als Plain-Text hier zum Download: Umkreissuche mit CakePHP gestalten (TXT-File)

Da die Kunden nicht immer über einen Managed- oder RootServer verfügen, ist es kaum möglich mit der CakePHP-Console zu arbeiten. Über die CakePHP-Console lassen sich Models, Views, Controller und auch die wichtigen Shells entwickeln.

Eine Shell ist dazu da, um kommandozeilenbaiserende Skripte zu schreiben, diese aber vom Benutzer entfernt bleiben.
Wie oben bereits angesprochen, z.B. die Datenvalidierung oder ein nächtlicher Export von Datensätzen als CSV-Datei.
Ein Export der Datenbank kann u.a. bei APIs oder Shopsystemen sehr vorteilhaft sein.

Um auch die CakePHP-Shell auf einem Shared-Host / Shared-Server via HTTP-Request ausführen zu können,
muss der PHP-Befehl "exec()" aktiviert sein. Darüber lassen sich in einem PHP-Skript diverse Kommandozeilen starten.

In unserem Fall auch die CakePHP-Shell und das als HTTP-Request.
Natürlich ist es wichtig, dass ihr eure PHP-Skripte dementsprechend vor Fremdeingriffe schützt.
Eine .htaccess Authentifizierung oder PHP_AUTH-Methode wäre hier angebracht. Viele Cronjob-Dienste können die HTTP-Requests auch mit einem Benutzernamen und Passwort übersenden. Das PHP-Modul cUrl macht es möglich.

Wie führe ich die CakePHP-Shell in einem PHP-Skript aus?
Beim Hoster all-inkl muss der exec()-Befehl vorher durch eine .htaccess mit " AddHandler php-fastcgi .php" Datei freigeschaltet werden.

Die Cronjob.php-Datei legt ihr in das Verzeichnis "/app/webroot/_cronjob/" ab.
Den Ordner "_cronjob" müsst ihr vorher anlegen. - Darin wird auch die "log.txt" geschrieben.

Bei " here_comes_the_vendors_shell_file" wird die CakePHP-Shell-Datei angegeben. Z.B.: csv_export, diese im Verzeichnis /app/vendors/shells/csv_export.php" liegt.

<?php
$app_dir = dirname(dirname(dirname(__FILE__))); // app Path
$cake_dir = dirname(dirname(dirname(dirname(__FILE__)))); // cake-core Path
$logfile = $app_dir."/webroot/_cronjobs/log.txt"; // Log-File Path define(RECEIVER,'email@domain.de');
define(EMAIL_SUBJECT, 'CakePHP SHELL Cronjob');

$command = "php ".$cake_dir."/cake/console/cake.php -app ".$app_dir."/ -core ".$cake_dir."/cake/ -i cake here_comes_the_vendors_shell_file > ".$logfile; // exec command with cakephp-shell exec($command);

// get log.txt content for e-mail-body
$msg = file_get_contents($logfile);
mail(RECEIVER,EMAIL_SUBJECT,$msg); // send mail to defined receiver
?>

Die Ausgabe der Shell wird in eine Datei umgelenkt und bei jedem Aufruf neu geschrieben.
Eine E-Mail an einen oben definierten Empfänger wird mit genau diesem Inhalt verschickt.

Wie führe ich die CakePHP-Shell auf einem Managed- oder RootServer aus?
Hierzu gibt es eine sehr ausführliche Dokumentation auf book.cakephp.org.

CakePHP: the rapid development php framework

Das Onlinemarketing-System Linklift für Textlinkverkäufe bietet eine PHP-Schnittstelle für die Integration der verkauften Textlinks auf dem eigenen Internetauftritt an.

Diverse Content-Management-Systeme werden dabei angeboten, jedoch keine Implementierungs-Hilfe für das Framework CakePHP. Da ich derzeit mit dem Framework CakePHP entwickel, musste ich eine Lösung des Problems finden.

Da CakePHP mit Models, Controllern, und Views arbeitet, lässt sich die standardgemäße "include /require" Variante nicht problemlos einsetzen.

Dafür gibt es in CakePHP die App:import-Variante. Eigentlich ist es ganz einfach eigene Vendor(s) / Plugins zu implementieren, jedoch hat Linklift leider schon eine automatisierte Initialisierung der PHP-Klasse und gibt nur noch per ECHO die Werte zurück. So besteht keine Möglichkeit mehr die Ausgabe in eine temporäre Variable zu speichern oder die Ausgabe zu beeinflussen.

Durch die Echo-Ausgabe wird in CakePHP die Darstellung des App-Vendors im Kopfbereich der Seite ausgegeben.
Dies ist denkbar ungünstig, wenn man z.B. die Ausgabe im Footerbereich des Internetauftritts haben möchte.

Meine Lösung ist nun die, dass ich mir die Linklift-PHP-Datei (Linklift-API) per App::import holte und diese direkt in den Footer meines Layouts ausgebe.

< ?php App::import('Vendor','linklift', array('file' => 'linklift.inc.php')); ?>

Im app/vendors/ Ordner liegt eine Datei namens "linklift.inc.php", worin sich der generierte Linklift Code befindet.
Da ich die Datei nicht jedesmal nach einem Update von Seiten Linklifts aktualisieren / anpassen möchte, style ich mir die Ausgabe später per CSS nach (!important - Anweisungen via CSS).
Sicherlich könnte die Ausgabe und Initialisierung der Linklift-Class händisch angepasst werden, jedoch wenn ein Update kommt, muss alles von Neuem angepasst werden. Daher die oben beschriebene Variante.

Die XML-Datei legt ihr in das "/app/webroot/"-Verzeichnis, da dieses als "Root-Verzeichnis" für eure Domain angesehen wird.

Vielleicht kann ich mit diesem kleinen Tipp die Integration von Linklift-Skripten erleichtern.

Wer noch weitere Möglichkeiten oder Tipps parat hat, kann sie mir gerne als Kommentar in diesem Beitrag hinterlassen.

Bildquelle: www.cakephp.org