]> granicus.if.org Git - php/commitdiff
added notes about the PECL site conformity
authorAnatol Belski <ab@php.net>
Mon, 14 Oct 2013 14:07:26 +0000 (16:07 +0200)
committerAnatol Belski <ab@php.net>
Mon, 14 Oct 2013 14:07:26 +0000 (16:07 +0200)
README.EXTENSIONS
README.EXT_SKEL
README.SELF-CONTAINED-EXTENSIONS

index 51e3b730e7de7647dbee96aa771b85d29a6752d1..7f06c0fb1bc3c221610cf382c015505a2a6afb5a 100644 (file)
@@ -30,7 +30,7 @@ zend_module_entry foo_module_entry = {
     PHP_RSHUTDOWN(foo),   /* per-request shutdown function */
     PHP_MINFO(foo),       /* information function */
 #if ZEND_MODULE_API_NO >= 20010901
-    FOO_VERSION,          /* extension version number (string) */
+    PHP_FOO_VERSION,          /* extension version number (string) */
 #endif
     STANDARD_MODULE_PROPERTIES
 };
index b0db843a42ba0fd67d7e126a7ef0016f9538b37b..d44fcc5c6a92cdd24797e39a9fc48d05de4ebc18 100644 (file)
@@ -31,6 +31,11 @@ HOW TO USE IT
 
     ./buildconf; ./configure --enable-module_name; make
 
+  The definition of PHP_MODULE_NAME_VERSION will be present in the
+  php_module_name.h and injected into the zend_module_entry definition. This
+  is required by the PECL website for the version string conformity checks
+  against package.xml
+
   But if you already have planned the overall scheme of your module, what
   functions it will contain, their return types and the arguments they take
   (a very good idea) and don't want to bother yourself with creating function
index e6a375331b4a575aa7a3a84dce312dd658ebb067..5287230e1aea082edbea43dfc570843da1af397f 100644 (file)
@@ -153,3 +153,18 @@ ADDING SHARED MODULE SUPPORT TO A MODULE
         #ifdef COMPILE_DL_FOO
         ZEND_GET_MODULE(foo)
         #endif
+
+PECL SITE CONFORMITY
+
+  If you plan to release an extension to the PECL website, there are several
+  points to be regarded.
+
+ 1. Add LICENSE or COPYING to the package.xml
+
+ 2. The following should be defined in one of the extension header files
+
+        #define PHP_FOO_VERSION "1.2.3"
+
+    This macros has to be used within your foo_module_entry to indicate the
+    extension version.
+