MozPHP

MozPHP is a Mozilla PHP integration package. With MozPHP you can execute PHP scripts in Mozilla directly without the need for a local HTTP server.

Currently the integration is one way, i.e. it is not possible to access Mozilla internals from PHP scripts. This may change in the future but there are no concrete plans for this.

Copyright (c) 2003-2004 Dr. Thomas Schilz

MozPHP is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

MozPHP is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

MozPHP has been developed and tested with Mozilla 1.3.1, 1.4 and 1.5 under Linux and Windows. It won't work with older versions of Mozilla and it has not been tested with other operating systems.

The Mozilla 1.4 binaries have been reported to work with Mozilla Firebird 0.6.1 too. The Mozilla 1.5 binaries should work with Mozilla Firebird 0.7 too.

Of course you also need to have PHP installed on your system. MozPHP works with PHP4 only.

No cookies.

You cannot (yet) set cookies using PHPs setcookie function.

Probably many others I'm not aware of.

If you find one, please inform me. Better yet, fix it.

Win32

Download the MozPHP-x_y_win32.zip suitable for your Mozilla and extract it in your Mozilla installation directory. You should now find the following files in the components directory:

• phptohtmlconv.dll
• nsIPostData.xpt
• cfh_protocol.dll
• cfh_protocol.xpt

Linux

Download MozPHP-x_y_linux.zip suitable for your Mozilla and extract it in your Mozilla installation directory. You should now find the following files in the components directory:

• libphptohtmlconv.so
• nsIPostData.xpt
• libcfh_protocol.so
• cfh_protocol.xpt

All platforms

Close any open Mozilla windows. Backup and then delete compreg.dat and xpti.dat in the components directory. Restart Mozilla.

MozPHP version 0.1.0 to 0.1.3 only

Open the Preferences dialog. In Navigator / Helper Applications click on the New Type button and add an entry for extension php (and php3 if you like) as follows:

After clicking OK you should find the newly defined type in the File types list like this:

This step is no longer needed in MozPHP version 0.1.4 and higher since MIME type text/php is now assigned to files with extension .php by the cfh protocol handler when opening such files using the cfh: protocol.

Testing it

As a simple test if MozPHP has been installed correctly download test.php and save it in some directory DIR on your local hard disk. Then open cfh://DIR/test.php. As a result you should see something like this:

Now click at the GET Test link, and the result should look as follows:

Finally enter some text, eg. foo into the input field and click at the POST Test button. Now you should get this:

Win32 only

• Get the PHP sources.
• Set an environment variable PHP_DIR with the path to the directory to where you unpacked the PHP sources.
• Open MS Visual Studio and build the php4ts project as described in http://www.php.net/manual/en/install.windows.php#install.windows.build.

All platforms

• Download the Mozilla sources from www.mozilla.org and build Mozilla.
• Download and unpack the MozPHP sources. They are in MozPHP-0.1.3_src.zip.
• In PHPToHTMLConv/Makefile and CFH_Protocol/Makefile adjust DEPTH. It must must be set to the path of the directory to where you unpacked the Mozilla sources.
• In PHPToHTMLConv/Makefile adjust PHP_INCLUDE_DIR and PHP_LIBDIR. They must point to the directories where the PHP include files and libphp4 library have been installed to.
• In directory MozPHP type make.
• To build the zip files mentioned in the INSTALLATION section type make dist_bin.

PHPToHTMLConv

A stream converter for the conversion of PHP files to HTML. The stream converter integrates a PHP SAPI module.

CFH_Protocol

A protocol handler that partly implements the file protocol and the http protocol.

If you have a problem using or compiling MozPHP, please read the unasked questions. If you can't find a solution for your problem there, try to find out what is going wrong by reading the sources. If you find a solution please send the modifications you made to mozphp@web.de. If you really can't fix the problem yourself, send an email to mozphp@web.de with a detailed description of the problem and of the computing environment you are working with.

Your help is appreciated in the further development of MozPHP.

• If you compile MozPHP on some other platform than Linux or Windows I would be glad to make the binaries available here.

Thanks to

Philippe Goetz

For sending a patch needed to make MozPHP working with Mozilla 1.5.