17.69. php

17.69. `php`
Prev	Chapter 17. Using `USES` Macros	Next

17.69. `php`

Possible arguments: (none), phpize, ext, zend, build, cli, cgi, mod, web, embed, pecl, flavors, noflavors

Provide support for PHP. Add a runtime dependency on the default PHP version, lang/php56.

phpize: Use to build a PHP extension. Enables flavors.
ext: Use to build, install and register a PHP extension. Enables flavors.
zend: Use to build, install and register a Zend extension. Enables flavors.
build: Set PHP also as a build-time dependency.
cli: Needs the CLI version of PHP.
cgi: Needs the CGI version of PHP.
mod: Needs the Apache module for PHP.
web: Needs the Apache module or the CGI version of PHP.
embed: Needs the embedded library version of PHP.
pecl: Provide defaults for fetching PHP extensions from the PECL repository. Enables flavors.
flavors: Enable automatic PHP flavors generation. Flavors will be generated for all PHP versions, except the ones present in IGNORE_WITH_PHP.
noflavors: Disable automatic PHP flavors generation. Must only be used with extensions provided by PHP itself.

Variables are used to specify which PHP modules are required, as well as which version of PHP are supported.

USE_PHP: The list of required PHP extensions at run-time. Add :build to the extension name to add a build-time dependency. Example: pcre xml:build gettext
IGNORE_WITH_PHP: The port does not work with PHP of the given version. For possible values look at the content of _ALL_PHP_VERSIONS in Mk/Uses/php.mk.

When building a PHP or Zend extension with :ext or :zend, these variables can be set:

PHP_MODNAME

The name of the PHP or Zend extension. Default value is ${PORTNAME}.

PHP_HEADER_DIRS

A list of subdirectories from which to install header files. The framework will always install the header files that are present in the same directory as the extension.

PHP_MOD_PRIO

The priority at which to load the extension. It is a number between 00 and 99.

For extensions that do not depend on any extension, the priority is automatically set to 20, for extensions that depend on another extension, the priority is automatically set to 30. Some extensions may need to be loaded before every other extension, for example www/php56-opcache. Some may need to be loaded after an extension with a priority of 30. In that case, add PHP_MOD_PRIO=XX in the port's Makefile. For example:

USES=		php:ext
USE_PHP=	wddx
PHP_MOD_PRIO=	40

These variables are available to use in PKGNAMEPREFIX or PKGNAMESUFFIX:

PHP_PKGNAMEPREFIX: Contains phpXY- where XY is the current flavor's PHP version. Use with PHP extensions and modules.
PHP_PKGNAMESUFFIX: Contains -phpXY where XY is the current flavor's PHP version. Use with PHP applications.
PECL_PKGNAMEPREFIX: Contains phpXY-pecl- where XY is the current flavor's PHP version. Use with PECL modules.

Important:

With flavors, all PHP extensions, PECL extensions, PEAR modules must have a different package name, so they must all use one of these three variables in their PKGNAMEPREFIX or PKGNAMESUFFIX.

Prev	Up	Next
17.68. `pgsql`	Home	17.70. `pkgconfig`