Changeset 4616

Timestamp:

09/07/10 21:10:11 (17 months ago)

Author:

vain

Message:

• added some lines to the dev manual

Location:

trunk/doc/manuals/developer/manual/de

Files:

• kapitel03-entwicklungseinstieg.asc (modified) (3 diffs)
• kapitel05-framework.asc (modified) (2 diffs)

trunk/doc/manuals/developer/manual/de/kapitel03-entwicklungseinstieg.asc

@@ -283 +283 @@
 In dieser Datei kann manuell der Vhost "ServerName clansuite-dev.com",
 sowie "ServerAlias www.clansuite-dev.com" hinzugefügt werden.
-Alternativ kann die Datei einfach mit der Version aus dem Clansuite SVN ersetzen.
+Alternativ kann man die Datei einfach mit der Version aus dem Clansuite SVN ersetzen.
 Die entsprechende Datei gibts hier: http://svn.gna.org/svn/clansuite/trunk/build-tools/xampp/httpd-vhosts.conf
+
+.Beispielinhalt für "httpd-vhosts.conf"
+[source, txt]
+---------------------------------------------------------------------
+NameVirtualHost *:80
+
+<VirtualHost *:80>
+     ServerName localhost
+     ServerAlias localhost
+     DocumentRoot "D:/xampplite/htdocs"
+     ErrorLog "D:/xampplite/apache/logs/localhost-error.log"
+     CustomLog "D:/xampplite/apache/logs/localhost-access.log" common
+
+     <Directory "D:/xampplite/htdocs">
+        Options Indexes FollowSymLinks
+        AllowOverride All
+        Order allow,deny
+        Allow from all
+    </Directory>
+</VirtualHost>
+
+<VirtualHost *:80>
+     ServerName clansuite-dev.com
+     ServerAlias www.clansuite-dev.com
+     DocumentRoot "D:/xampplite/htdocs/work/clansuite/trunk"
+     ErrorLog "D:/xampplite/apache/logs/www.clansuite-dev.com-error.log"
+     CustomLog "D:/xampplite/apache/logs/www.clansuite-dev.com-access.log" common
+
+     <Directory "D:/xampplite/htdocs/work/clansuite/trunk">
+        Options Indexes FollowSymLinks
+        AllowOverride All
+        Order allow,deny
+        Allow from all
+    </Directory>
+</VirtualHost>
+---------------------------------------------------------------------
 
 Damit das System diese URL auf den lokalen Server umleitet, muss noch die "hosts"-Datei
@@ -301 +337 @@
 
 Download
-Falls "php_xdebug.dll" nicht vorhanden ist, dann von http://xdebug.org/ downloaden.
+Falls "php_xdebug.dll" nicht vorhanden ist, dann kann man sie von http://xdebug.org/ downloaden.
 Entsprechend umbenennen und ins Verzeichnis "C:\xampplite\php\ext" ablegen.
+
+Um die richtige Binary für Xdebug zu finden kann auf die Projektwebseite zurückgegriffen werden.
+Unter http://www.xdebug.org/find-binary.php findet man ein Formular um den Inhalt der eigenen phpinfo() 
+Ausgabe zu posten. Nach der Auswertung der Versionsangaben der Serversoftware, wird die entsprechende 
+Xdebug-Binary und eine Installationsanleitung dafür angezeigt.
+
+.Tailored Installation Instructions for Xdebug
+[source, txt]
+---------------------------------------------------------------------
+Summary
+
+    * Xdebug installed: no
+    * Server API: Apache 2.0 Handler
+    * Windows: yes - Compiler: MS VC6 - Architecture: x86
+    * Zend Server: no
+    * PHP Version: 5.3.1
+    * Zend API nr: 220090626
+    * PHP API nr: 20090626
+    * Debug Build: no
+    * Thread Safe Build: yes
+    * Configuration File Path: no value
+    * Configuration File: D:\xampplite\php\php.ini
+    * Extensions directory: D:\xampplite\php\ext
+
+Instructions
+
+   1. Download php_xdebug-2.1.0-5.3-vc6.dll
+   2. Move the downloaded file to D:\xampplite\php\ext
+   3. Edit D:\xampplite\php\php.ini and add the line
+      zend_extension = D:\xampplite\php\ext\php_xdebug-2.1.0-5.3-vc6.dll
+   4. Restart the webserver
+---------------------------------------------------------------------
 
 XDebug in der php.ini einschalten
@@ -326 +394 @@
 Eine ausführliche Anleitung zum Thema "Wie installiere ich XDebug?" findet sich in Kapitel 16 (Der Webserver).
 
+.Xdebug-Einstellungen für Debugging mit Netbeans IDE
+[source, txt]
+---------------------------------------------------------------------
+# In der php.ini folgende Werte setzen:
+xdebug.idekey         = netbeans-xdebug
+xdebug.remote_enable  = on
+xdebug.remote_handler = dbgp
+xdebug.remote_host    = localhost
+xdebug.remote_port    = 9001
+---------------------------------------------------------------------
+
 ==== Einfache Texteditoren
 

trunk/doc/manuals/developer/manual/de/kapitel05-framework.asc

@@ -1147 +1147 @@
 ==== Clansuite_Cache
 
-Die Klasse Clansuite_Cache ermöglicht den Zugriff auf die verschiedenen Cache-Adapter.
+Die Klasse Clansuite_Cache ermöglicht die Zwischenspeicherung von Daten im Rahmen eines Applikations-Caches.
+Eine Zwischenspeicherung bietet sich bei Daten an, die in ihrer Herstellung rechenintensiv sind oder sehr
+häufig verwendet werden. Durch das Vorhalten im System sind sie bei Bedarf schnell erneut abrufbar. Dazu kann
+auf verschiedene Cache-Adapter zurückgegriffen werden. Die unterschiedlichen Cache-Adapter dienen einerseits
+dazu unterschiedliche PHP-Extensions zu unterstützen, andererseits aber auch dazu die Art und den Ort des
+Zwischenspeichers genauer zu bestimmem. Als Ablageorte kommen der Hautpspeicher und Festplatte in Betracht.
+
+.Überblick PHP Caching-Extensions
+Für PHP lassen sich inzwischen verschiedene Caching-Extensions finden.
+Anzuführend sind beispielsweise die Standardbibliotheken Alternative PHP Cache (APC) und WinCache,
+sowie eAccelerator, XCache, ionCube Loader (früher PHP Accelerator) und Zend Optimizer.
+Gemeinsam ist diesen Erweiterungen, dass sie in C implementiert sind und direkt an der ZendEngine ansetzen,
+um eine Leistungssteigerung zu bewirken. Die Leistungssteigerung bewirkt regelrechte Performcesprünge.
+Dabei sind Performcesprünge von 200% bis 500% durchaus mess- und beobachtbar.
+
+Zudem bewirkt der Einsatz dieser Caches, dass sich die Load des Webservers deutlich spürbar mindert.
+Der leistungssteigernde Caching-Effekt lässt sich durch einfaches Aktivieren der Erweiterung herbeiführen.
+In wenigen Fällen sind umfangreiche Konfigurationsmaßnahmen nötig, zumeist bewirkt schon der Betrieb mit
+Standardeinstellungen einen deutlichen Performaceboost.
+In der Regel ergibt sich kein Grund dafür, auf eine solche Erweiterung zu verzichten.
+Dennoch ist bei vielen Webhoster dieses Feature deaktivert und erst auf Nachfrage verfügbar.
+
+Das Gegenteil zu Caches, die als PHP-Extension eingebunden werden, sind die sogenannten Userland-Caches.
+Dabei handelt es sich um Caching-Verfahren die vom Nutzer selbst erstellt wurden und daher in PHP implementiert sind.
+Es lassen sich beispielsweise generierte Grafiken oder Rückgabewerte von Funktionsaufrufen zwischenspeichern.
+
+Sowohl ZendGuard, als auch ionCube Loader bieten neben der Caching-Funktionalität auch die Möglichkeit, den
+Sourcecode in einer geschützen, verschlüsselten Form abzulegen.
+Bei einem quellcode-offenen Produkt wie Clansuite, steht der Einsatz dieser Techniken aber außer Frage.
+
+.Überblick Caching-Mechanismen
+Grundsätzlich lassen sich mehrere Anknüpfungspunkte für Caching-Systeme in PHP finden.
+Zu den bekannteren Verfahren gehört das Opcode Caching.
 
 .Was macht ein OpCode-Cache?
-Normalerweise wird bei jedem Aufruf eines Skriptes zuerst das Skript kompiliert (es wird aus der Skriptsprache
-in Maschinencode überführt) und dann ausgeführt. Das kostet Zeit und verbraucht wertvolle Rechenleistung.
+Normalerweise wird bei jedem Aufruf eines PHP-Skriptes zuerst das Skript kompiliert (d.h. es wird aus der
+Skriptsprache in Maschinencode überführt) und dann ausgeführt. Das kostet Zeit und verbraucht wertvolle
+Rechenleistung. Dieses Verhalten ist eine Eigenart der in PHP geschriebenen Webanwendungen.
+Webanwendungen auf Basis anderer Architekturen, beispielsweise Java implementierte, halten die Anwendung
+und auch komplexe Objektmodelle und Daten persistent verfügbar (siehe Java-EE-Server; Enterprise JavaBeans).
+
 Verwendet man hingegen einen OpCode Cache, so wird ein Skript zuerst kompiliert und danach kompiliert im
-Speicher (shared memory / RAM) gehalten. Jeder weitere Aufruf des Skripts wird danach aus dem Speicher
-bedient und spart Kompilierungszeit.
+Speicher (shared memory / RAM) gehalten. Dieser "PHP Zwischencode" wird zumeist heftig optimiert abgelegt.
+Jeder weitere Aufruf des Skripts wird danach aus dem Speicher bedient und spart Kompilierungszeit. Man kann
+Programmquellcode, aber auch die zur Laufzeit des Programms anfallenden Dateninhalte, zumeist Variablen, im
+Cache ablegen.Wenn Variablen vom Nutzer im Cache abgelegt werden, spricht man vom User-Cache.
+
+Daneben gibt es weitere Caching-Mechanismen, beispielsweise das File Caching.
+Beim File Caching werden eine oder mehrere Dateien zusammengefasst und für einen schnelleren späteren Zugriff abgelegt.
+Des Weiteren gibt es das sogenannte "Resolve File Path Caching", hierbei kommt ein Mapping Verfahren zum Einsatz, bei dem
+für den relativen Dateipfade der jeweilige absolute Dateipfad abgelegt wird, so dass später eine erneute Pfadauflösung
+entfallen kann. Ein sogenannte "Session Handling Cache" legt die Sessiondaten, genau wie der User Cache, im Shared Memory ab.
 
 Der optimale Wert für die Größe des Cache-Speichers hängt natürlich vom tatsächlich verfügbaren RAM ab.
-Wer zu hohe Cachewerte einstellt, zwingt den Server möglicherweise dazu, andere Sachen auszulagern.
+Wer zu hohe Cachewerte einstellt, zwingt den Server möglicherweise dazu, andere Sachen aus dem Speicher auszulagern.
+
+Bevor in letzter Instanz auf die Leistungssteigerung durch einen vorkompilierenden Cache zurückgegriffen wird,
+sei allen Entwicklern geraten, zunächst die eigene Applikation und Datenbank auf den Prüfstand zu bringen,
+um Leistungsbremsen zu erkennen und zu beheben.
 
 .Instanzierung
@@ -1164 +1212 @@
 
 .Entwurfsmuster
+Als Entwurfsmuster kommt eine Fabrik zum Einsatz.
+Die Fabrik liefert lediglich den Cache-Adapter aus, den der Nutzer in der Konfiguration festgelegt hat.
 
 ===== Die Cache-Adapter
 
+Die Cache-Adapter sind dabei einfache Wrapper, die lediglich den Zugriff auf die Methoden der Caching-
+Extensions abstrahieren und standadisieren. Die Unterstützung für ein neues Caching-System ist durch
+einfaches Hinzufügen eines entsprechenden Adapters problemlos möglich.
+
 ====== Cache: APC
+
+Der Alternative PHP Cache (APC) ist ein Opcode Cache. Er cached und optimiert den PHP Quellcode und stellt ihn als
+"Zwischencode" bereit.
+
+http://php.net/apc
+http://pecl.php.net/package/APC
 
 ====== Cache: eAccelerator