PHP Development for ClearPath. Session 3028, Tuesday, May 15, 2012, 10:30AM Ron Neubauer, Principal Engineer, Unisys Corporation

Transcription

1 PHP Development for ClearPath Session 3028, Tuesday, May 15, 2012, 10:30AM Ron Neubauer, Principal Engineer, Unisys Corporation

2 Topics Introduction Architecture Installation Usage Obtaining the Product Licensing & Support 2012 Unisys Corporation. All rights reserved. 2

3 Introduction ClearPath database extensions for PHP provide a rapidapplication-development (RAD) framework for building WEB applications that access ClearPath databases Works with MCP DMSII and OS2200 RDMS databases 2012 Unisys Corporation. All rights reserved. 3

4 Architecture Developed as extensions to Quercus Quercus from Caucho A PHP interpreter written in Java Translates PHP database calls into JDBC calls Runs within an application server UIS extensions can not be used with command line apps Some Pros & Cons of Quercus Faster than running native PHP applications Uses database connection pooling Reads PHP source files once and caches them Does not support the complete PHP API 2012 Unisys Corporation. All rights reserved. 4

5 Architecture - Runtime JProcessor ClearPath DMSII/RDMS JDBC DMSII / RDMS 2200 path DMSII/RDMS Quercus module Quercus JBoss AS JVM MCP path WAR file: *.php *.css *.gif WEB-INF/web.xml WEB-INF/lib/quercus.jar Legend: PHP for ClearPath Other components 2012 Unisys Corporation. All rights reserved. 5

6 Architecture Application Development Develop Windows, Linux PhpED Zend Studio PDT (Eclipse) others uis.php ClearPath DMSII / RDMS Exploded WAR: *.php *.css *.gif WEB-INF/web.xml WEB-INF/lib/quercus.jar Test JDBC DMSII/RDMS module Quercus JBoss AS WAR file JVM Deploy Legend: PHP for ClearPath Other components 2012 Unisys Corporation. All rights reserved. 6

7 Installation - Requirements Prerequisites JDK 5 or higher Application Server JBoss Application Server (JBoss AS) or later JBoss Enterprise Application Platform (JBoss EAP) 4.3 or later JDBC Driver for DMSII and/or RDMS databases Quercus or later Optional Apache Ant or later Eclipse PHP Development Tools (PDT) 3.5 or higher, or NetBeans 6.7 or higher Apache Maven or later 2012 Unisys Corporation. All rights reserved. 7

8 Installation - Requirements Platforms Product has been tested on Linux Windows ClearPath JProcessor JProcessor comes with a suitable JDK and JBoss EAP already installed 2012 Unisys Corporation. All rights reserved. 8

9 Installation Ant Script First, edit the build.properties file to specify location of the Quercus WAR file 2012 Unisys Corporation. All rights reserved. 9

10 Installation Ant Script Invoke the ant script to do the install 2012 Unisys Corporation. All rights reserved. 10

11 Installation Ant Script The ant script completes the setup build.log content can be seen at the console with ant v install 2012 Unisys Corporation. All rights reserved. 11

12 Installation Command Completion File Copy uis.php file to Eclipse: eclipse/plugins/org.eclipse.php.core_*/resources/language/php5 NetBeans: NetBeans/php1/phpstubs/phpruntime 2012 Unisys Corporation. All rights reserved. 12

13 Installation Command Completion File Command completion Function help 2012 Unisys Corporation. All rights reserved. 13

14 Usage Configuration Limitations Application 2012 Unisys Corporation. All rights reserved. 14

15 Usage - Configuration Can place runtime configuration settings in WEB-INF/web.xml Overrides connection information provided to the application Example <web-app>... <init-param> <param-name>database</param-name> <param-value>northwindds</param-value> </init-param>... </web-app> For additional information on web.xml Books/tutorials on JSPs and servlets 2012 Unisys Corporation. All rights reserved. 15

16 Usage - Configuration Data Source Configuration File Defines the datasource to the application server JBoss AS: Create *-ds.xml Conventions is * is the database type [and database name] For additional information on data source configuration file JBoss Application Server for ClearPath OS 2200 Installation, Administration, and Programming Guide ( ) _Configuration_Guide/5/html_single/index.html#Configuring_JDBC_ DataSources 2012 Unisys Corporation. All rights reserved. 16

17 Usage - Configuration Data Source Configuration File dmsii-northwind-ds.xml <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>northwindds</jndi-name> <connectionurl>jdbc:unisys:dmsql:unisys.dmsii:resource=northwind;host=xxx;port=1897;user=xxx;password=xxx</connection-url> <driver-class>com.unisys.jdbc.dmsql.driver</driver-class> <min-pool-size>1</min-pool-size> <max-pool-size>5</max-pool-size> <idle-timeout-minutes>15</idle-timeout-minutes> </local-tx-datasource> </datasources> rdms-northwind-ds.xml <?xml version="1.0" encoding="utf-8"?> <datasources> <local-tx-datasource> <jndi-name>northwindds</jndi-name> <connection-url>jdbc:rdms:user=xxx;password=xxx;host= xxx;port=1544;schema=xxx;storagearea=rdms_auto_3;varchar=varchar</connection-url> <driver-class>com.unisys.os2200.rdms.jdbc.rdmsdriver</driver-class> <min-pool-size>1</min-pool-size> <max-pool-size>5</max-pool-size> <idle-timeout-minutes>15</idle-timeout-minutes> </local-tx-datasource> </datasources> 2012 Unisys Corporation. All rights reserved. 17

18 Usage - Application The extensions are embodied in three classes Uis Represents a connection between the PHP application and the ClearPath database Uis-statement Represents a prepared statement that can be submitted to the database Uis_Result Represents the result set returned from a query made to the database Provides the functionality to examine the data in the result set one row at a time 2012 Unisys Corporation. All rights reserved. 18

19 Usage - Limitations Limitations Only available with WEB applications, not to command-line applications Functionality bounded by the capabilities of the respective JDBC drivers DMSII nested data sets are not supported Blobs and Clobs are not supported 2012 Unisys Corporation. All rights reserved. 19

20 Usage - Application Demo 2012 Unisys Corporation. All rights reserved. 20

21 Obtaining the Product Software Available at Offerings ClearPath Systems and Services ClearPath OS 2200 Software or ClearPath MCP Software Key Products ClearPath Database Extensions for PHP A unisys.com login ID is required Documentation Database Extensions for PHP Installation and Configuration Guide ( ) uismodule.chm containing on-line help included with the product distribution Also printable as a reference manual docs/* help text as individual HTML pages included with the product distribution 2012 Unisys Corporation. All rights reserved. 21

22 Licensing & Support Licensing The Unisys ClearPath Database Extensions for PHP is released under the GNU General Public License, version 2 Support For PHP or Quercus issues For UIS extension and access to ClearPath databases 2012 Unisys Corporation. All rights reserved. 22

23 Questions? 2012 Unisys Corporation. All rights reserved. 23