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

Add information on PHP configuration 

The PHP image will ship with the default development and production
INI files in order to make it easier to securely configure PHP.

See https://github.com/docker-library/php/pull/711
This commit is contained in:
Jakob Linskeseder 2018-08-28 20:00:23 +02:00
parent 225ed2eaa2
commit 3600594ba2
1 changed files with 24 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
php/content.md
View File

@ -6,7 +6,7 @@ PHP is a server-side scripting language designed for web development, but which
%%LOGO%% %%LOGO%%
# How to use this image. # How to use this image
## With Command Line ## With Command Line
@ -56,15 +56,7 @@ $ docker build -t my-php-app .
$ docker run -d --name my-running-app my-php-app $ docker run -d --name my-running-app my-php-app
``` ```
We recommend that you add a custom `php.ini` configuration. `COPY` it into `/usr/local/etc/php` by adding one more line to the Dockerfile above and running the same commands to build and run: We recommend that you add a `php.ini` configuration file, see the "Configuration" section for details.
```dockerfile
FROM %%IMAGE%%:7.2-apache
COPY config/php.ini /usr/local/etc/php/
COPY src/ /var/www/html/
```
Where `src/` is the directory containing all your PHP code and `config/` contains your `php.ini` file.
### Without a `Dockerfile` ### Without a `Dockerfile`
@ -204,3 +196,25 @@ RUN rm /etc/apt/preferences.d/no-debian-php
``` ```
The *proper* solution to this error is to either use `FROM debian:XXX` and install Debian's PHP packages directly, or to use `docker-php-ext-install`, `pecl`, and/or `phpize` to install the necessary additional extensions and utilities. The *proper* solution to this error is to either use `FROM debian:XXX` and install Debian's PHP packages directly, or to use `docker-php-ext-install`, `pecl`, and/or `phpize` to install the necessary additional extensions and utilities.
## Configuration
This image ships with the default [`php.ini-development`](https://github.com/php/php-src/blob/master/php.ini-development) and [`php.ini-production`](https://github.com/php/php-src/blob/master/php.ini-production) configuration files.
It is *strongly* recommended to use the production config for images used in production environments!
The default config can be customized by copying configuration files into the `$PHP_INI_DIR/conf.d/` directory.
### Example
```dockerfile
FROM %%IMAGE%%:7.2-fpm-alpine
# Use the default production configuration
RUN mv $PHP_INI_DIR/php.ini-production $PHP_INI_DIR/php.ini
# Override with custom opcache settings
COPY config/opcache.ini $PHP_INI_DIR/conf.d/
```
Where `config/` contains your custom configuration files.