PHPCompute node

The PHPCompute node can use the PHP scripting language to route and transform incoming messages.

Using this node, you can achieve the following goals:

• Examine an incoming message and, depending on its content, propagate it unchanged to the node's output terminal.
• Change part of an incoming message and propagate the changed message to the output terminal by using PHP.
• Create and build a new output message that is independent of the input message by using PHP.

The PHPCompute node is contained in the Transformation drawer of the palette, and is represented in the IBM Integration Toolkit by the following icon:

You can view information about samples only when you use the product documentation that is integrated with the IBM Integration Toolkit or the online product documentation. You can run samples only when you use the product documentation that is integrated with the IBM Integration Toolkit.

Create PHP statements to customize the behavior of the PHPCompute node. For example, you can customize the node to create one or more output messages by using either new data or the content of an input message or database (unchanged or modified). For example, you might want to modify a value in the input message by adding a value from a database, and store the result in a field in the output message.

Create the PHP statements that you want in a PHP script file and ensure that it exists in the workspace before you associate it with the PHPCompute node.

If the required PHP script file exists, import it into the workspace before associating it with the PHPCompute node (see Importing files from the file system into the IBM Integration Toolkit).

If a PHP file does not exist for this node, create one in the project folder with a file extension of .php (for example, myfile.php). For more information about creating a PHP script file, see Creating PHP code for a PHPCompute node.

The PHPCompute node provides support for Simple Network Management Protocol (SNMP). The Management Information Base (MIB) files are installed during the installation of IBM Integration Bus, and their location is specified by the MIBDIRS environment variable.

When you have put an instance of the PHPCompute node into a message flow, you can configure it. For more information about how to configure nodes, see Configuring a message flow node.

The properties of the node are displayed in the Properties view. All mandatory properties for which you must enter a value (the ones that do not have a default value defined) are marked with an asterisk in that view.

To configure the PHPCompute node:

1. Optional: On the Description tab, enter a short description, a long description, or both. You can also rename the node on this tab.
2. On the Basic tab, use the PHP script property to specify the name of the PHP file. Select the Invoke 'evaluate()' method in PHP class definition property if the code in your PHP script file includes an evaluate method.
3. On the Parser options tab, select the Use XMLNSC compact parser for the XMLNS domain property to specify that the XMLNSC Compact Parser is used for messages in the XMLNS Domain.
4. On the Validation tab, specify the parser validation properties of the node. For more information about validation, see Validating messages. For information about how to complete this tab, see Validation tab properties.

The PHPCompute node terminals are described in the following table.

You can define additional dynamic output terminals on the PHPCompute node. Not all dynamic output terminals that are created on a PHPCompute node need to be mapped to an expression in the filter table. If any of the dynamic output terminals are unmapped, they never have messages propagated to them. Several expressions can map to the same single dynamic output terminal. No static output terminal exists to which the message is passed straight through. For more information about using dynamic terminals, see Using dynamic terminals.

The following tables describe the node properties. The column headed M indicates whether the property is mandatory (marked with an asterisk if you must enter a value when no default is defined); the column headed C indicates whether the property is configurable (you can change the value when you add the message flow to the BAR file to deploy it).

The Basic properties of the PHPCompute node are described in the following table:

The Parser Options properties of the PHPCompute node are described in the following table.

The Validation properties of the PHPCompute node are described in the following table.

For a full description of these properties, see Validation properties.