CakePHP Programming

Callbacks in CakePHP forms using events

If you ever have the need to inject fields or other things into a form, for example when building a blog or CMS system, you can use the event system that comes with CakePHP. The basic concept can be used every where within the views and is not limited to forms only, but a form is a good example.

You can find the complete sample as working application in the cake2-form-events branch of my Github cakephp-sample repository.

Please note that this sample code is using php 5.4 specific notations.

The form in a view file is dispatching two events, the View.Form.someFormStart and View.Form.someFormEnd event. The places where these callbacks are fired are the places where custom fields or other output is going to be injected by the triggered event listener callbacks.

The event listener class that will inject something to your form events.  I would not write a lot view code in the event listener itself, it is just done for demonstration purpose in this sample, I would always put the additional things I would like to display in an element and only echo that element from the event, to keep the view pieces it will inject separated from the event listener to respect separation of concerns.

You can put your event listeners into App/Event for example. After you’ve created your event listener and saved it to App/Event/FormListener.php you have to attach your listener to the CakeEventManager. In your App/Config/bootstrap.php add this to attach the listener to the global event manager.

The additional_fields element will output the user we fetched in the first event for demonstration purpose to give you an idea of what is possible and how it works and data is made available between the different steps.

I hope you enjoyed the article and learned something. Any kind of critic to improve it is welcome!