php domino,domino 与 apache php 的集成_lotus notes

现在很多项目是php开发，php作为流行的开发语言，具有良好的性能

这篇文章就是介绍如何使domino与php集成在一起

Introduction

Setting up Domino

Setting up Apache

Using PHP with Domino

Limitations, TODO, etc

Introduction

People often ask whether its possible to use PHP with Domino. Its not as long as Domino is the HTTP stack being used. In theory it would be possible with IIS as the HTTP stack and the PHP module for IIS, but this is a nicer solution (because you dont need IIS) using Apache as the HTTP stack.

This is achieved without any additional code or modules, just through proper configuration of Apache. In essence, were using mod_rewrite to find URLs with .nsf in them and pass them through to mod_proxy to fetch them from Domino. This in effect gives you seamless integration between Apache and Domino, as content on an Apache server usually wont have .nsf in the filename so there wont be a conflict.

System Requirements

Here is the software and versions I used to test this out:Domino 5.06a (This was the first Domino CD I found in my drawer)

Apache 1.3.22 (Should work with any 1.3 version of Apache – might be different under 2.0)

PHP 4.2.0

Note: For these examples Im assuming youre running Apache and Domino on the same box, although theres nothing stopping you from running them seperately – just replace relevant references to “localhost” with the hostname of your Domino server.

Setting up Domino

Note: You can skip this step if youre running Apache and Domino on seperate boxes.

Firstly we need to move Domino off port 80 for HTTP, so that Apache can take over port 80. To do this in the Server Document go to:

Ports -> Internet Ports -> WebChange TCP/IP Port Number to any value but 80, for example 81. The rest of this page will assume youre going to be running Domino on port 81.

Restart the HTTP task – it should come back up on port 81. Try to get to it through the browser, go to the URL http://localhost:81/ – you should get whatever you have setup as the homepage.

Setting up Apache / PHP

Note that the basic setup of Apache / PHP is not going to be discussed here. We will assume you have installed Apache, set it up (running on port 80 as normal), installed PHP and setup Apache so that it can run PHP pages. (Phew!) Sounds more complicated than it is, if youve never done it before. If you follow the Apache Install instructions and the PHP Install instructions you shouldnt have any trouble.

Add the following lines to your httpd.conf:RewriteEngine on RewriteRule ^(.*).nsf(.*) http://localhost:81$1.nsf$2 [P]

What this does is rewrite any URL with a .nsf in it to an Apache proxy request for the same page on port 81 (where Domino is running)

Also add the following lines to ensure that mod_proxy is setup: Note: There will likely be a commented out mod_proxy section if youre using the default httpd.conf – you can just edit that one if you likeProxyRequests On Order deny,allow Deny from all Allow from 127.0.0.1

This will make sure that Proxying is on and only the locally running Apache server is allowed to make Proxy requests.

Update 26 April 2002: I forgot to originally mention that youll also need to make sure that the proxy module is being loaded – Near the top of the httpd.conf file there are two lines that need to be uncommented (theyre in seperate sections):LoadModule proxy_module modules/mod_proxy.soAddModule mod_proxy.c

Start Apache and go to http://localhost/homepage.nsf and you should get the Domino sample homepage being served through Apache.

Using PHP with Domino

Accessing Domino servers using PHPs support for COM on the Windows platform is nothing unique, so I wont go into too much detail. One interesting thing though when integrating PHP with Domino is you can use PHP for displaying stuff, and then jump to a Domino generated page anytime you need to seamlessly. This is mainly what this example is about – its a simple example to display a list of names in the NAB and let you edit the records. The display is done using PHP and the editing is standard Domino EditDocument functionality. I used the NAB as the example because I tried this integration stuff on a standalone server and I didnt have any other interesting databases on it 

Download nab.zip – ZIP file containing the nab.php file.

Limitations, TODO, etc

I havent done too much experimenting with this integration, just mainly wanted to see if it works. It doesnt seem like there are any real limitations. One thing that might have been an issue that isnt is that authentication works. Note that if youre using files that are in the domino\html directory you will need to either move them into the Apache htdocs directory or point Apaches root to the Domino domino\html directory.

Also itd be interesting to see what performance is like under “real” loads. I wouldnt think the proxying would add too much overhead. If anyone has easy access to some stress testing tools and gives it a go, let me know and Ill share with everyone.

Some things to consider and/or try:SSL connections – how will this work given youll need seperate certificates for Domino and Apache? I think what would work is that you have the proper certificate for the Apache server and a self-signed cert for Domino – that way when the Apache proxy requests the Domino page it doesnt matter that the certificate is self-signed because it will be Apache actually returning the page to the user (ie. seamlessly)

Setting up Domino so that it only accepts connections from Apache – this would prevent someone going to port 81 and getting around Apache. If its behind a firewall this wont be an issue.

Using mod_rewrite to make pretty URLs for Domino content ala the functionality in Domino 6

You can play around with the mod_proxy settings to enable caching for Domino pages. Check out the manual page for mod_proxy for more info.