public-mirrors
/
docker-php-extension-installer
mirror of https://github.com/mlocati/docker-php-extension-installer
1
0
Fork 0
Code
docker-php-extension-installer/README.md

215 lines
8.4 KiB
Markdown
Raw Normal View History

Add badge to README.md
2018-04-12 07:25:43 +00:00
[![TravisCI Build Status](https://travis-ci.org/mlocati/docker-php-extension-installer.svg?branch=master)](https://travis-ci.org/mlocati/docker-php-extension-installer)
Initial commit
2018-04-11 15:39:10 +00:00
# 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/).
Improve usage instructions
2020-01-08 09:09:44 +00:00
The script will install all the required APT/APK packages; at the end of the script execution, the no-more needed packages will be removed so that the image will be much smaller.
Start adding support for PHP 5.5
2020-01-31 10:09:13 +00:00
Supported docker images are all the Alpine/Debian versions, except for PHP 5.5 where we only support Debian 8 (jessie) (that is, `php:5.5`, `php:5.5-apache`, `php:5.5-cli`, `php:5.5-fpm`, `php:5.5-zts`)
Initial commit
2018-04-11 15:39:10 +00:00
## Usage
Improve usage instructions
2020-01-08 09:09:44 +00:00
You have two ways to use this script within your `Dockerfile`s: you can download the script on the fly, or you can grab it from the [`mlocati/php-extension-installer` Docker Hub image](https://hub.docker.com/r/mlocati/php-extension-installer).
With the first method you are sure you'll always get the very latest version of the script, with the second method the process is faster since you'll use a local image.
Initial commit
2018-04-11 15:39:10 +00:00
Improve usage instructions
2020-01-08 09:09:44 +00:00
For example, here are two `Dockerfile`s that install the GD and xdebug PHP extensions:
### Downloading the script on the fly
```Dockerfile
Initial commit
2018-04-11 15:39:10 +00:00
FROM php:7.2-cli
ADD https://raw.githubusercontent.com/mlocati/docker-php-extension-installer/master/install-php-extensions /usr/local/bin/
Use sync after chmod
2018-04-12 12:37:58 +00:00
RUN chmod uga+x /usr/local/bin/install-php-extensions && sync && \
Fix sample Dockerfile
2018-04-11 15:45:25 +00:00
install-php-extensions gd xdebug
Initial commit
2018-04-11 15:39:10 +00:00
```
Improve usage instructions
2020-01-08 09:09:44 +00:00
### Copying the script from a Docker image
building docker image for easier install
2019-10-09 15:11:51 +00:00
Improve usage instructions
2020-01-08 09:09:44 +00:00
```Dockerfile
building docker image for easier install
2019-10-09 15:11:51 +00:00
FROM php:7.2-cli
Update base image name
2019-10-10 06:49:44 +00:00
COPY --from=mlocati/php-extension-installer /usr/bin/install-php-extensions /usr/bin/
building docker image for easier install
2019-10-09 15:11:51 +00:00
RUN install-php-extensions gd xdebug
```
Initial commit
2018-04-11 15:39:10 +00:00
## Supported PHP extensions
<!-- START OF EXTENSIONS TABLE -->
<!-- ########################################################### -->
<!-- # # -->
<!-- # DO NOT EDIT THIS TABLE: IT IS GENERATED AUTOMATICALLY # -->
<!-- # # -->
<!-- # EDIT THE data/supported-extensions FILE INSTEAD # -->
<!-- # # -->
<!-- ########################################################### -->
[skip ci] Automatically update README.md
2020-01-31 15:30:08 +00:00
| Extension | PHP 5.5 | PHP 5.6 | PHP 7.0 | PHP 7.1 | PHP 7.2 | PHP 7.3 | PHP 7.4 |
|:---:|:---:|:---:|:---:|:---:|:---:|:---:|:---:|
| amqp | V | V | V | V | V | V | V |
| apcu | V | V | V | V | V | V | V |
| bcmath | V | V | V | V | V | V | V |
| bz2 | V | V | V | V | V | V | V |
| calendar | V | V | V | V | V | V | V |
| cmark | | | V | V | V | V | V |
| dba | V | V | V | V | V | V | V |
| enchant | V | V | V | V | V | V | V |
| exif | V | V | V | V | V | V | V |
| gd | V | V | V | V | V | V | V |
| gettext | V | V | V | V | V | V | V |
| gmagick | | V | V | V | V | V | V |
| gmp | | V | V | V | V | V | V |
| grpc | | V | V | V | V | V | V |
| http | | V | V | V | V | V | V |
| igbinary | | V | V | V | V | V | V |
| imagick | | V | V | V | V | V | V |
| imap | | V | V | V | V | V | V |
| interbase | | V | V | V | V | V | |
| intl | | V | V | V | V | V | V |
| ldap | | V | V | V | V | V | V |
| mailparse | | V | V | V | V | V | V |
| mcrypt | | V | V | V | V | V | V |
| memcache | | V | V | V | V | V | V |
| memcached | | V | V | V | V | V | V |
| mongo | | V | | | | | |
| mongodb | | V | V | V | V | V | V |
| msgpack | | V | V | V | V | V | V |
| mssql | | V | | | | | |
| mysql | | V | | | | | |
| mysqli | | V | V | V | V | V | V |
| odbc | | V | V | V | V | V | V |
| opcache | | V | V | V | V | V | V |
| opencensus | | | V | V | V | V | V |
| parallel | | | | V | V | V | V |
| pcntl | | V | V | V | V | V | V |
| pcov | | | V | V | V | V | V |
| pdo_dblib | | V | V | V | V | V | V |
| pdo_firebird | | V | V | V | V | V | V |
| pdo_mysql | | V | V | V | V | V | V |
| pdo_odbc | | V | V | V | V | V | V |
| pdo_pgsql | | V | V | V | V | V | V |
| pdo_sqlsrv | | | V | V | V | V | V |
| pgsql | | V | V | V | V | V | V |
| propro | | V | V | V | V | V | V |
| protobuf | | V | V | V | V | V | V |
| pspell | | V | V | V | V | V | V |
| pthreads | | V | V | | | | |
| raphf | | V | V | V | V | V | V |
| rdkafka | | V | V | V | V | V | V |
| recode | | V | V | V | V | V | |
| redis | | V | V | V | V | V | V |
| shmop | | V | V | V | V | V | V |
| snmp | | V | V | V | V | V | V |
| soap | | V | V | V | V | V | V |
| sockets | | V | V | V | V | V | V |
| solr | | V | V | V | V | V | V |
| sqlsrv | | | V | V | V | V | V |
| ssh2 | | V | V | V | V | V | V |
| sybase_ct | | V | | | | | |
| sysvmsg | | V | V | V | V | V | V |
| sysvsem | | V | V | V | V | V | V |
| sysvshm | | V | V | V | V | V | V |
| tidy | | V | V | V | V | V | V |
| timezonedb | | V | V | V | V | V | V |
| uopz | | V | V | V | V | V | V |
| uuid | | V | V | V | V | V | V |
| wddx | | V | V | V | V | V | |
| xdebug | | V | V | V | V | V | V |
| xmlrpc | | V | V | V | V | V | V |
| xsl | | V | V | V | V | V | V |
| yaml | | V | V | V | V | V | V |
| zip | | V | V | V | V | V | V |
[skip ci] Automatically update README.md
2019-12-17 09:26:35 +00:00
[skip ci] Automatically update README.md
2020-01-07 10:46:38 +00:00
*Number of supported extensions: 73*
Initial commit
2018-04-11 15:39:10 +00:00
<!-- END OF EXTENSIONS TABLE -->
Add a note about pre-installed PHP extensions
2018-04-12 07:50:14 +00:00
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
```
Initial commit
2018-04-11 15:39:10 +00:00
## 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 |
|:---:|:---:|
[skip ci] Automatically update README.md
2019-10-11 06:23:49 +00:00
| parallel | Requires images with PHP compiled with thread-safety enabled (`zts`). |
Initial commit
2018-04-11 15:39:10 +00:00
| pthreads | Requires images with PHP compiled with thread-safety enabled (`zts`). |
<!-- END OF SPECIAL REQUIREMENTS -->
Add contributor instructions to README.md
2018-04-12 09:58:21 +00:00
## How to contribute
Add lint script Co-authored-by: Michele Locati <michele@locati.it> Co-authored-by: Quan TRAN <itscaro@users.noreply.github.com>
2019-12-20 17:26:26 +00:00
### Formatting code
Before submitting any pull request, be sure to execute the `lint` script in the `scripts` directory (or `lint.bat` on Windows).
Improving contributors instructions
2019-12-17 09:33:20 +00:00
### Adding support to a new PHP extension?
Continue implementing Alpine support Test: interbase, mcrypt, mssql, -STOP-
2019-12-11 11:57:53 +00:00
Improving contributors instructions
2019-12-17 09:33:20 +00:00
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`
Add links to sample pull requests in README.md
2019-12-17 10:21:01 +00:00
See [this pull request](https://github.com/mlocati/docker-php-extension-installer/pull/60) for an example.
Improving contributors instructions
2019-12-17 09:33:20 +00:00
### Changing the supported PHP versions for an already supported PHP extension?
1. change the `install-php-extensions` script
Add support for testing more than one PHP extension at once
2019-12-18 15:45:20 +00:00
2. update the `data/supported-extensions` file, adding the new PHP version to the existing line corresponding to the updated extension
Add links to sample pull requests in README.md
2019-12-17 10:21:01 +00:00
See [this pull request](https://github.com/mlocati/docker-php-extension-installer/pull/62) for an example.
Improving contributors instructions
2019-12-17 09:33:20 +00:00
### Improving code for an already supported 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.
That way, the test jobs will check the extension even if you don't touch the `data/supported-extensions` file.
Here's an example of a commit message:
```
Improve the GD and ZIP extensions
Test: gd, zip
```
Add support for testing more than one PHP extension at once
2019-12-18 15:45:20 +00:00
Tests only check the installation of a single PHP extension at a time.
If you want to test installing more PHP extensions at the same time, use a commit message like this:
```
Improve the GD and ZIP extensions
Test: gd+zip
```
Improving contributors instructions
2019-12-17 09:33:20 +00:00
If your pull request contains multiple commits, we'll check the "Test:" message of every commit.
If you want to stop parsing next commits, add `-STOP-` in the "Test:" line, for example:
```
Improve the GD and ZIP extensions
Test: gd, zip, -STOP-
```
Prepare for Alpine support
2019-12-10 07:55:09 +00:00
Add links to sample pull requests in README.md
2019-12-17 10:21:01 +00:00
See [this pull request](https://github.com/mlocati/docker-php-extension-installer/pull/43) for an example.
Prepare for Alpine support
2019-12-10 07:55:09 +00:00
## Do you want to really say thank you?
You can offer me a [monthly coffee](https://github.com/sponsors/mlocati) or a [one-time coffee](https://paypal.me/mlocati) :wink: