A long time in coming… but surely worth the wait!

Highlights include: certified support for Oracle (by yours truly) and Solaris, new webdav implementation, much improved caching mechanism for high traffic conditions, more flexible workflows via custom object states.

More info here: http://ez.no/developer/news/ez_publish_4_1_0_released

It just felt soo long since I had last hacked on anything xmlrpc-related, and some part of me was looking for an itch to scratch.
Luckily today a request for help via email set me on a hunt for blog posts / forum posts / mailing list messages where complete newbies ask questions about the phpxmlrpc lib not working for them. Of course they post there instead of the correct mailing list because in fact they have trouble setting up their favourite php application. Heck, they probably do not even know what phpxmlrpc is.
To make a long story short, I ended up looking at the code of a poorly-written dotproject xmlrpc plugin, and wondering why the mantis bugtracker has such a nice and clean soap interface but has no xmlrpc one.
And since it was late evening – the best time to code, when there are no distractions coming in over the phone or chat or email – and home alone, I just sat in the front of the keyboard decided to put and end to that last shameful situation.

For everybody who needs it ot just wants to test it, here it is: the Mantisconnect XMLRPC Interface, rev. 0.1

In Italian, of course.

I first and foremost have to thank Derick and Toby for the inspiration.

| View | Upload your own

| View | Upload your own

I’m off to the beautiful mediterranean seaside, for two days of hacking, sharing and (hopefully) partying on the beach.
For anybody interested, the official website is www.phpday.it

As they would say on /. : Frist Post!!!

http://ez.no/developer/news/ez_publish_4_0_0_and_ez_flow_1_0_released

And frist bug too: the very first enhancement listed in the changelog was reported by yours truly.

Congrats to all the people involved in making this happen!

Great times ahead, as the php4-unencumbered codebase will be able to improve faster than ever.

There are just a couple of minor annoyances with the Xdebug PHP debugger really, the first one being the absence of a proper documentation package to be downloaded and read offline.

I find well-commented ini files, in the Apache httpd.conf style, the best complement to user manuals and technical references: when you are editing the forgotten config of that vetust server that has no web access or even ssh whatsoever, awkwardly sitting on an unstable pile of extinguished hardware in the darkest corner of the server room, they will save you dozens of round trips to go googling for information.

Unfortunately the Xdebug distribution contains no such thing: no comments, no list of ini directives, no ini file at all. But since I am a nice chap, after having carved out such precious jewel, I thought it might be of interest to the community, and without further ado here it is:

(more…)

As lots of other coders in the PHP blogosphere, I am rejoicing for the release of the final version of the FastCGI extension from Microsoft that promises to bring enormous gains in terms of speed and stability when running PHP with IIS.

Unfortunately, when you look at the minimum requirements, you will see that only Windows 2003 server is supported. No playing around with your XP laptop or those old windows 2000 boxes that still occupy a huge chunk of the server room. My guess is that with a little tweaking you might make it work on other platforms (as you can get IIS installed on Xp home), but then support from MS would be less than forthcoming…

Another great piece of technology to make PHP usable in the MS ecosystem is an improved driver to connect to SQL Server: the standard php driver is known for not being 100% stable, with the syndrome I have most frequently seen on live servers being connections sometimes being dropped/connection attempts aborted.
The beta (tcp) version is also available from MS since October. Or at least it should: I have been trying unsuccessfully to download it for a couple of days, and always end up on a broken download server.

The platform support here is broader, starting with windows 200 sp4. Unfortunately, this extension needs the the Microsoft SQL Server Native Client to work, which is not available on any non-ms platform. The most common php platform (linux+apache+php) will thus reap no benefits from this improved driver – the source being of course closed.

All in all, some steps are being taken in the right direction. Let’s just hope than more will be in the future.

This is a very strange topic: even though a cursory google search using the words “multiple php versions apache” spits out a considerable amount of informative howtos and blog entries, when I recently mentioned in a mailing list that it is in fact quite easy to have multiple php installs running in parallel using Apache virtual hosts, I immediately received a private request for my configuration.
Well, here it is, along with a few details on how to set up the complete environment.

The desired goal is having “alot” of php installations running in parallel, so that php scripts can be quickly tested against as many versions of php as possible. It is very useful f.e. when

• you are migrating an existing app from php 4 to version 5
• you are deploying your applications on a large base of servers where different versions of php are installed, but develop all the different apps on the same workstation
• you develop a popular open source php library or shrink wrapped application, and want to make sure that it runs smoothly in every possible user setup
• you want to test an application against different sets of php.ini configurations, to check for possible problems in areas such as output buffering, opcode caches etc…
• you are into integration testing

There are many different setups that can be used to achieve this result (a big list is available on Gentoo docs, courtesy of Andreas Korthaus).
My preferred setup is: use a single apache instance, with a single php version installed as module, and many versions installed as cgi applications. Advantages:

• no need to rename any php file to run it with different php versions
• no need to restart the webserver or run any kind of script to switch php version
• uses less memory than multiple apache installs

The main disadvantages are:

• only 1 php version can run as an apache module, the others must limit themselves to cgi
• a very misbehaved php application can in rare cases hog or crash the webserver, and it will have to be reset before testing with other php versions

The instructions below are geared to a windows environment with Apache 2, but converting them to linux is left as trivial exercise for the sysadmin.

(more…)

A simple question: why is the word “docbook” always followed by “toolchain” instead of “editor”? Why can’t I just write my documentation in xml as easily as I do with Ms Word and be happy with the results?

The answer is unfortunately not so simple. The core of the problem lies in the flexibility provided by the docbook format. After all, it is an xml dialect, which can be used to write (almost) any kind of technical documentation and produce (almost) any kind of output. Existing graphical editing and conversion tools either cater only to a specific category of documents or suffer from a generic interface that does not introduce significant productivity gains.

What I needed to document my php project was:

• A free (at least as in beer) docbook editor with a decent wysiwyg interface that would not force me to learn the intricacies of every single docbook tag
• some way to automatically convert the docbook file to a nicely formatted XHTML version
• some way to automatically convert the docbook file to a similarly formatted PDFversion
• nice-to-have but not required: php syntax highlighting in the final output, generation of (parts of) the docbook manual from javadoc embedded in the php source code, conversion of docbook to OpenOffice format, etc…

After struggling with a couple of buggy/incomplete editing and conversion tools, being somewhat of a coder myself, I decided to roll my own solution.

Here’s how I set up my toolchain:

(more…)

As everybody in the php world is bound to know, PHP4 is still the dominant platform on the net, despite its age and many shortcomings. Notwhistanding many improvements in speed, security and functionality, PHP 5 has seen so far a less-than-stellar adoption rate.

There have been a lot of discussions in the blogosphere about this “problem”, with the most basic explanation being:

• web hosters do not upgrade because some very successful web apps (blogs, cms, bulletins, etc…) still need php 4 to run
• php coders have to code for php 4 because otherwise they loose the opportunity of getting deployed on shared hosting
• since the apps run on php 4 anyway, why upgrade? (a classic case of dog-eats-tail)

Other people refer to PHP as victim-of-its-own-success: PHP 4 was good enough for everybody, so a lot of people do not feel compelled to upgrade.

While I am generally in favour of extreme ABInex and API stability (I have servers running php 4.0.4, pl1 mind you…), I have to admit that the current situation imposes a heavy burden on the developers of php libraries and applications: the coder has to cater to the quirks and bugs of every possible php version, and either avoid any enhancement that has seen the light roughly in the last 5 years (since the release of php 4.2) or resort to provide alternative code paths for the less-fortunate (the php-compat package on Pear is a great help if you’re into defensive coding).

The best proposal I have seen so far to this situation comes from the Drupal mailing list:

PICK A DATE FOR PHP 4 DESUPPORT AND ANNOUNCE IT TO THE WORLD WITH ENOUGH ADVANCE.

The chosen date has to be agreed upon by most major php application teams (this is the hard part), but most of them, have been planning the upgrade to php5 anyway.

• The hosters and sysadmins at private companies will be given enough time to test the deployment of the new php version
• The developers will feel the need to make sure that their app runs fine on php 5 before the cutover date
• Everybody will be happy (except Stefan Esser, he never is…)

One last question remains open: WHAT SHALL WE CALL THE DAY THAT PHP4 IS PUT TO REST?

Suggestions are welcome…