• Download the package
• Put Selenium.php to your “vendors” folder
• Create a folder “Testing” in your “vendors” folder
• Put the “Selenium” folder from the archive to the “Testing” folder
• Put selenium-server.jar to a folder of your choice

Ok, as the installation is done, let’s write a simple testcase. We want to verify that the title of the cake website is correct.

vendor('Selenium');

class SeleniumTest extends UnitTestCase
{
    function setUp()
    {
        $this->selenium = new Testing_Selenium("*firefox /usr/lib/firefox/firefox-bin", "http://cakephp.org");
        $result = $this->selenium->start();
    }

    function tearDown()
    {
        $this->selenium->stop();
    }

    function testCakePHPTitle()
    {
        $this->selenium->open("/");
        $this->assertEqual('CakePHP : the rapid development php framework', $this->selenium->getTitle());
    }
}

What does this do? In the setUp() function we start a Firefox browser (we could also use a different browser). With that browser we open in the test function the cake homepage and get the page title. And in tearDown() we close the browser.

Before we can run this test, we have to start the Selenium server with:

java -jar selenium-server.jar

Now, we should get a green bar when we run the test.

Happy testing :)

Update (2006-11-29): If you don’t want to put the exception class to the vendors folder, you can replace in Selenium.php

require_once 'Testing/Selenium/Exception.php';

with

class Testing_Selenium_Exception extends Exception {}

I created a pear package from all files in CakePHP project and added some scripts to make the creation and the deployment of projects and applications easier.

The package is not available yet due to a problem:

Now, I have a problem to make it available to CakePHP users because I haven’t my own server to install a pear channel. The problem will be solved very soon. I hope so.

So you have to be patient until the CakePHP pear package will be made publicly available.

…I tried to see if it is easy to make cakephp into a pear package. The first problem I see is the ROOT constant which is used in many places in the framework (32 times in 7 files. I’m using the latest version: 0.10.5.1790 RC 1). It makes the separation between the application and cake not easy because it is used by both.

Personally, I do not know if it will be possible to create such a package since CakePHP was not designed for such a scenario. Anyway, good luck, Mustapha!