PHP and Gearman: Unable to connect after upgrade

I upgraded PHP and related pecl modules on my development machine today, and ran into a problem with Gearman. Actually I ran into more than one! Firstly the challenge of getting the newest pecl version working with a gearman version. Then an error where my existing PHP application couldn’t connect to gearman after upgrade.

Installing Gearmand and Pecl Gearman on Ubuntu 12.10

First up: the version of gearman in aptitude isn’t new enough to match the (lovely, shiny) new version in pecl. This problem will solve itself with future releases and is just the result of the different speeds that releases get to users via different channels. To get this all set up, I used the excellent tutorial I found here:

After working through this tutorial, I was able to install the pecl gearman extension at the newest version (1.1.1) successfully.

Dealing with “Unable to connect” error

The code I was trying to run is pretty hardened, it’s been in production for nearly two years – yet it just did not work after upgrade and the error “unable to connect” made it sound more like a gearman problem than a PHP one, so I didn’t spot the issue straight away. The exact error from my logs:

PHP Warning: GearmanClient::doBackground(): send_packet(GEARMAN_COULD_NOT_CONNECT) Failed to send server-options packet -> libgearman/

In fact, what happened was that the GearmanClient::addServers() method now requires that the port also be specified with an IP address, in the format whereas previously it would take an IP address and assume the default port number. I simply changed my previous code:


To the updated version like this:


And all was well. It’s a tricky thing to track down so I hope this helps if it happened to you! I also went back and edited the previous code samples on this blog in attempt to have other people avoid the issue.

6 thoughts on “PHP and Gearman: Unable to connect after upgrade

  1. After adding host and port number i’m getting this error.
    Warning: GearmanClient::addServer(): gearman_connection_create_args(GEARMAN_GETADDRINFO) -> libgearman/ in /var/www/html/gearman/client.php on line 10

    any help?

    • instead of $client->addServers(‘’);
      try $client->addServers(‘’,4730);

Leave a Reply

Please use [code] and [/code] around any source code you wish to share.

This site uses Akismet to reduce spam. Learn how your comment data is processed.