php/ext/satellite

$Id$

About Satellite
---------------
Satellite is CORBA support for PHP using ORBit.

The original version was made by David Eriksson <david@2good.com> 
during the summer 2000.


Installation
------------
Read below about installing ORBit.

Then create a directory on your server for your IDL files, and add
an entry to your php.ini like this:

  idl_directory = /var/idl

Note: If you compile Satellite as a dynamic PHP extension you must have the
      above line located before the extension=satellite.so line in php.ini!


Known issues
------------

The ORBit version required by Satellite does not properly handle an IOR that contains
a "Multiple Components Profile". If you run into these problems, please apply the patch
named 'multiple_components.patch' to your ORBit directory before building.

			
PHP as an Apache static module
------------------------------
Before linking Apache you must do either of these things:

  a) Before running Apache's configure you set the environment variable
     LIBS like this:

     export LIBS="`orbit-config --libs client` `libIDL-config --libs`"

  b) You edit apache/src/modules/php4/libphp4.module and
     add `orbit-config --libs client` `libIDL-config --libs`
     within the quotes on the line beginning with LIBS=


What version of ORBit is required?
----------------------------------
You need a CVS version of ORBit to use Satellite!

This does NOT work with ORBit 0.5.5 or earlier.

The latest CVS version of ORBit in CVS requires glib-2.0 and has not been 
tested. Because of this we checkout a CVS version from a known safe date.

How to install ORBit from CVS
-----------------------------

(1) Get it from CVS

    CVS root:   :pserver:anonymous@anoncvs.gnome.org:/cvs/gnome
    Password:   Empty string
    Directory:  ORBit
    Safe date:  2000-09-02 (yyyy-mm-dd)

    More about GNOME:s CVS on http://www.gnome.org/start/source.html

    Sample session at command line to checkout:

    $ export CVSROOT=":pserver:anonymous@anoncvs.gnome.org:/cvs/gnome"
    
    $ cvs login
    (Logging in to anonymous@anoncvs.gnome.org)
    CVS password:
    
    $ cvs checkout -D "2000-09-02" ORBit
    cvs server: Updating ORBit
    .
    .
    .

(2) Set the environment variable CERTIFIED_GNOMIE to whatever you like.

(3) Run ./autogen.sh, gmake and gmake install


How to install ORBit from snapshot
----------------------------------

(1) Download snapshot from one of these addresses:

    http://download.2good.nu/satellite/ORBit-20000902.tgz
    http://www.2good.com/satellite/ORBit-20000902.tgz

(2) Set the environment variable CERTIFIED_GNOMIE to whatever you like.

(3) Run ./configure, gmake and gmake install