Here’s a session showing this in action:

bob@desktop:~$ php -a
Interactive shell

php > $m = new DateTime();
php > echo $m->format( 'r' );
Mon, 31 Oct 2011 09:39:12 +1300
php > echo $m->modify('-1 month')->format( 'r' );
Sat, 01 Oct 2011 09:39:12 +1300

*cries*

bob@desktop:~$ php -a
Interactive shell

php > $m = new Zend_Date();
php > echo $m;
Oct 31, 2011 9:47:50 AM
php > echo $m->sub( 1, Zend_Date::MONTH );
Sep 30, 2011 9:48:25 AM

*correct*

Finding bottlenecks in code isn’t always an easy task and it’s helpful to have some way of measuring the time it takes to run a process accurately. Sure, there’s the stopwatch method but this only scales so far. Accurately benchmarking is also great for measuring performance of code where the speed isn’t currently an issue. You can benchmark a known operation, then repeat this benchmark process in the future to ensure that no unintentional degradation of performance has occurred as a result of development.

Here’s an example piece of code to help you quickly benchmark code. It supports loading multiple tests into it and simply does a var_dump of the results. Using these results in creative ways is an exercise for the reader.

<?php
 
    class Benchmark
    {
        private $results;
 
        public function __construct()
        {
            // Our benchmarking may take some time - disable the time limit
            set_time_limit( 0 );
        }
 
        private function benchmark( $test, $callback )
        {
            $start = microtime( true );
            $callback();
            $this->results[ $test ] = microtime( true ) - $start;
        }
 
        public function runTests()
        {
            // -- Test #1 ---------------------------------------
 
            $this->benchmark( 'Fetch all contacts', function() {
 
                TwSCM::model( 'broadcast/contact' )->fetchAll();
 
            } );
 
            // -- Test #2 ---------------------------------------
 
            $this->benchmark( 'Fetch objects for tag 4', function() {
 
                TwSCM::model( 'tag' )->getObjectsForTag( 4 );
 
            } );
 
            // -- Test #3 ---------------------------------------
 
            $this->benchmark( 'Count to one million', function() {
 
                for( $a = 0; $a <= 1000000; $a++ )
                {
                    // Do nothing ...
                }
 
            } );
 
            // -- Output the results ----------------------------
 
            var_dump( $this->results );    
        }
    }
 
    $benchmark = new Benchmark();
    $benchmark->runTests();
 
?>

The above code requires at least PHP 5.3 (it uses closures to run the tests and time/store the results) and currently some tests that I’ve been running to profile Turboweb’s Simple Web Manager application. The benchmark() method takes two parameters – the first is the name of the test (this is displayed when $this->results is var_dump()ed) and the second is an anonymous function containing the test to be run.

By modifying the contents of the anonymous function and running this script multiple times you will be able to test and tweak your functions to as quickly as they can.

Good hunting!

Anyway, one of the things it has is a nice API which you can use to interrogate the product (read and write) and this got me thinking about how I could use the API to remind me what I should currently be working on.  Thus was created the “FogBugz Notification Tool”.

This script does the following:

1. Connects to your FogBugz installation
2. Runs a query to see what things have been worked on today
3. If there are any items that don’t have an end date, then it’s the case that’s currently being worked on
4. Get the details of the case
5. Use notify-send to pop up a notification bubble showing case number, title, estimated time and time remaining.

I have found this most effective if I put it in my crontab to run every 5 minutes.

Requirements:

• Ubuntu Linux (or any version of Linux that supports the “notify-send” command)
• PHP5 CLI (simply because this script is written with PHP)
• The “libnotify-bin” package (this provides the “notify-send” command, try “sudo apt-get install libnotify-bin”)

The script requires a little configuration for your circumstances, but this is easily done by editing the defined constants in the script:

	// Adjust these defines to suit your installation
	define( 'FBBASEURL', 'https://mywebsite.fogbugz.com/' );
	define( 'FBUSERNAME', 'my@email.address.com' );
	define( 'FBPASSWORD', 'mypassword' );

And to add it to your crontab, simply add this line (note the */5 means every time the current number of minutes in the hour is evenly divisible by 5)

*/5 * * * * DISPLAY=:0.0 /usr/bin/php /home/bob/fogbugz-notify.php

Of course, adjust the path appropriately.

• Download the script here (9.1kB)

I’ve been trying to get the form validation to allow me to use set_value for fields that aren’t required, but unless your rules specify the field and a validation rule for it the value won’t be available when set_value is called.  The trick here is to use “echo” as the rule which means that the validation passes and you get back what you put in.  This is not documented in the CodeIgniter manual (it’s implied by the fact that you can use any PHP function as a “rule”).

Example:

$rules = array(
  array(
    'field' => 'name',
    'label' => 'Name',
    'rules' => 'required'
  ),
  array(
    'field' => 'nickname',
    'label' => 'Nickname',
    'rules' => 'echo'
  )
);
 
$this->form_validation->set_rules( $rules );

In this case any calls to set_value(‘nickname’) will return the correct value, rather than an empty string.

I’ve also just added the introduction to classes tutorial so go and check it out.