157 lines
5.7 KiB
Markdown
157 lines
5.7 KiB
Markdown
[](https://travis-ci.org/mlocati/docker-php-extension-installer)
|
|
|
|
# Easy installation of PHP extensions in official PHP Docker images
|
|
|
|
This repository contains a script that can be used to easily install a PHP extension inside the [official PHP Docker images](https://hub.docker.com/_/php/).
|
|
|
|
|
|
## Known limits
|
|
|
|
Currently the script requires the Debian-based images (no Alpine).
|
|
|
|
|
|
## Usage
|
|
|
|
Here's a sample Dockerfile that installs the GD and xdedub extensions inside a docker image:
|
|
|
|
```
|
|
FROM php:7.2-cli
|
|
|
|
ADD https://raw.githubusercontent.com/mlocati/docker-php-extension-installer/master/install-php-extensions /usr/local/bin/
|
|
|
|
RUN chmod uga+x /usr/local/bin/install-php-extensions && sync && \
|
|
install-php-extensions gd xdebug
|
|
```
|
|
|
|
Installation via COPY --from
|
|
|
|
```
|
|
FROM php:7.2-cli
|
|
|
|
COPY --from=docker-install-php-extensions /usr/bin/install-php-extensions /usr/bin/
|
|
|
|
RUN install-php-extensions gd xdebug
|
|
```
|
|
|
|
`install-php-extensions` will install all the required APT packages.
|
|
If you want to remove the APT development packages (which shouldn't be needed after the PHP extensions have been installed) and other no longer required packages, you can use the `--cleanup` option (**EXPERIMENTAL**):
|
|
```
|
|
install-php-extensions --cleanup gd xdebug
|
|
```
|
|
|
|
## Supported PHP extensions
|
|
|
|
<!-- START OF EXTENSIONS TABLE -->
|
|
<!-- ########################################################### -->
|
|
<!-- # # -->
|
|
<!-- # DO NOT EDIT THIS TABLE: IT IS GENERATED AUTOMATICALLY # -->
|
|
<!-- # # -->
|
|
<!-- # EDIT THE data/supported-extensions FILE INSTEAD # -->
|
|
<!-- # # -->
|
|
<!-- ########################################################### -->
|
|
| Extension | PHP 5.6 | PHP 7.0 | PHP 7.1 | PHP 7.2 | PHP 7.3 |
|
|
|:---:|:---:|:---:|:---:|:---:|:---:|
|
|
| amqp | | V | V | V | V |
|
|
| apcu | | V | V | V | V |
|
|
| bcmath | V | V | V | V | V |
|
|
| bz2 | V | V | V | V | V |
|
|
| calendar | V | V | V | V | V |
|
|
| cmark | | V | V | V | V |
|
|
| dba | V | V | V | V | V |
|
|
| enchant | V | V | V | V | V |
|
|
| exif | V | V | V | V | V |
|
|
| gd | V | V | V | V | V |
|
|
| gettext | V | V | V | V | V |
|
|
| gmp | V | V | V | V | V |
|
|
| igbinary | V | V | V | V | V |
|
|
| imagick | V | V | V | V | V |
|
|
| imap | V | V | V | V | V |
|
|
| interbase | V | V | V | V | V |
|
|
| intl | V | V | V | V | V |
|
|
| ldap | V | V | V | V | V |
|
|
| mcrypt | V | V | V | V | V |
|
|
| memcache | V | | | | |
|
|
| memcached | V | V | V | V | V |
|
|
| mysql | V | | | | |
|
|
| mysqli | V | V | V | V | V |
|
|
| odbc | V | V | V | V | V |
|
|
| opcache | V | V | V | V | V |
|
|
| pcntl | V | V | V | V | V |
|
|
| pcov | | V | V | V | V |
|
|
| pdo_dblib | V | V | V | V | V |
|
|
| pdo_firebird | V | V | V | V | V |
|
|
| pdo_mysql | V | V | V | V | V |
|
|
| pdo_odbc | V | V | V | V | V |
|
|
| pdo_pgsql | V | V | V | V | V |
|
|
| pdo_sqlsrv | | V | V | V | V |
|
|
| pgsql | V | V | V | V | V |
|
|
| pspell | V | V | V | V | V |
|
|
| pthreads | V | V | | | |
|
|
| recode | V | V | V | V | V |
|
|
| redis | V | V | V | V | V |
|
|
| shmop | V | V | V | V | V |
|
|
| snmp | V | V | V | V | V |
|
|
| soap | V | V | V | V | V |
|
|
| sockets | V | V | V | V | V |
|
|
| solr | V | V | V | | |
|
|
| sqlsrv | | V | V | V | V |
|
|
| ssh2 | V | V | V | V | V |
|
|
| sybase_ct | V | | | | |
|
|
| sysvmsg | V | V | V | V | V |
|
|
| sysvsem | V | V | V | V | V |
|
|
| sysvshm | V | V | V | V | V |
|
|
| tidy | V | V | V | V | V |
|
|
| timezonedb | V | V | V | V | V |
|
|
| uopz | V | V | V | V | V |
|
|
| uuid | V | V | V | V | V |
|
|
| wddx | V | V | V | V | V |
|
|
| xdebug | V | V | V | V | V |
|
|
| xmlrpc | V | V | V | V | V |
|
|
| xsl | V | V | V | V | V |
|
|
| yaml | V | V | V | V | V |
|
|
| zip | V | V | V | V | V |
|
|
<!-- END OF EXTENSIONS TABLE -->
|
|
|
|
PS: the pre-installed PHP extensions are excluded from this list.
|
|
You can list them with the following command (change `php:7.2-cli` to reflect the PHP version you are interested in):
|
|
|
|
```sh
|
|
docker run --rm -it php:7.2-cli php -m
|
|
```
|
|
|
|
## Special requirements
|
|
|
|
Some extension has special requirements:
|
|
|
|
<!-- START OF SPECIAL REQUIREMENTS -->
|
|
<!-- ########################################################### -->
|
|
<!-- # # -->
|
|
<!-- # DO NOT EDIT THIS TABLE: IT IS GENERATED AUTOMATICALLY # -->
|
|
<!-- # # -->
|
|
<!-- # EDIT THE data/special-requirements FILE INSTEAD # -->
|
|
<!-- # # -->
|
|
<!-- ########################################################### -->
|
|
| Extension | Requirements |
|
|
|:---:|:---:|
|
|
| pthreads | Requires images with PHP compiled with thread-safety enabled (`zts`). |
|
|
<!-- END OF SPECIAL REQUIREMENTS -->
|
|
|
|
|
|
## How to contribute
|
|
|
|
- If you want to add support for a new PHP extension:
|
|
1. change the `install-php-extensions` script
|
|
2. update the `data/supported-extensions` file, adding a new line with the handle of the extension and the list of supported PHP versions
|
|
3. if the extension requires ZTS images:
|
|
add a new line to the `data/special-requirements` file, with the extension handle followed by a space and `zts`
|
|
- If you want to change the list of supported PHP versions for an already supported extension:
|
|
1. change the `install-php-extensions` script
|
|
2. update the `data/supported-extensions` file, adding the new PHP version to the existing line corresponding to the updated extension
|
|
- If you change some code that affects one or more extensions, please add a line with `Test: extension1, extension2` to the message of one of the pull request commits.
|
|
Here's an example of a commit message:
|
|
```
|
|
Improve the GD and ZIP extensions
|
|
|
|
Test: gd, zip
|
|
```
|