17/11/08

 

Zend Framework 1.7.0 is now available!

Almost three hundred bugs fixed and many welcome additions, one of which is the new Performance Guide in the reference manual.

1.7.0 can  be downloaded from the Zend Framework download site.

Well done ZF Team!

15/11/08

 

Eclipse PDT 2.0 All-In-One (BETA) Available

All-In-One Download from Zend.

If you don’t like the way the folders are represented in the PHP Explorer View you can change this by clicking on the little triangle pointing down on the upper right corner of the Package Explorer, then go to Package Presentation and select “Hierarchical”.

enjoy!

10/11/08

 

Zend_Dojo_Form and Form Validation on the Client Side

One thing those of you who have been using Zend_Dojo_Form might have noticed is that dojo enabled forms don’t show validation warnings when submitted i.e. when the submit button is clicked. This can be quite confusing for the end user.

So, how do we get our dojo enabled forms to validate when submitted?

Matthew Weier O’Phinney explains on nabble that:

You need to bind to the onSubmit event of your form, and validate in
your callback. One way to do this is as follows, from your view script: 

< ? $this->dojo()->javascriptCaptureStart() ?>
function validateForm() {
    var form = dijit.byId("<formid>");
    if (!form.validate()) {
        alert("Invalid form");
        return false;
    }
    return true;
}
< ? $this->dojo()->javascriptCaptureEnd() ?>
< ? $this->dojo()->onLoadCaptureStart() ?>
function () {
    dojo.connect(dijit.byId("</formid><formid>"), "onSubmit", "validateForm");
}
< ? $this->dojo()->onLoadCaptureEnd() ?>
</formid>

What the above does is connect the onSubmit event to the form, which
then executes the validateForm() function; if this returns false,
submission is halted, and, in this case, an alert raised. You could also
popup a dialog box or some other notification.

The above snippet of code Matthew describes doesn’t quite work. An Issue has been created for it here http://framework.zend.com/issues/browse/ZF-4587, but there is a work around, we can use headScript()->capture instead.

Let’s look at how to apply this as a view helper.

The view helper:

library/My/View/Helper/ValidateDojoForm.php

class My_View_Helper_ValidateDojoForm extends Zend_View_Helper_Abstract
{
    public $view;
 
    public function setView(Zend_View_Interface $view)
    {
        $this->view = $view;
    }
 
    /**
     * Validate dojo enabled form onSubmit.
     *
     * @param  string $formId
     * @return void
     */
    public function ValidateDojoForm($formId)
    {
        $this->view->headScript()->captureStart(); ?>
        function validateForm() {
            var form = dijit.byId("< ?php echo $formId; ?>");
            if (!form.validate()) {
                return false;
            }
            return true;
        }
        dojo.addOnLoad(function () {
            dojo.connect(dijit.byId("< ?php echo $formId; ?>"), "onSubmit", "validateForm");
        });
        < ?php $this->view->headScript()->captureEnd();
    }
}

This is very simple view helper. All you need to do is call validateDojoForm in your view script passing in the id of the form you want to be validated on submission as follows:

$this->validateDojoForm('formId');

Helper paths need set up, one way of doing this is in our bootstrap as follows:

/**
 * Initialize view and layouts
 */
$layout = Zend_Layout::startMvc('/path/to/layouts');
$view = $layout->getView()
    ->addHelperPath('My/View/Helper/', 'My_View_Helper')
    ->addHelperPath('Zend/Dojo/View/Helper/', 'Zend_Dojo_View_Helper');

More information on view helpers and helper paths.

What about a custom class that does all the work for us?

A Custom Zend Dojo Form Class

library/My/Dojo/Form.php

class My_Dojo_Form extends Zend_Dojo_Form
{
    /**
     * Set form name
     *
     * @param  string $name
     * @return Zend_Form
     */
    public function setName($name)
    {
        parent::setName($name);
        $this->getView()->validateDojoForm($this->getName());
        return $this;
    }
}

All this does is call our validateDojoForm helper and pass it the id of the form we create. Now we create all our Dojo forms by extending our custom class:

class Form_Name extends My_Dojo_Form
{
    public function init()
    {
        $this->setName('myForm');
 
        $this->addElement('ValidationTextBox', 'name', array(
            'validators' => array(
                array('StringLength', false, array(0, 255)),
            ),
            'label'          => 'Name',
            'required'       => true,
            'invalidMessage' => 'Please type your name.',
            'trim'      => true,
        ));
 
 
        $this->addElement('SubmitButton', 'submitButton',
            array(
                'required'   => false,
                'ignore'     => true,
                'label'      => 'Save'
            )
        );
    }
}

Be sure to call setName() when creating your form. This will call our validateDojoForm helper and pass it the id of the form we create and thus capturing the neccessary javascript to validate our form when it’s submitted.

enjoy!

11/09/08

 

Eclipse Keyboard Shortcuts

Eclipse keyboard shortcuts and some on PDT from Reinhold Weber, enjoy.

“There are developers who, no matter how much experience they have swear on using notepad for all their projects. If you read these lines now - congratulations, you are not one of those. No matter how fast you can code and how intelligent you are, nothing can compensate for an educated use of a feature-rich IDE, no matter what language is your drug of choice.” - Improving your workflow with Eclipse PDT, Reinhold Weber

02/09/08

2

Zend framework: Logging Database Queries to FireBug

Logging database queries to FireBug is sinfully simple with the new component Zend_Db_Profiler_Firebug in ZF 1.6, now available, you can download it here Zend Framework Download Page.

Requirements:

  1. Firefox Browser ideally version 3 but version 2 is also supported.
  2. Firebug Firefox Extension.
  3. FirePHP Firefox Extension.

More information on requirements at the Zend Framework Documentation -  Profiling with Firebug

Let’s look at some examples.

< ?php
// Instatiate the database
$db = Zend_Db::factory('Pdo_Mysql',
    array(
        'host' => 'localhost',
        'dbname' => 'zf_feature_testing',
        'username' => 'user123',
        'password' => 'pass123'
    )
);
 
// Instantiate the profiler in your bootstrap file 
$profiler = new Zend_Db_Profiler_Firebug('All Database Queries:');
// Enable it
$profiler->setEnabled(true);
// Attach the profiler to your db adapter 
$db->setProfiler($profiler);
 
// Run your queries
$result1 = $db->fetchAll('SELECT * FROM zf_test');
$result2 = $db->fetchAll('SELECT * FROM zf_test where id = ?', 3);

Alternatively you can add the profiler parameters to the Zend_Db factory.

< ?php
// Instatiate the database, passing in the profiler parameters.
$db = Zend_Db::factory('Pdo_Mysql',
    array(
        'host' => 'localhost',
        'dbname' => 'zf_feature_testing',
        'username' => 'user123',
        'password' => 'pass123',
        'profiler' => array(
            'enabled' => true,
            'class' => 'Zend_Db_Profiler_Firebug'
        )
    )
);

Or from an .ini file using Zend_Config_Ini

$config = new Zend_Config_Ini('../application/config.ini', 'development');
$db = Zend_Db::factory($config->database);

config.ini

[development]
database.adapter                    = pdo_mysql
database.params.host                = localhost
database.params.username            = user123
database.params.password            = pass123
database.params.dbname              = zf_feature_testing
database.params.profiler.enabled    = true
database.params.profiler.class      = Zend_Db_Profiler_Firebug

Show me my profiling data?

Open FireBug, you will see a link under console.

Profiling with FireBug

Click it open and it will list all the queries that were run.

Profiling with FireBug

Enjoy!