Finalize Contibutors documentation

doc/contributor/PHP-EXT-options.yml.md

@@ -11,7 +11,122 @@ PHP Mods: `options.yml` |
 
 # Extension definition: `options.yml`
 
-To be done
+These options are purely for the module generator to decide whether or not to build the module, in what order to build it (order of dependencies) and when to enable it for PHP cli and PHP-FPM.
 
 
-For now have a look at the existing modules into the respective `options.yml` files as they are mostly the same.
+### `name`
+
+* Required: Yes
+* Type: `str`
+
+The lower-case name of the extension as it is shown by `php -m`.
+
+
+### `exclude`
+
+* Required: Yes
+* Type: `list[str]`
+* Empty: `[]`
+
+Add PHP versions to exclude from building/installing this extension. This could be due to build errors or deprecations.
+
+Example:
+```yaml
+# Exclude PHP 5.2 and PHP 5.3
+exclude: [5.2, 5.3]
+```
+
+**Note:** If this extension is already present, do not exclude it in here, but rather use `already_avail` in `build.yml`.
+
+
+### `depends_build`
+
+* Required: Yes
+* Type: `list[str]`
+* Empty: `[]`
+
+If this PHP module requires another PHP module to be present prior building, you have to specify them in this list. The module generator will then ensure to build all available modules in order of dependencies.
+
+Example:
+```yaml
+# Before building the current extension, it will be ensured that
+# igbinary and msgpack are build and installed beforehand.
+depends_build:
+  - igbinary
+  - msgpack
+```
+
+
+### `depends_load`
+
+* Required: Yes
+* Type: `list[str]`
+* Empty: `[]`
+
+If this PHP module requires another PHP module to be loaded beforehand in order to function correctly, you have to specify them in this list. The PHP docker image will then respect the order of loading modules as per specification in here.
+
+Example:
+```yaml
+# Before loading the current module, ensure to load
+# igbinary and msgpack first.
+depends_load:
+  - igbinary
+  - msgpack
+```
+
+**Note:** This is the opposite of `loads_before`
+
+
+
+### `loads_before`
+
+* Required: No
+* Type: `list[str]`
+* Empty: `[]`
+
+If this PHP module requires to be loaded before certain other PHP modules, specify them in this list. The PHP docker image will then respect the order of loading modules as per specification in here.
+
+Example:
+```yaml
+# Before loading igbinary and msgpack, ensure to load
+# the current module.
+depends_load:
+  - igbinary
+  - msgpack
+```
+
+**Note:** This is the opposite of `depends_load`
+
+
+
+### `conflicts_load`
+
+* Required: Yes
+* Type: `list[str]`
+* Empty: `[]`
+
+Specify any PHP modules that cause the current module to malfunction when loaded.
+
+Example:
+```yaml
+# Make igbinary and msgpack as incompatible to load with this module.
+conflicts_load:
+  - igbinary
+  - msgpack
+```
+
+
+### `enabled_php_cli`
+
+* Required: Yes
+* Type: `bool`
+
+Specify if this module should be loaded and made available to the PHP cli (does not affect PHP-FPM).
+
+
+### `enabled_php_fpm`
+
+* Required: Yes
+* Type: `bool`
+
+Specify if this module should be loaded and made available to the PHP-FPM process (does not affect PHP cli).

doc/contributor/PHP-EXT-test.yml.md

@@ -11,4 +11,17 @@ PHP Mods: `test.yml`
 
 # Extension definition: `test.yml`
 
+### Goal
+The goal of these tests will be to ensure that each compiled module works as expected:
+* Required system libraries are present
+* Module has been loaded in correct order
+* Module works properly
+
+This will be accomplished by providing example PHP code, which makes calls to functions of the respective module. The tests will then check PHP error logs, stderr, unforseen exits and segfaults for potential errors.
+
+Currently some basic tests already exist or a few modules **[here](../../tests/mods/modules)**.
+
+
+### Configuration
+
 This is not yet implemented and thus no documentation exists.