Properties - PHP

Let’s examine <properties> first.

<!-- PROPERTIES -->
    <properties>
        <!-- MACH II REQUIRED -->
        <property name="defaultEvent" value="showMain" />
        <property name="exceptionEvent" value="exception" />
        <property name="applicationRoot" value="/phpMachII" />
        <property name="eventParameter" value="event" />
        <property name="parameterPrecedence" value="form" />
        <property name="maxEvents" value="10" /> 
    </properties>

Figure 4  mach-ii.xml <properties>

applicationRoot is an absolute or relative path responsible for directing the application to the display files in our app’s views directory. For our purposes it will be set to the current directory, “.”.

defaultEvent is the event you want called when the application first loads.

exceptionEvent is the event triggered for an unhandled exception. Built-in exception handling like this is good because it allows you to consider error handling from the very start. As you define events (we’ll get to that soon), you can build corresponding exception events seamlessly into your system.

eventParameter is the name of the Mach-II event we’ll be referencing in our code. Make it descriptive but easy to type.

parameterPrecedence is used to determine which request parameter to favor when there are simultaneous form and url ($_POST and $_GET) parameters. In our application we’ll want form as the default.

MaxEvents determines how many events are allowed per request.

For more on these Mach-II properties, see Mach-II Application Configuration.