mirror of
https://github.com/php/php-src.git
synced 2026-03-24 00:02:20 +01:00
This replaces the AC_MSG_ERROR with AC_MSG_FAILURE, where appropriate. The AC_MSG_ERROR outputs given message and exits the configure step. The AC_MSG_FAILURE does the same but also automatically outputs additional message "See 'config.log' for more details." which might help directing the user where to look further. The AC_MSG_ERROR is used for errors where current test step isn't logged in the config.log and wouldn't make sense, and AC_MSG_FAILURE is mostly used in cases of library checks, compilation tests, headers checked with AC_CHECK_HEADER* and similar tests that are also logged in the config.log. AC_MSG_ERROR([Sanity check failed.]) output: ``` configure: error: Sanity check failed. ``` AC_MSG_FAILURE([Sanity check failed.]) output: ``` configure: error: in '/path/to/php-src': configure: error: Sanity check failed. See 'config.log' for more details ```
110 lines
4.4 KiB
Plaintext
110 lines
4.4 KiB
Plaintext
dnl Autotools config.m4 for PHP extension %EXTNAME%
|
|
|
|
dnl Comments in this file start with the string 'dnl' (discard to next line).
|
|
dnl Remove where necessary.
|
|
|
|
dnl If extension references and depends on an external library package, use
|
|
dnl the '--with-%EXTNAME%' configure option:
|
|
dnl PHP_ARG_WITH([%EXTNAME%],
|
|
dnl [for %EXTNAME% support],
|
|
dnl [AS_HELP_STRING([--with-%EXTNAME%],
|
|
dnl [Include %EXTNAME% support])])
|
|
|
|
dnl Otherwise use the '--enable-%EXTNAME%' configure option:
|
|
PHP_ARG_ENABLE([%EXTNAME%],
|
|
[whether to enable %EXTNAME% support],
|
|
[AS_HELP_STRING([--enable-%EXTNAME%],
|
|
[Enable %EXTNAME% support])],
|
|
[no])
|
|
|
|
AS_VAR_IF([PHP_%EXTNAMECAPS%], [no],, [
|
|
dnl This section is executed when extension is enabled with one of the above
|
|
dnl configure options. Adjust and add tests here.
|
|
|
|
dnl
|
|
dnl Use and adjust this code block if extension depends on external library
|
|
dnl package which supports pkg-config.
|
|
dnl
|
|
dnl Find library package with pkg-config.
|
|
dnl PKG_CHECK_MODULES([LIBFOO], [foo])
|
|
dnl
|
|
dnl Or if you need to check for a particular library version with pkg-config,
|
|
dnl you can use comparison operators. For example:
|
|
dnl PKG_CHECK_MODULES([LIBFOO], [foo >= 1.2.3])
|
|
dnl PKG_CHECK_MODULES([LIBFOO], [foo < 3.4])
|
|
dnl PKG_CHECK_MODULES([LIBFOO], [foo = 1.2.3])
|
|
dnl
|
|
dnl Add library compilation and linker flags to extension.
|
|
dnl PHP_EVAL_INCLINE([$LIBFOO_CFLAGS])
|
|
dnl PHP_EVAL_LIBLINE([$LIBFOO_LIBS], [%EXTNAMECAPS%_SHARED_LIBADD])
|
|
dnl
|
|
dnl Check for library and symbol presence.
|
|
dnl LIBNAME=%EXTNAME% # you may want to change this
|
|
dnl LIBSYMBOL=%EXTNAME% # you most likely want to change this
|
|
dnl
|
|
dnl If you need to check for a particular library function (e.g. a conditional
|
|
dnl or version-dependent feature) and you are using pkg-config:
|
|
dnl PHP_CHECK_LIBRARY([$LIBNAME], [$LIBSYMBOL],
|
|
dnl [AC_DEFINE([HAVE_%EXTNAMECAPS%_FEATURE], [1],
|
|
dnl [Define to 1 if %EXTNAME% has the 'FEATURE'.])],
|
|
dnl [AC_MSG_FAILURE([FEATURE not supported by your %EXTNAME% library.])],
|
|
dnl [$LIBFOO_LIBS])
|
|
dnl
|
|
|
|
dnl
|
|
dnl Or use and adjust this code block if extension depends on external library
|
|
dnl package, which does not support pkg-config.
|
|
dnl
|
|
dnl Path to library package can be given as parameter (--with-%EXTNAME%=<DIR>)
|
|
dnl SEARCH_PATH="/usr/local /usr" # you might want to change this
|
|
dnl SEARCH_FOR="/include/%EXTNAME%.h" # you most likely want to change this
|
|
dnl AS_IF([test -r $PHP_%EXTNAMECAPS%/$SEARCH_FOR],
|
|
dnl [%EXTNAMECAPS%_DIR=$PHP_%EXTNAMECAPS%],
|
|
dnl [
|
|
dnl for i in $SEARCH_PATH; do
|
|
dnl AS_IF([test -r $i/$SEARCH_FOR],
|
|
dnl [%EXTNAMECAPS%_DIR=$i; break;])
|
|
dnl done
|
|
dnl ])
|
|
dnl
|
|
dnl AC_MSG_CHECKING([for %EXTNAME% library package])
|
|
dnl AS_VAR_IF([%EXTNAMECAPS%_DIR],, [
|
|
dnl AC_MSG_RESULT([not found])
|
|
dnl AC_MSG_ERROR([Please reinstall the %EXTNAME% library package])
|
|
dnl ], [AC_MSG_RESULT([found in $%EXTNAMECAPS%_DIR])])
|
|
dnl
|
|
dnl Add include flag where library package headers are located on the system.
|
|
dnl PHP_ADD_INCLUDE([$%EXTNAMECAPS%_DIR/include])
|
|
dnl
|
|
dnl Check for library and symbol presence.
|
|
dnl LIBNAME=%EXTNAME% # you may want to change this
|
|
dnl LIBSYMBOL=%EXTNAME% # you most likely want to change this
|
|
dnl
|
|
dnl If you need to check for a particular library function (e.g. a conditional
|
|
dnl or version-dependent feature) and you are not using pkg-config:
|
|
dnl PHP_CHECK_LIBRARY([$LIBNAME], [$LIBSYMBOL], [
|
|
dnl PHP_ADD_LIBRARY_WITH_PATH([$LIBNAME],
|
|
dnl [$%EXTNAMECAPS%_DIR/$PHP_LIBDIR],
|
|
dnl [%EXTNAMECAPS%_SHARED_LIBADD])
|
|
dnl AC_DEFINE([HAVE_%EXTNAMECAPS%_FEATURE], [1],
|
|
dnl [Define to 1 if %EXTNAME% has the 'FEATURE'.])
|
|
dnl ],
|
|
dnl [AC_MSG_FAILURE([FEATURE not supported by your %EXTNAME% library.])],
|
|
dnl [-L$%EXTNAMECAPS%_DIR/$PHP_LIBDIR -lm])
|
|
dnl
|
|
|
|
dnl Add linked libraries flags for shared extension to the generated Makefile.
|
|
dnl PHP_SUBST([%EXTNAMECAPS%_SHARED_LIBADD])
|
|
|
|
dnl Define a preprocessor macro to indicate that this PHP extension can
|
|
dnl be dynamically loaded as a shared module or is statically built into PHP.
|
|
AC_DEFINE([HAVE_%EXTNAMECAPS%], [1],
|
|
[Define to 1 if the PHP extension '%EXTNAME%' is available.])
|
|
|
|
dnl Configure extension sources and compilation flags.
|
|
PHP_NEW_EXTENSION([%EXTNAME%],
|
|
[%EXTNAME%.c],
|
|
[$ext_shared],,
|
|
[-DZEND_ENABLE_STATIC_TSRMLS_CACHE=1])
|
|
])
|