Mach-II for PHP: A Preview - Creating Views (
Page 7 of 7 )
Views are added to an application by documenting their location in mach-ii.xml, then placing the files in their designated directories (in the demo app’s case the single directory is views).
Views are called in mach-ii.xml from their respective event handlers. In the demo application, when the form is posted and the processForm listener is called, a successful result calls the showResults event handler. showResults then calls a view.
<event-handler event="showResults" access="public">
<event-arg name="pageName" value="Success" />
<view-page name="results" />
</event-handler>
Figure 12 ./config/mach-ii.xml ~ calling a view
It’s a good idea to create views that are as generic as possible so a single view can be used in many different event handlers. One obvious approach is to think of each view as a ‘component’ rather than a ‘page’. Mach-II is great for component-based layouts because <view-page> can specify its content be copied to a variable rather than display a view outright. In this way, multiple views can be generated in an event handler using the optional contentKey attribute:
<view-page name="menu" contentKey="GLOBALS['menu']" />
<view-page name="subMenu" contentKey="GLOBALS['subMenu']" />
Figure 13 ./config/mach-ii.xml ~ mapping views to global variables
The demo application’s results.php displays the result from the processForm listener’s validate method:
<? echo $GLOBALS['results']; ?>
Figure 14 ./views/results.php ~ Displaying the results from listener processForm
results.php also displays an <event-arg> defined in mach-ii.xml for the event showResults:
<? echo $event->getArg('pageName'); ?>
Figure 15 ./views/results.php ~ Displaying an <event-arg> defined in mach-ii.xml
The display file results.php:
<? $page = $event->getArg('pageName'); ?>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<title><? echo $page; ?></title>
</head>
<body>
<table cellpadding="0" cellspacing="0">
<tr>
<td align="left" valign="middle">
<? echo $GLOBALS['results']; ?>
</td>
</tr>
</table>
</body>
</html>
Conclusion
There are many more topics to cover that are not within the scope of this article. Among them are plugins and filters that make it possible to manipulate Event data (you’ll see them in mach-ii.xml).
Mach-II offers developers a fast, efficient and easy-to-maintain framework for object-oriented applications in PHP. At the time of the writing, Mach-II for PHP5 is in testing and will be available soon. For developers searching for a standardized design methodology for PHP web apps, Mach-II is a superior choice.
/ 17 
