cvs: php4 / README.SELF-CONTAINED-EXTENSIONS

sas		Tue May 23 00:33:51 2000 EDT

  Modified files:
    /php4	README.SELF-CONTAINED-EXTENSIONS 
  Log:
  Add section about adding shared module support to an existing module.
  
  
Index: php4/README.SELF-CONTAINED-EXTENSIONS
diff -u php4/README.SELF-CONTAINED-EXTENSIONS:1.2 php4/README.SELF-CONTAINED-EXTENSIONS:1.3
--- php4/README.SELF-CONTAINED-EXTENSIONS:1.2	Tue May  2 23:51:48 2000
+++ php4/README.SELF-CONTAINED-EXTENSIONS	Tue May 23 00:33:51 2000
@@ -1,4 +1,4 @@
-$Id: README.SELF-CONTAINED-EXTENSIONS,v 1.2 2000/05/02 21:51:48 sas Exp $
+$Id: README.SELF-CONTAINED-EXTENSIONS,v 1.3 2000/05/22 22:33:51 sas Exp $
 =============================================================================
 
 HOW TO CREATE A SELF-CONTAINED PHP EXTENSION
@@ -126,4 +126,26 @@
      $ ./configure \
             [--with-php-config=/path/to/php-config]
      $ make install
-  
+
+ADDING SHARED MODULE SUPPORT TO A MODULE
+
+  In order to be useful, a self-contained extension must be loadable
+  as a shared module. I will explain now how you can shared module support
+  to an existing module called foo.
+
+  1. In config.m4, use PHP_ARG_WITH/PHP_ARG_ENABLE. Then you will
+     automatically be able to use --with-foo=shared or
+     --enable-foo=shared.
+
+  2. In config.m4, use PHP_EXTENSION(foo, $ext_shared) to enable
+     building the extension.
+
+  3. Add the following line to Makefile.in:
+
+        LTLIBRARY_SHARED_NAME = foo.la
+
+  4. Add the following lines to your C source file:
+
+        #if defined(COMPILE_DL) || defined(COMPILE_DL_FOO)
+        ZEND_GET_MODULE(foo)
+        #endif