Add PHP pkg-config .pc metadata files

Since PHP *nix Autotools build system already extensively relies on
pkgconf (pkg-config) command-line tool to find dependencies it should
also provide its .pc metadata file(s). [1]

This adds an initial php.pc.in and php-embed.pc.in templates that are
created during the configuration and build phase. They are installed in
the provided system pkgconfig directory. For example:

    /usr/lib/pkgconfig/php.pc
    /usr/lib/pkgconfig/php-embed.pc
    /usr/lib/pkgconfig/php-embed8.pc
    /usr/lib/pkgconfig/php-embed8.4.pc
    /usr/lib/x86_64-linux-gnu/pkgconfig/php.pc

Pkgconf [2] is a maintained continuation of the initial Freedesktop's
pkg-config project [3].

Extensions and applications embedding the PHP Embed SAPI can then
use also pkgconf to get the required PHP CFLAGS and/or LIBS.

For PHP extensions:

    pkgconf --cflags php
    pkgconf --libs php
    pkgconf --modversion php
    pkgconf --cflags php8.4

Applications embedding the PHP Embed SAPI:

    pkgconf --libs php-embed
    pkgconf --cflags php-embed
    pkgconf --modversion php-embed
    pkgconf --cflags php-embed8.4

[1]: https://people.freedesktop.org/~dbn/pkg-config-guide.html
[2]: https://github.com/pkgconf/pkgconf
[3]: https://gitlab.freedesktop.org/pkg-config/pkg-config

Author: petk

.gitignore

@@ -112,6 +112,7 @@ config.h.in
 # SAPIs specific ignores
 # ------------------------------------------------------------------------------
 /sapi/apache2handler/libphp.module
+/sapi/embed/php-embed.pc
 /sapi/fpm/fpm/php-cgi
 /sapi/fpm/init.d.php-fpm
 /sapi/fpm/php-fpm.conf
@@ -129,6 +130,7 @@ config.h.in
 /sapi/fpm/php-fpm
 /sapi/phpdbg/phpdbg
 /scripts/php-config
+/scripts/php.pc
 /scripts/phpize
 php
 

build/Makefile.global

@@ -131,6 +131,7 @@ distclean: clean
 	rm -f scripts/man1/phpize.1 scripts/php-config scripts/man1/php-config.1 sapi/cli/php.1 sapi/cgi/php-cgi.1 sapi/phpdbg/phpdbg.1 ext/phar/phar.1 ext/phar/phar.phar.1
 	rm -f sapi/fpm/php-fpm.conf sapi/fpm/init.d.php-fpm sapi/fpm/php-fpm.service sapi/fpm/php-fpm.8 sapi/fpm/status.html
 	rm -f ext/phar/phar.phar ext/phar/phar.php
+	rm -f scripts/php.pc sapi/embed/php-embed.pc
 	if test "$(srcdir)" != "$(builddir)"; then \
 		rm -f ext/phar/phar/phar.inc; \
 	fi

configure.ac

@@ -1389,6 +1389,8 @@ AC_SUBST([SAPI_LIBNAME_STATIC])
 AC_SUBST([PHP_VERSION])
 AC_SUBST([PHP_VERSION_ID])
 AC_SUBST([PHP_LDFLAGS])
+AC_SUBST([PHP_THREAD_SAFETY])
+AC_SUBST([ZEND_DEBUG])
 
 PHP_UTILIZE_RPATHS
 
@@ -1455,7 +1457,7 @@ PHP_SUBST_OLD([EXTENSION_DIR])
 PHP_SUBST([EXTRA_LDFLAGS])
 PHP_SUBST([EXTRA_LDFLAGS_PROGRAM])
 PHP_SUBST_OLD([EXTRA_LIBS])
-PHP_SUBST([ZEND_EXTRA_LIBS])
+PHP_SUBST_OLD([ZEND_EXTRA_LIBS])
 PHP_SUBST([INCLUDES])
 PHP_SUBST([EXTRA_INCLUDES])
 PHP_SUBST([INSTALL_IT])
@@ -1596,7 +1598,7 @@ else
 fi;
 
 all_targets="\$(OVERALL_TARGET) \$(PHP_MODULES) \$(PHP_ZEND_EX) \$(PHP_BINARIES) $pharcmd"
-install_targets="$install_sapi $install_modules $install_binaries install-build install-headers install-programs $install_pear $pharcmd_install"
+install_targets="$install_sapi $install_modules $install_binaries install-build install-headers install-programs $install_pear $pharcmd_install $install_embed"
 
 PHP_SUBST([all_targets])
 PHP_SUBST([install_targets])
@@ -1795,6 +1797,7 @@ AC_CONFIG_FILES([
   scripts/man1/php-config.1
   scripts/man1/phpize.1
   scripts/php-config
+  scripts/php.pc
   scripts/phpize
 ])
 

sapi/embed/Makefile.frag

@@ -0,0 +1,4 @@
+install-embed:
+	@echo "Installing PHP Embed .pc file:    $(INSTALL_ROOT)$(orig_libdir)/pkgconfig/"
+	@$(mkinstalldirs) $(INSTALL_ROOT)$(orig_libdir)/pkgconfig
+	@$(INSTALL_DATA) sapi/embed/php-embed.pc $(INSTALL_ROOT)$(orig_libdir)/pkgconfig/$(program_prefix)php-embed$(program_suffix).pc

sapi/embed/config.m4

@@ -30,6 +30,11 @@ if test "$PHP_EMBED" != "no"; then
       [php_embed.c],
       [-DZEND_ENABLE_STATIC_TSRMLS_CACHE=1])
     PHP_INSTALL_HEADERS([sapi/embed], [php_embed.h])
+    PHP_ADD_MAKEFILE_FRAGMENT([$abs_srcdir/sapi/embed/Makefile.frag],
+      [$abs_srcdir/sapi/embed],
+      [sapi/embed])
+    AC_CONFIG_FILES([sapi/embed/php-embed.pc])
+    install_embed=install-embed
   ])
 else
   AC_MSG_RESULT([no])

sapi/embed/php-embed.pc.in

@@ -0,0 +1,36 @@
+# The .pc file for the pkg-config command-line utility.
+# https://en.wikipedia.org/wiki/Pkg-config
+#
+# Usage:
+#   pkg-config --cflags php-embed
+#   pkg-config --cflags-only-I php-embed
+#   pkg-config --libs php-embed
+#   pkg-config --mod-version php-embed
+#   pkg-config --print-variables php-embed
+#   pkg-config --variable=php_vernum php-embed
+
+prefix=@prefix@
+exec_prefix=@exec_prefix@
+includedir=@includedir@/php
+libdir=@exec_prefix@/lib
+# The extension_dir PHP INI directive absolute path.
+extensiondir=@EXPANDED_EXTENSION_DIR@
+# PHP version as integer.
+php_vernum=@PHP_VERSION_ID@
+# The path where to scan for additional INI configuration files.
+php_inidir=@EXPANDED_PHP_CONFIG_FILE_SCAN_DIR@
+# The path in which to look for php.ini.
+php_inipath=@EXPANDED_PHP_CONFIG_FILE_PATH@
+# Whether PHP is built in debug mode (yes) or not (no).
+php_debug=@ZEND_DEBUG@
+# Whether PHP is built with thread safety (yes) or not (no).
+php_zts=@PHP_THREAD_SAFETY@
+
+Name: PHP Embed SAPI
+Description: A lightweight SAPI to embed PHP into application using C bindings
+URL: https://www.php.net
+License: PHP
+Version: @PHP_VERSION@
+Cflags: -I${includedir} -I${includedir}/main -I${includedir}/TSRM -I${includedir}/Zend -I${includedir}/ext -I${includedir}/ext/date/lib
+Libs.private: @EXTRA_LIBS@ @ZEND_EXTRA_LIBS@
+Libs: -L${libdir} -lphp

scripts/Makefile.frag

@@ -46,3 +46,6 @@ install-programs:
 		echo "  page: $(program_prefix)$${page}$(program_suffix).1"; \
 		$(INSTALL_DATA) $(builddir)/man1/$${page}.1 $(INSTALL_ROOT)$(mandir)/man1/$(program_prefix)$${page}$(program_suffix).1; \
 	done
+	@echo "Installing PHP .pc file:          $(INSTALL_ROOT)$(orig_libdir)/pkgconfig/"
+	@$(mkinstalldirs) $(INSTALL_ROOT)$(orig_libdir)/pkgconfig
+	@$(INSTALL_DATA) $(builddir)/php.pc $(INSTALL_ROOT)$(orig_libdir)/pkgconfig/$(program_prefix)php$(program_suffix).pc

scripts/php.pc.in

@@ -0,0 +1,36 @@
+# The .pc file for the pkg-config command-line utility.
+# https://en.wikipedia.org/wiki/Pkg-config
+#
+# Usage:
+#   pkg-config --cflags php
+#   pkg-config --cflags-only-I php
+#   pkg-config --libs php
+#   pkg-config --mod-version php
+#   pkg-config --print-variables php
+#   pkg-config --variable=php_vernum php
+
+prefix=@prefix@
+exec_prefix=@exec_prefix@
+includedir=@includedir@/php
+libdir=@exec_prefix@/lib
+# The extension_dir PHP INI directive absolute path.
+extensiondir=@EXPANDED_EXTENSION_DIR@
+# PHP version as integer.
+php_vernum=@PHP_VERSION_ID@
+# The path where to scan for additional INI configuration files.
+php_inidir=@EXPANDED_PHP_CONFIG_FILE_SCAN_DIR@
+# The path in which to look for php.ini.
+php_inipath=@EXPANDED_PHP_CONFIG_FILE_PATH@
+# Whether PHP is built in debug mode (yes) or not (no).
+php_debug=@ZEND_DEBUG@
+# Whether PHP is built with thread safety (yes) or not (no).
+php_zts=@PHP_THREAD_SAFETY@
+
+Name: PHP
+Description: Build extension for a PHP general-purpose scripting language
+URL: https://www.php.net
+License: PHP
+Version: @PHP_VERSION@
+CFlags: -I${includedir} -I${includedir}/main -I${includedir}/TSRM -I${includedir}/Zend -I${includedir}/ext -I${includedir}/ext/date/lib
+Libs.private: @EXTRA_LIBS@ @ZEND_EXTRA_LIBS@
+Libs: