Document PHP environment build configuration vars

This marks the following environment variables as precious:

- DEBUG_CFLAGS
- EXTENSION_DIR
- PHP_UNAME
- PHP_BUILD_SYSTEM
- PHP_BUILD_PROVIDER
- PHP_BUILD_COMPILER
- PHP_BUILD_ARCH

And they are now also shown in the `./configure --help` output.

These variables can be used like this when customizing the PHP build:

    ./configure PHP_BUILD_SYSTEM="..." PHP_BUILD_PROVIDER="..." ...

Author: petk

configure.ac

@@ -968,6 +968,7 @@ if test "$PHP_CONFIG_FILE_SCAN_DIR" = "DEFAULT"; then
 fi
 AC_MSG_RESULT([$PHP_CONFIG_FILE_SCAN_DIR])
 
+AC_ARG_VAR([DEBUG_CFLAGS],[Append additional C compiler flags to CFLAGS])dnl
 test -n "$DEBUG_CFLAGS" && CFLAGS="$CFLAGS $DEBUG_CFLAGS"
 
 PHP_ARG_ENABLE([sigchild],
@@ -1415,6 +1416,7 @@ datadir=`eval eval echo $datadir`
 dnl Build extension directory path.
 ZEND_MODULE_API_NO=`$EGREP '#define ZEND_MODULE_API_NO ' $srcdir/Zend/zend_modules.h|"${SED}" 's/#define ZEND_MODULE_API_NO //'`
 
+AC_ARG_VAR([EXTENSION_DIR],[Overrides the PHP 'extension_dir' INI directive absolute path])dnl
 if test -z "$EXTENSION_DIR"; then
   extbasedir=$ZEND_MODULE_API_NO
   if test "$oldstyleextdir" = "yes"; then
@@ -1491,18 +1493,23 @@ EXTRA_LDFLAGS="$EXTRA_LDFLAGS $PHP_LDFLAGS"
 EXTRA_LDFLAGS_PROGRAM="$EXTRA_LDFLAGS_PROGRAM $PHP_LDFLAGS"
 
 UNAME=`uname -a | xargs`
-PHP_UNAME=${PHP_UNAME:-$UNAME}
+AC_ARG_VAR([PHP_UNAME],[Overrides system information (uname -a output)])dnl
+AS_IF([test -z "$PHP_UNAME"],[PHP_UNAME=[$]UNAME])
 AC_DEFINE_UNQUOTED(PHP_UNAME,"$PHP_UNAME",[uname -a output])
 PHP_OS=`uname | xargs`
 AC_DEFINE_UNQUOTED(PHP_OS,"$PHP_OS",[uname output])
-PHP_BUILD_SYSTEM=${PHP_BUILD_SYSTEM:-$PHP_UNAME}
+AC_ARG_VAR([PHP_BUILD_SYSTEM],[PHP builder name output])dnl
+AS_IF([test -z "$PHP_BUILD_SYSTEM"],[PHP_BUILD_SYSTEM=[$]PHP_UNAME])
 AC_DEFINE_UNQUOTED(PHP_BUILD_SYSTEM,"$PHP_BUILD_SYSTEM",[builder uname output])
+AC_ARG_VAR([PHP_BUILD_PROVIDER],[PHP build provider])dnl
 if test -n "${PHP_BUILD_PROVIDER}"; then
   AC_DEFINE_UNQUOTED(PHP_BUILD_PROVIDER,"$PHP_BUILD_PROVIDER",[build provider])
 fi
+AC_ARG_VAR([PHP_BUILD_COMPILER],[Compiler used for building PHP])dnl
 if test -n "${PHP_BUILD_COMPILER}"; then
   AC_DEFINE_UNQUOTED(PHP_BUILD_COMPILER,"$PHP_BUILD_COMPILER",[used compiler for build])
 fi
+AC_ARG_VAR([PHP_BUILD_ARCH],[PHP build architecture])dnl
 if test -n "${PHP_BUILD_ARCH}"; then
   AC_DEFINE_UNQUOTED(PHP_BUILD_ARCH,"$PHP_BUILD_ARCH",[build architecture])
 fi