docker-library
/
docs
mirror of https://github.com/docker-library/docs.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #1201 from infosiftr/pecl-install 

Update "pecl install" lines and add more explanation for why users should use explicit versions when installing from PECL
This commit is contained in:
yosifkit 2018-04-19 14:15:05 -07:00 committed by GitHub
parent 6d6e074953 4cf828680b
commit 7ebc0e4729
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

12
php/content.md
View File

@ -112,9 +112,9 @@ See ["Dockerizing Compiled Software"](https://tianon.xyz/post/2017/12/26/dockeri
Some extensions are not provided with the PHP source, but are instead available through [PECL](https://pecl.php.net/). To install a PECL extension, use `pecl install` to download and compile it, then use `docker-php-ext-enable` to enable it:
```dockerfile
FROM %%IMAGE%%:7.1-fpm
RUN pecl install redis-3.1.0 \
&& pecl install xdebug-2.5.0 \
FROM %%IMAGE%%:7.2-fpm
RUN pecl install redis-4.0.1 \
&& pecl install xdebug-2.6.0 \
&& docker-php-ext-enable redis xdebug
```
@ -125,6 +125,12 @@ RUN apt-get update && apt-get install -y libmemcached-dev zlib1g-dev \
&& docker-php-ext-enable memcached
```
It is *strongly* recommended that users use an explicit version number in their `pecl install` invocations to ensure proper PHP version compatibility (PECL does not check the PHP version compatiblity when choosing a version of the extension to install, but does when trying to install it).
For example, `memcached-2.2.0` has no PHP version constraints (https://pecl.php.net/package/memcached/2.2.0), but `memcached-3.0.4` requires PHP 7.0.0 or newer (https://pecl.php.net/package/memcached/3.0.4). When doing `pecl install memcached` (no specific version) on PHP 5.6, PECL will try to install the latest release and fail.
Beyond the compatibility issue, it's also a good practice to ensure you know when your dependencies receive updates and can control those updates directly.
#### Other extensions
Some extensions are not provided via either Core or PECL; these can be installed too, although the process is less automated: