From: <jbo...@li...> - 2006-05-23 10:39:26
|
Author: jfr...@jb... Date: 2006-05-23 06:39:14 -0400 (Tue, 23 May 2006) New Revision: 4371 Modified: labs/jbossweb/trunk/xdocs/modules/php/index.xml Log: Add the very explainations. Modified: labs/jbossweb/trunk/xdocs/modules/php/index.xml =================================================================== --- labs/jbossweb/trunk/xdocs/modules/php/index.xml 2006-05-23 09:53:11 UTC (rev 4370) +++ labs/jbossweb/trunk/xdocs/modules/php/index.xml 2006-05-23 10:39:14 UTC (rev 4371) @@ -14,13 +14,67 @@ <body> <section name="Introduction"> -<p>This is the top-level entry point of the PHP Module documentation bundle for the -<strong>JBossWeb server</strong>. +<p>The PHP Module is a servlet that allows to run PHP embedded scripts. +The servlet calls a native embedded PHP engine with libraries extentions. +The PHP servlet allows to run most of the existing PHP scripts. +</p> +</section> +<section name="Building"> +<p> +To build simply run buildphp.sh. +The buildphp.sh will detect you platform, download and build the dynamic libraries the PHP library needs and +build the PHP servlet itself. Should should get a tarfile that contains the libraries and a war file with the examples. </p> -<p>Select one of the links from the navigation menu (to the left) to drill -down to the more detailed documentation that is available.</p> +Already build PHP servlets and libraries are available at: <todo>Work in progress</todo> </section> + +<section name="Installing"> +After extracting the tarball corresponding to you platform do the following: +Edit in the <Server/> of <code>$CATALINA_BASE/conf/server.xml</code> and add the following: +<source> + <Listener className="org.apache.catalina.servlets.php.LifecycleListener"/> +</source> +If you want to enable php in all contexts edit <code>$CATALINA_BASE/conf/web.xml</code> and add the following: +<source> + <servlet> + <servlet-name>php</servlet-name> + <servlet-class>org.apache.catalina.servlets.php.Handler</servlet-class> + <init-param> + <param-name>debug</param-name> + <param-value>0</param-value> + </init-param> + <load-on-startup>6</load-on-startup> + </servlet> + <servlet> + <servlet-name>phps</servlet-name> + <servlet-class>org.apache.catalina.servlets.php.Highlight</servlet-class> + </servlet> + + <servlet-mapping> + <servlet-name>php</servlet-name> + <url-pattern>*.php</url-pattern> + </servlet-mapping> + <servlet-mapping> + <servlet-name>phps</servlet-name> + <url-pattern>*.phps</url-pattern> + </servlet-mapping> +</source> +The war file of the tarball contains some php demos script they are deployed under /php-examples +Try <code>http://localhost:8080/php-examples/index.php</code> to test them +<todo>Work in progress</todo> +</section> +<section name="Additing extension libraies"> +For the moment this feature is only supported on Solaris. +Edit the <code>php.ini</code> file and add your library extensions as in the following example: +<source> +extension_dir=/home/jfclere/SunOS_i386_tools/PHP/lib/php/extensions/no-debug-zts-20050922 +extension=openssl.so +extension=pdo_pgsql.so +extension=pgsql.so +</source> +<todo>Work in progress</todo> +</section> </body> </document> |