Home arrow PHP arrow Page 3 - The Singleton and Factory Patterns in PHP: Building a Form Generator Class

A practical example: putting the “formGenerator” class to the test - PHP

In this final part of the series, Alejandro Gervasio examines a point that he has not taking into consideration so far: that the layout of form elements plays a relevant role within the overall development process. With this in mind, he encapsulates the logic needed to generate web forms by defining a form generator class. This class will implement the form element factory along with all of the required form element classes.

TABLE OF CONTENTS:
  1. The Singleton and Factory Patterns in PHP: Building a Form Generator Class
  2. Object-based form generation (continued): explaining the remaining class methods
  3. A practical example: putting the “formGenerator” class to the test
  4. The source code box: listing the full developed classes
By: Alejandro Gervasio
Rating: starstarstarstarstar / 11
December 07, 2005

print this article
SEARCH DEV SHED

TOOLS YOU CAN USE

advertisement

Despite the rather complicated-sounding nature of the phrase, building object-based forms is a really easy thing to do. With all of the form element classes already defined, as well as the “formElementFactory” class acting as a real factory that returns form objects, setting up the “formGenerator” class for displaying layout-controlled web forms is a pretty straightforward task.

To test the functionality of the “formGenerator” class, I’ll show an example that builds a simple login form, comprised of “username” and “password” fields, together with the corresponding login button. Also, I’ll add some additional markup within the form, to demonstrate the control over the general layout that the class offers. So, the sample code looks like this:

// define parameters for the formGenerator class
$formElements=array('textinput'=>array
('name'=>'username','maxlength'=>'20'),'passwordinput'=>array
('name'=>'password','maxlength'=>'20'),'submitbutton'=>array
('name'=>'login','value'=>'Log in'));
// instantiate a new formGenerator object
$fg=new formGenerator($formElements);
// add element labels
$fg->addFormPart('<table style="float:left;"><tr><td>User
Name<td></tr><tr><td>Password<td></tr></table>');
// add a table to the form code
$fg->addFormPart('<table>');
// add a table row as element header
$fg->addElementHeader('<tr><td>');
// add closing tags
$fg->addElementFooter('</td></tr>');
// generate form
$fg->createForm();
// add a closing </table> tag
$fg->addFormPart('</table>');
// display the form
echo $fg->getFormCode();

As you can see, although the above snippet takes up only a few lines of code, it is actually very powerful. First, the script builds a recursive array with the name and parameters of each form object to be created. Here is the line responsible for doing this:

// define parameters for the formGenerator class
$formElements=array('textinput'=>array
('name'=>'username','maxlength'=>'20'),'passwordinput'=>array
('name'=>'password','maxlength'=>'20'),'submitbutton'=>array
('name'=>'login','value'=>'Log in'));

Then, a new “formGenerator” object is instantiated and the above array is passed to the constructor. Let’s stop briefly at this point and see what’s happening here: if we return to the definition of the class, it’s clear that only two lines are required to generate the main source code of the form, because all of the internal processing for factoring form objects is handled inside the class context. This simple concept demonstrates the real power of the factory pattern, when correctly applied.

The rest of the code uses the “addFormPart()” method to roughly build a table containing the labels for each field, along with the “addElementHeader()” and “addElementFooter()” methods to wrap up form fields into a containing <table> structure.

Finally, the complete (X)HTML markup is displayed by calling the “getFormCode()” method, like this:

echo $fg->getFormCode();

By this point, you’ve been provided with the required background to use some design patterns in order to build web forms based on an object-oriented method. Definitely, repetitive and boring tasks involved in the development of web programs such as form generation, can be easily turned into flexible processes by conceiving them as an issue feasible to be solved through the object-oriented paradigm.

To wrap up, for those developers who want to have available “in one place” all the source code developed for PHP5, I’ll offer a list of each class used to build object-based forms.



 
 
>>> More PHP Articles          >>> More By Alejandro Gervasio
 

blog comments powered by Disqus
escort Bursa Bursa escort Antalya eskort
   

PHP ARTICLES

- Hackers Compromise PHP Sites to Launch Attac...
- Red Hat, Zend Form OpenShift PaaS Alliance
- PHP IDE News
- BCD, Zend Extend PHP Partnership
- PHP FAQ Highlight
- PHP Creator Didn't Set Out to Create a Langu...
- PHP Trends Revealed in Zend Study
- PHP: Best Methods for Running Scheduled Jobs
- PHP Array Functions: array_change_key_case
- PHP array_combine Function
- PHP array_chunk Function
- PHP Closures as View Helpers: Lazy-Loading F...
- Using PHP Closures as View Helpers
- PHP File and Operating System Program Execut...
- PHP: Effects of Wrapping Code in Class Const...

Developer Shed Affiliates

 


Dev Shed Tutorial Topics: