PHPFlüsterer

Amazon Product Widget Version 1.2.0

PHPFlüsterer — Fri, 20 Apr 2012 12:45:15 +0000

Soeben habe ich Version 1.2.0 des Amazon Product Widget(s) veröffentlicht. Neben kleineren Korrekturen wurden folgenden Anpassungen vorgenommen:

added support for Amazon China (CN) and Amazon Spain (ES)
added requirements-check. Now the plugin checks for example if “allow_url_open” is activated and shows a warning if the requirements are not fulfilled.
changed links to Amazons affiliate site(s) to SSL (https://)
changed label “AWS public key” to “AWS Access Key ID” and label “AWS private key” to “AWS Secret Access Key” (plugin configuration screen)

Das Plugin findet ihr wie gewohnt auf WordPress.org.

Lazyload.js – Annotation based Dependency Loader

PHPFlüsterer — Tue, 27 Mar 2012 18:42:03 +0000

Soeben hat Lazyload.js – ein leichtgewichtiger

Annotation based Dependency Loader

das Licht der Öffentlichkeit erblickt. Mit seinen schmalen 5,9 KB (in der minified Version) ist es gegenüber RequireJS ein Leichtgewicht bei ähnlichem Funktionsumfang. Eben der Vergleich mit RequireJS und der damit verbundenen Überraschung, dass es vom Funktionsumfang ähnlich, aber einfacher zu implementieren ist, hat mich dazu bewogen, es euch nicht vorzuenthalten.

Der besondere Vorteil von Lazyload.js (gegenüber anderen Ansätzen ist), das Abhängigkeiten (Dependencies) ganz einfach über Annotationen definiert werden können. Auf gleichem Wege lässt sich der verwendete Klassenpfad (Classpath), bis auf Klassenebene, definieren.

1
2
3
4
5
6
7
8

/**
* @classpath /Lab/Javascript/Lazyload.js/view/static/script/Js/Ui/Core/
* @dependency Provider.Feedback.AnbieterA,Provider.Feedback.AnbieterB
*/
function Feedback()
{
var _id = 'Feedback';
}

Lazyload.js verarbeitet dabei beliebig tief verschachtelte Bäume (Knoten) und löst die Abhängigkeiten rekursiv auf. Lazyload.js bietet ebenso ein objektorientiertes API wie eine prozedurale Schnittstelle.

Ein Beispiel für den Einbau mit OOP-Ansatz:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

// trigger for demonstrating href click -> instanciate loader -> async processing of dependencies and finally call
// the defined callback method
function triggerLazyload()
{
// get instance of Lazyload toolbox
var loader = new Lazyload.Tool.Loader({
'classpath': 'view/static/script/', // base path to classes
'provider': 'native', // can be either "native" for pure JS or "jquery" if jQuery is supported
'caching': true, // cache TRUE = just inlcude once - FALSE = reload on every request
'scope': window, // the global scope used for generic instanciation
'timeout': 1000, // the timeout for loading external resources in ms
'debug': { // controls the output
'enabled': true, // - enabled OR disabled
'logger': console.log // - output method/function (logger)
}
});

// and load the same way like with "require()"
loader.load(
'Js.Ui.Core.Feedback',
{'show': true,'autoload': false},
function(feedback){ alert(feedback.getAnbieter().getId()) }
);
}

Ein Beispiel für den prozeduralen Einbau:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21

// configure Lazyload.js require()-method
require().configure({
'classpath': 'view/static/script/', // base path to classes
'provider': 'native', // can be either "native" for pure JS or "jquery" if jQuery is supported
'caching': true, // cache TRUE = just inlcude once - FALSE = reload on every request
'scope': window, // the global scope used for generic instanciation
'timeout': 1000, // the timeout for loading external resources in ms
'debug': { // controls the output
'enabled': true, // - enabled OR disabled
'logger': console.log // - output method/function (logger)
}
});

// Load class "Feedback" from Namespace "Js/Ui/Core" => File "Js/Ui/Core/Feedback.js"
// and return an instance with paramters show:true and autoload:false
// pass this instance to callback-function
require(
'Js.Ui.Core.Feedback',
{'show': true, 'autoload': false},
function(feedback){ alert(feedback.getAnbieter().getId()) }
);

Ihr findet Lazyload.js (aktuell in Version 0.0.1) auf Github

Amazon Product Widget (WordPress Plugin)

PHPFlüsterer — Thu, 22 Mar 2012 16:02:02 +0000

Soeben habe ich das von mir entwickelte und auch selbst (hier im Blog) eingesetzte WordPress Plugin Amazon Product Widget auf Version 1.1 aktualisiert. Ab sofort ist es offiziell auch auf WordPress.org zu finden und wieder kompatibel zur Amazon AWS API. Die Amazon AWS API wurde zum 01. November 2011 leicht umgestellt wodurch das Plugin nicht mehr 100% kompatibel war.

Die User die sich das Plugin aus dem github-Repository gecloned haben, die sollten folgendes beachten:
Angepasst wurden (lediglich) die Readme(s) sowie Apw/Request.php und Apw/Data.php diese müssten auf jeden Fall ausgetauscht werden.

Wichtig!
Nach dem Update muss der Cache über die Konfigurationsseite zurückgesetzt werden.

Die jeweils aktuelle Version findet ihr entweder auf WordPress.org (http://wordpress.org/extend/plugins/amazon-product-widget/) oder auf github (https://github.com/clickalicious/Amazon-Product-Widget).

Grundlegende Regeln für gute Fehlermeldungen

PHPFlüsterer — Thu, 16 Feb 2012 09:18:17 +0000

Soeben musste ich bei der Integration einer Bibliothek mal wieder staunen. Die Bibliothek, auf die ich mich hier beziehe, zeichnet sich unter anderem durch einen guten Stil, eine durchgängige Dokumentation, sowie fast lückenlose Fehlerbehandlung aus. Deshalb ist es um so weniger verständlich, dass die eingesetzten Fehlermeldungen, die implementiert wurden, leider oft nicht aussagekräftig genug sind. Zusätzlich folgen die Fehlermeldungen keinem Schema. Sie erscheinen mir irgendwie schnell zusammengeschrieben (dieser Fehler wird im Übrigen oft begangen, wenn Fehlermeldungen im nachhinein schnell hinzugefügt werden!).

Man kann also hier schon feststellen:

Fehlermeldungen sind nur dann wirklich hilfreich, wenn diese von Anfang bis Ende, also von der Implementierung, bis hin zur Anzeige gut umgesetzt sind.

Man sollte diese so aussagekräftig wie möglich und so detailliert wie nötig gestalten. Hier ist ebenfalls zu unterscheiden welche Zielgruppe man adressiert. Beim Einsatz einer Bibliothek zur Herstellung einer gewissen Funktionalität, wäre die (erste) Zielgruppe, die Entwickler, die die Bibliothek einsetzen.

Folgende, einfache Regeln sollte man dabei beachten (ich beziehe mich hier lediglich auf den Inhalt der Fehlermeldungen – nicht die Stellen an denen, oder den Mechanismus mit dem, die Fehlermeldungen platziert werden), deshalb sollten die Fehlermeldungen:

einheitlich formatiert sein und somit ein einheitliches Erscheinungsbild haben
dem Schema: Fehler | Grund | [Auswirkung | Lösung] folgen, wobei Auswirkung und Lösung optional sind. Beispiel:
Fehler: “Datei kann nicht erstellt werden’”, Grund: “Es existiert schon eine Datei mit diesem Namen”, Auswirkung: “Konfiguration konnte nicht gespeichert werden”, Lösung: “Bitte löschen Sie die bestehende Datei bevor sie diese Aktion wiederholen”
kurz, prägnant und wohl formuliert sein
der Zielgruppe entsprechend detailliert sein

Wenn man sich bei den Fehlermeldungen an diese simplen, grundlegenden Regeln hält, wird man feststellen, dass ein wichtiger Schritt in Richtung “gute Fehlermeldungen” getan ist.

Habt ihr Ergänzungen zu den Regeln? Oder macht ihr es ganz anders und vielleicht sogar besser?
Dann nehmt doch an der Diskussion Teil und schreibt einen Kommentar.

Bücher

PHPFlüsterer — Mon, 09 Jan 2012 15:10:04 +0000

Nach einigen Jahren mit sehr interessanten Erfahrungen in der Software-Entwicklung, habe ich vor ca. einem Jahr mit dem Schreiben meines ersten Fachbuches begonnen. Mir lag die Qualität der Projekte an denen ich maßgeblich beteiligt bin, stets sehr am Herzen. Ein Stück Software zu schreiben, es zu testen und es Menschen zur Verfügung zu stellen, die damit entweder ihren Spaß haben, oder weniger nervige Arbeiten verrichten müssen, hat mich immer schon mit Freude und Stolz erfüllt. Umso wichtiger war es für mich, stets hochqualitative Arbeit abzuliefern und “möglichst” (ganz geht ja leider nicht) fehlerfreie Software zu produzieren und später in meinem Werdegang, produzieren zu lassen.

Mit steigendem Anspruch bezüglich Qualität, sowie immer knapper werdenden Terminen und somit entstehendem Termindruck bei gleichbleibendem Anspruch, galt es die Prozesse, die zu einer guten, unseren, sowie den Kundenansprüchen genügenden Software führen, fortlaufend zu optimieren. Neue Werkzeuge und Standards, sowie die stete Weiterentwicklung von PHP und den dazugehörigen Entwicklerwerkzeugen (z. B. IDEs) bieten viele Möglichkeiten und zeitgleich viele Fallen.

So habe auch ich selbst erlebt, wie schön es sein kann, mit neuen Prozessen die Dauer der Releasezyklen zu verkürzen ohne Einbuße bei der Qualität hinnehmen zu müssen. Aber eben auch einige Schattenseiten kennengelernt, so dass das ein oder andere Mal Nachtschichten notwendig waren, wenn man mal wieder Feuerwehr spielen musste (es fällt ein wenig leichter wenn man die Notwendigkeit der Nachtschichten selbst zu verantworten hat).

Meine Erfahrungen und die daraus gewonnenen Erkenntnisse, sowie Tipps und Empfehlungen schreibe ich aktuell in dem Buch mit dem Arbeitstitel “Qualität in Softwareprojekten” nieder.

Aktuelles Buchprojekt
Hier erfahrt ihr mehr zum aktuellen Buchprojekt “Qualität in Softwareprojekten”

Aktueller Stand

PHPFlüsterer — Mon, 09 Jan 2012 14:45:01 +0000

Während des letzten Jahres habe ich sehr viele neue Impulse aufgenommen und viele Theorien zur Qualität von Software gehört, Vorlesungen besucht, unzählige Bücher aus vielen Bereichen der Software-Entwicklung gelesen, sowie Diskussionen und anregende Unterhaltungen bei Conventions geführt.

Würde ich jetzt, nachden Ergebnissen des letzten Jahres, ein Resümee ziehen, dann würde ich wahrscheinlich ganz simpel formulieren:

Im Bereich der Software-Entwicklung wiederholt sich alles, geschätzt alle 5 – 10 Jahre nur heißt es immer anders …

Es ist ja auch kein Geheimnis, dass Theorien und Prozesse/Vorgehensweisen aus den End-Siebzigern noch heute verfeinert und Vergessenes sowie damals Belächeltes zu neuem Leben erweckt wird.

Zum aktuellen Zeitpunkt überarbeite ich die Kapitel die ich bisher verfasst habe um die Inhalte an die Entwicklung und Erkenntnisse aus dem letzten Jahr anzupassen. Bezüglich der weiteren Entwicklung und einem möglichen Veröffentlichungstermin halte ich euch selbstverständlich auf dem Laufenden.

XHProf für Windows (aktuelle Windows-Builds)

PHPFlüsterer — Fri, 06 Jan 2012 14:18:29 +0000

Hier findest du die aktuellen XHProf Windows-Builds. Ich bin bemüht, die Builds stets den aktuell verfügbaren PHP-Versionen anzupassen. Zum aktuellen Zeitpunkt PHP 5.3 und 5.4. Die NTS-Versionen (und 64 bit) bereiten mir momentan noch Probleme. Deshalb stelle ich momentan lediglich TS-Builds zum Download bereit. Wenn jemand die NTS-Version oder 64 bit erfolgreich kompiliert hat, dann wäre es super wenn er mich kurz kontaktieren würde.

Da es seit kurzem keine offiziellen VC6-Builds des PHP-Source mehr gibt, habe auch ich sämtliche Projektdateien auf VC9 umgestellt. Auf diesem Wege konnten sogar ohne zutun einige nicht ganz triviale Date/Time-Bugs in VC6 umgangen werden.

Aktuelle XHProf-Version: 0.10.2

Changelog

0.10.2
Aktuelle Änderungen aus dem Facebook Repository übernommen:
- PHP 5.4 Kompatibilität der Extension hergestellt
0.10.1
long-filename support: Möglichkeit hinzugefügt, den vollständigen Dateinamen anzeigen zu lassen (XHPROF_FLAGS_LONGNAMES)
Autor: smalyshev (Stanislav Malyshev)

Download
XHProf – 0.10.2 – PHP 5.3 VC9 TS (32 bit)
XHProf – 0.10.2 – PHP 5.3 VC9 TS (64 bit)
XHProf – 0.10.2 – PHP 5.3 VC9 (32 bit)
XHProf – 0.10.2 – PHP 5.3 VC9 (64 bit)
XHProf – 0.10.2 – PHP 5.4 VC9 TS (32 bit)
XHProf – 0.10.2 – PHP 5.4 VC9 TS (64 bit)
XHProf – 0.10.2 – PHP 5.4 VC9 (32 bit)
XHProf – 0.10.2 – PHP 5.4 VC9 (64 bit)

Willkommen zurück!

PHPFlüsterer — Wed, 04 Jan 2012 14:27:33 +0000

Nach knapp einem Jahr melde ich mich unter neuer Domain (phpfluesterer.de) und mit guten Nachrichten zurück. Während einer ausgiebigen “Auszeit”, in der ich quer durch die Welt gereist bin, viel gesehen, meditiert, sowie entspannt und das Leben genossen habe, wurden meine “Akkus” aufgefrischt und nun bin ich zurück im “Business” und so wie zuvor – voller Tatendrang.

Ganz abstinent war ich selbstverständlich nicht, findet man doch auch in den entlegensten Winkeln der Erde einen Internetzugang. Somit habe ich hier und da mal eine E-Mail geschrieben, meine Lieblingsseiten besucht und die Entwicklung im Bereich PHP passiv genossen.

Die Auszeit die ich mir, nach ca. 5 sehr anstrengenden und nervenzehrenden Jahren, selbst verhängt habe, kam genau zum richtigen Zeitpunkt. Sie hat dazu beigetragen, den Fokus auf spezielle Bereiche der Software-Entwicklung im PHP-Umfeld zu lenken und dieses wird sich auch hier auf meinen Seiten bemerkbar machen.

Neuer Fokus
Zeitgleich mit dem neuen Design, ändert sich auch offiziell der Fokus der von mir publizierten Inhalte. Primär befasse ich mich mit der Qualität von Software und der Optimierung von Entwicklungsprozessen und dabei haben (fast) alle Artikel stets einen Bezug zum PHP-Umfeld.

Die Kategorien
Die veröffentlichten Artikel lassen sich zu 99% in eine der (neuen) folgenden Kategorien einordnen:

Doch da ist auch noch der Bereich: “Beyond the Tellerrand”. Nicht immer lassen sich Grenzen so einfach ziehen und es wäre auch nicht angemessen immer einen harten Schnitt zu machen. Somit behalte ich mir hier mal vor, auch den Blick “Beyond the Tellerrand” für den ein oder anderen Artikel nicht ausser Acht zu lassen.

Eigene Projekte
Da ich in der Vergangenheit schon am ein oder anderen Projekt partizipiert und auch einige selbst initiiert habe, finden sich diese auch hier wieder. Zu diesen Projekten zählen z. B. die Windows-Version von XHProf, die moovrelocator-Klassen, Lazyload.js (kommt in Kürze) sowie das von mir entwickelte und selbst auch eingesetzte WordPress-Plugin (siehe Startseite) Amazon-Product-Widget. Ein Buchprojekt welches ich vor über einem Jahr begonnen habe wird in Kürze auch seinen Platz hier finden und ihr somit auch darüber auf dem Laufenden gehalten.

Sprache
In der Vergangenhit habe ich so oft zwischen deutsch und englisch hin- und hergewechselt, das keine klare Linie zu erkennen war. Nun, nach reichlich Überlegung und Auswertung der Besucherstatistiken, habe ich mich dazu entschieden, alle Kanäle nur noch in deutsch zu befüllen. Dabei spare ich mir dabei die Zeit für die Übersetzung (schließlich bekommt z. B. Google das auch ganz akzeptabel hin) und stecke die gesparte Zeit lieber in die Entwicklung oder in mein Buchprojekt. Schon jetzt absehbare Abweichungen werden z. B. ReTweets aus englisch-sprachigen Kanälen sein, da ich diese sicherlich nicht in die deutsche Sprache übersetzen werde. Ich hoffe, dass ich damit niemandem zu nahe trete. Anfragen bzw. E-Mails in englisch beantworte ich selbstverständlich a) weiter und b) selbstverständlich in englisch.

Merke
Neuer Fokus, regelmäßig neue Inhalte und ab sofort ausschließlich unter www.phpfluesterer.de zu erreichen

Source of XHProf 0.10.0 released

PHPFlüsterer — Sat, 11 Dec 2010 02:09:32 +0000

I’ve released the source some minutes ago! Everyone who’s interested in the source of the windows-compatible release can find the sources at my github repo for XHProf and maybe soon at the Facebook repo.

For the “old-school” user – here are the udiff patches for the two files:

1. php_xhprof.h:

1
2
3
4
5
6
7
8
9
10
11
12

25a26
> #include "win32/php_xhprof_win32.h"
33a35,37
> /**
> * PHP default module methods
> */
39a44,46
> /**
> * declare methods available in PHP
> */
45a53
>

and xhprof.c:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121

61a62,71
> #elif PHP_WIN32
> /*
> * Patch for compiling in Windows (i've used MS VC++ 6)
> * @author Benjamin Carl
> */
> # define CPU_SET(cpu_id, new_mask) (*(new_mask)) = (cpu_id + 1)
> # define CPU_ZERO(new_mask) (*(new_mask)) = 0
> # define SET_AFFINITY(pid, size, mask) SetProcessAffinityMask(pid, (*(mask)))
> # define GET_AFFINITY(pid, size, mask)
> GetProcessAffinityMask(GetCurrentProcess(), mask, &s_mask)
78c88
< #define XHPROF_VERSION "0.9.2"
---
> #define XHPROF_VERSION "0.10.0"
236c246
< static ZEND_DLEXPORT void (*_zend_execute) (zend_op_array *ops TSRMLS_DC);
---
> ZEND_DLEXPORT void (*_zend_execute) (zend_op_array *ops TSRMLS_DC);
239c249
< static ZEND_DLEXPORT void (*_zend_execute_internal) (zend_execute_data *data,
---
> ZEND_DLEXPORT void (*_zend_execute_internal) (zend_execute_data *data,
282a293,295
> static int restore_cpu_affinity(cpu_set_t * prev_mask);
> static int bind_to_cpu(uint32 cpu_id);
>
408a422
> unsigned long s_mask;
414a429
> #ifndef PHP_WIN32
415a431,434
> #else
> GetSystemInfo(&sysinfo);
> hp_globals.cpu_num = sysinfo.dwNumberOfProcessors;
> #endif
486c505,506
< int i;
---
> /* Note(bcarl): changed to uint32 like defined in struct -> hp_global_t */
> uint32 i;
488a509,511
> // duplicate call needed?
> get_all_cpu_frequencies();
>
490c513,514
< php_info_print_table_header(2, "xhprof", XHPROF_VERSION);
---
> php_info_print_table_row(2, "xhprof", "enabled");
> php_info_print_table_row(2, "xhprof version", XHPROF_VERSION);
493c517,521
< php_info_print_table_header(2, "CPU num", buf);
---
> php_info_print_table_row(2, "CPU num", buf);
> /* information about the cpu the process is bound to */
> len = snprintf(tmp, SCRATCH_BUF_LEN, " CPU %d ", hp_globals.cur_cpu_id);
> tmp[len] = 0;
> php_info_print_table_row(2, "process bound to", tmp);
501c529
< len = snprintf(tmp, SCRATCH_BUF_LEN, "%f", hp_globals.cpu_frequencies[i]);
---
> len = snprintf(tmp, SCRATCH_BUF_LEN, "%-.0f", hp_globals.cpu_frequencies[i]);
923,924d950
< int desc_len;
< char *desc;
1099,1101c1125,1127
< /* Update tv */
< tv->tv_sec = (time_in_micro / 1000000);
< tv->tv_usec = (time_in_micro % 1000000);
---
> /* Update tv Note(bcarl): added explicit typecasting (long) warning C4244 */
> tv->tv_sec = (long)(time_in_micro / 1000000);
> tv->tv_usec = (long)(time_in_micro % 1000000);
1184a1211,1219
>
> #ifdef PHP_WIN32
> __asm {
> cpuid
> rdtsc
> mov __a, eax
> mov __d, edx
> }
> #else
1185a1221,1222
> #endif
>
1230,1231c1267,1268
< start->tv_sec = incr/1000000;
< start->tv_usec = incr%1000000;
---
> start->tv_sec = (long)(incr/1000000);
> start->tv_usec = (long)(incr%1000000);
1270a1308,1309
> uint64 tsc_start;
> uint64 tsc_end;
1276c1315,1317
< uint64 tsc_start = cycle_timer();
---
>
> tsc_start = cycle_timer();
>
1284c1325,1327
< uint64 tsc_end = cycle_timer();
---
>
> tsc_end = cycle_timer();
>
1294c1337
< int id;
---
> uint32 id;
1519,1520d1561
< double gtod_value, rdtsc_value;
<
1532c1573
< hp_inc_count(counts, "wt", get_us_from_tsc(tsc_end - top->tsc_start,
---
> hp_inc_count(counts, "wt", (long)get_us_from_tsc(tsc_end - top->tsc_start,
1786,1787d1826
< zval *ret;
< char *out_url;

XHProf PHP-extension 0.10.0 – Windows-Build

PHPFlüsterer — Thu, 09 Dec 2010 16:09:54 +0000

I’ve recently finished version 0.10.0 of XHProf the PHP-Profiler published by Facebook. I’ve added the missing functionality for windows versions (e.g. getrusage(), SET_AFFINITY(), GET_AFFINITY()).

This Version is based on Version 0.9.2 beta (2009-06-01) from pecl. The extension was linked against php5ts.lib (PHP 5.3.3, VC++ 6, TS, Debug) and packed with UPX afterwards.

You can download the Extension here.

I will release the source at github as soon as i did enough tests. I would be nice to have your feedback as well to get a 100% working profiler!