From 36c9d82e17a8b028e8a6760e6410b4f89e737b6f Mon Sep 17 00:00:00 2001 From: Tomofumi Inoue Date: Sun, 4 Sep 2016 22:04:59 +0900 Subject: [PATCH] Add README and so on. --- Full description.org.md | 203 ++++++++++++++++++++++++++++++++++++++++ README.md | 197 ++++++++++++++++++++++++++++++++++++-- README.org.md | 11 +++ 3 files changed, 405 insertions(+), 6 deletions(-) create mode 100644 Full description.org.md create mode 100644 README.org.md diff --git a/Full description.org.md b/Full description.org.md new file mode 100644 index 000000000..84058635c --- /dev/null +++ b/Full description.org.md @@ -0,0 +1,203 @@ +# Supported tags and respective `Dockerfile` links + +- [`7.0.10-cli`, `7.0-cli`, `7-cli`, `cli`, `7.0.10`, `7.0`, `7`, `latest` (*7.0/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/Dockerfile) +- [`7.0.10-alpine`, `7.0-alpine`, `7-alpine`, `alpine` (*7.0/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/alpine/Dockerfile) +- [`7.0.10-apache`, `7.0-apache`, `7-apache`, `apache` (*7.0/apache/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/apache/Dockerfile) +- [`7.0.10-fpm`, `7.0-fpm`, `7-fpm`, `fpm` (*7.0/fpm/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/fpm/Dockerfile) +- [`7.0.10-fpm-alpine`, `7.0-fpm-alpine`, `7-fpm-alpine`, `fpm-alpine` (*7.0/fpm/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/fpm/alpine/Dockerfile) +- [`7.0.10-zts`, `7.0-zts`, `7-zts`, `zts` (*7.0/zts/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/zts/Dockerfile) +- [`7.0.10-zts-alpine`, `7.0-zts-alpine`, `7-zts-alpine`, `zts-alpine` (*7.0/zts/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/7.0/zts/alpine/Dockerfile) +- [`5.6.25-cli`, `5.6-cli`, `5-cli`, `5.6.25`, `5.6`, `5` (*5.6/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/Dockerfile) +- [`5.6.25-alpine`, `5.6-alpine`, `5-alpine` (*5.6/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/alpine/Dockerfile) +- [`5.6.25-apache`, `5.6-apache`, `5-apache` (*5.6/apache/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/apache/Dockerfile) +- [`5.6.25-fpm`, `5.6-fpm`, `5-fpm` (*5.6/fpm/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/fpm/Dockerfile) +- [`5.6.25-fpm-alpine`, `5.6-fpm-alpine`, `5-fpm-alpine` (*5.6/fpm/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/fpm/alpine/Dockerfile) +- [`5.6.25-zts`, `5.6-zts`, `5-zts` (*5.6/zts/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/zts/Dockerfile) +- [`5.6.25-zts-alpine`, `5.6-zts-alpine`, `5-zts-alpine` (*5.6/zts/alpine/Dockerfile*)](https://github.com/docker-library/php/blob/2f96a00aaa90ee1c503140724936ca7005273df5/5.6/zts/alpine/Dockerfile) + +For more information about this image and its history, please see [the relevant manifest file (`library/php`)](https://github.com/docker-library/official-images/blob/master/library/php). This image is updated via [pull requests to the `docker-library/official-images` GitHub repo](https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fphp). + +For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see [the `repos/php/tag-details.md` file](https://github.com/docker-library/repo-info/blob/master/repos/php/tag-details.md) in [the `docker-library/repo-info` GitHub repo](https://github.com/docker-library/repo-info). + +# What is PHP? + +PHP is a server-side scripting language designed for web development, but which can also be used as a general-purpose programming language. PHP can be added to straight HTML or it can be used with a variety of templating engines and web frameworks. PHP code is usually processed by an interpreter, which is either implemented as a native module on the web-server or as a common gateway interface (CGI). + +> [wikipedia.org/wiki/PHP](http://en.wikipedia.org/wiki/PHP) + +![logo](https://raw.githubusercontent.com/docker-library/docs/01c12653951b2fe592c1f93a13b4e289ada0e3a1/php/logo.png) + +# How to use this image. + +## With Command Line + +For PHP projects run through the command line interface (CLI), you can do the following. + +### Create a `Dockerfile` in your PHP project + +```dockerfile +FROM php:7.0-cli +COPY . /usr/src/myapp +WORKDIR /usr/src/myapp +CMD [ "php", "./your-script.php" ] +``` + +Then, run the commands to build and run the Docker image: + +```console +$ docker build -t my-php-app . +$ docker run -it --rm --name my-running-app my-php-app +``` + +### Run a single PHP script + +For many simple, single file projects, you may find it inconvenient to write a complete `Dockerfile`. In such cases, you can run a PHP script by using the PHP Docker image directly: + +```console +$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp php:7.0-cli php your-script.php +``` + +## With Apache + +More commonly, you will probably want to run PHP in conjunction with Apache httpd. Conveniently, there's a version of the PHP container that's packaged with the Apache web server. + +### Create a `Dockerfile` in your PHP project + +```dockerfile +FROM php:7.0-apache +COPY src/ /var/www/html/ +``` + +Where `src/` is the directory containing all your PHP code. Then, run the commands to build and run the Docker image: + +```console +$ docker build -t 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: + +```dockerfile +FROM php:7.0-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. + +### How to install more PHP extensions + +We provide the helper scripts `docker-php-ext-configure`, `docker-php-ext-install`, and `docker-php-ext-enable` to more easily install PHP extensions. + +In order to keep the images smaller, PHP's source is kept in a compressed tar file. To facilitate linking of PHP's source with any extension, we also provide the helper script `docker-php-source` to easily extract the tar or delete the extracted source. Note: if you do use `docker-php-source` to extract the source, be sure to delete it in the same layer of the docker image. + +```Dockerfile +FROM php:7.0-apache +RUN docker-php-source extract \ + # do important things \ + && docker-php-source delete +``` + +#### PHP Core Extensions + +For example, if you want to have a PHP-FPM image with `iconv`, `mcrypt` and `gd` extensions, you can inherit the base image that you like, and write your own `Dockerfile` like this: + +```dockerfile +FROM php:7.0-fpm +RUN apt-get update && apt-get install -y \ + libfreetype6-dev \ + libjpeg62-turbo-dev \ + libmcrypt-dev \ + libpng12-dev \ + && docker-php-ext-install -j$(nproc) iconv mcrypt \ + && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \ + && docker-php-ext-install -j$(nproc) gd +``` + +Remember, you must install dependencies for your extensions manually. If an extension needs custom `configure` arguments, you can use the `docker-php-ext-configure` script like this example. There is no need to run `docker-php-source` manually in this case, since that is handled by the `configure` and `install` scripts. + +#### PECL extensions + +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 php:7.0-fpm +RUN apt-get update && apt-get install -y libmemcached-dev \ + && pecl install memcached \ + && docker-php-ext-enable memcached +``` + +#### Other extensions + +Some extensions are not provided via either Core or PECL; these can be installed too, although the process is less automated: + +```dockerfile +FROM php:7.0-apache +RUN curl -fsSL 'https://xcache.lighttpd.net/pub/Releases/3.2.0/xcache-3.2.0.tar.gz' -o xcache.tar.gz \ + && mkdir -p xcache \ + && tar -xf xcache.tar.gz -C xcache --strip-components=1 \ + && rm xcache.tar.gz \ + && ( \ + cd xcache \ + && phpize \ + && ./configure --enable-xcache \ + && make -j$(nproc) \ + && make install \ + ) \ + && rm -r xcache \ + && docker-php-ext-enable xcache +``` + +### Without a `Dockerfile` + +If you don't want to include a `Dockerfile` in your project, it is sufficient to do the following: + +```console +$ docker run -d -p 80:80 --name my-apache-php-app -v "$PWD":/var/www/html php:7.0-apache +``` + +# Image Variants + +The `php` images come in many flavors, each designed for a specific use case. + +## `php:` + +This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of. + +## `php:alpine` + +This image is based on the popular [Alpine Linux project](http://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general. + +This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc](http://www.musl-libc.org) instead of [glibc and friends](http://www.etalabs.net/compare_libcs.html), so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread](https://news.ycombinator.com/item?id=10782897) for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images. + +To minimize image size, it's uncommon for additional related tools (such as `git` or `bash`) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the [`alpine` image description](https://hub.docker.com/_/alpine/) for examples of how to install packages if you are unfamiliar). + +# License + +View [license information](http://php.net/license/) for the software contained in this image. + +# Supported Docker versions + +This image is officially supported on Docker version 1.12.1. + +Support for older versions (down to 1.6) is provided on a best-effort basis. + +Please see [the Docker installation documentation](https://docs.docker.com/installation/) for details on how to upgrade your Docker daemon. + +# User Feedback + +## Documentation + +Documentation for this image is stored in the [`php/` directory](https://github.com/docker-library/docs/tree/master/php) of the [`docker-library/docs` GitHub repo](https://github.com/docker-library/docs). Be sure to familiarize yourself with the [repository's `README.md` file](https://github.com/docker-library/docs/blob/master/README.md) before attempting a pull request. + +## Issues + +If you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/docker-library/php/issues). If the issue is related to a CVE, please check for [a `cve-tracker` issue on the `official-images` repository first](https://github.com/docker-library/official-images/issues?q=label%3Acve-tracker). + +You can also reach many of the official image maintainers via the `#docker-library` IRC channel on [Freenode](https://freenode.net). + +## Contributing + +You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can. + +Before you start to code, we recommend discussing your plans through a [GitHub issue](https://github.com/docker-library/php/issues), especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing. diff --git a/README.md b/README.md index 76720b5b2..c1a77bffe 100644 --- a/README.md +++ b/README.md @@ -1,11 +1,196 @@ -# About this Repo +# Supported tags and respective `Dockerfile` links -This is the Git repo of the Docker [official image](https://docs.docker.com/docker-hub/official_repos/) for [php](https://registry.hub.docker.com/_/php/). See [the Docker Hub page](https://registry.hub.docker.com/_/php/) for the full readme on how to use this Docker image and for information regarding contributing and issues. +- [`5.5.38-cli`, `5.5-cli`, `5-cli`, `cli`, `5.5.38`, `5.5`, `5`, `latest` (*5.5/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/Dockerfile) +- [`5.5.38-alpine`, `5.5-alpine`, `5-alpine`, `alpine` (*5.5/alpine/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/alpine/Dockerfile) +- [`5.5.38-apache`, `5.5-apache`, `5-apache`, `apache` (*5.5/apache/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/apache/Dockerfile) +- [`5.5.38-fpm`, `5.5-fpm`, `5-fpm`, `fpm` (*5.5/fpm/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/fpm/Dockerfile) +- [`5.5.38-fpm-alpine`, `5.5-fpm-alpine`, `5-fpm-alpine`, `fpm-alpine` (*5.5/fpm/alpine/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/fpm/alpine/Dockerfile) +- [`5.5.38-zts`, `5.5-zts`, `5-zts`, `zts` (*5.5/zts/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/zts/Dockerfile) +- [`5.5.38-zts-alpine`, `5.5-zts-alpine`, `5-zts-alpine`, `zts-alpine` (*5.5/zts/alpine/Dockerfile*)](https://github.com/GitHub30/php/blob/5.5/5.5/zts/alpine/Dockerfile) -The full readme is generated over in [docker-library/docs](https://github.com/docker-library/docs), specifically in [docker-library/docs/php](https://github.com/docker-library/docs/tree/master/php). +For more information about this image and its history, please see [the relevant manifest file (`library/php`)](https://github.com/docker-library/official-images/blob/master/library/php). This image is updated via [pull requests to the `docker-library/official-images` GitHub repo](https://github.com/docker-library/official-images/pulls?q=label%3Alibrary%2Fphp). -See a change merged here that doesn't show up on the Docker Hub yet? Check [the "library/php" manifest file in the docker-library/official-images repo](https://github.com/docker-library/official-images/blob/master/library/php), especially [PRs with the "library/php" label on that repo](https://github.com/docker-library/official-images/labels/library%2Fphp). For more information about the official images process, see the [docker-library/official-images readme](https://github.com/docker-library/official-images/blob/master/README.md). +For detailed information about the virtual/transfer sizes and individual layers of each of the above supported tags, please see [the `repos/php/tag-details.md` file](https://github.com/docker-library/repo-info/blob/master/repos/php/tag-details.md) in [the `docker-library/repo-info` GitHub repo](https://github.com/docker-library/repo-info). -[![Travis CI](https://img.shields.io/travis/docker-library/php/master.svg)](https://travis-ci.org/docker-library/php/branches) +# What is PHP? - +PHP is a server-side scripting language designed for web development, but which can also be used as a general-purpose programming language. PHP can be added to straight HTML or it can be used with a variety of templating engines and web frameworks. PHP code is usually processed by an interpreter, which is either implemented as a native module on the web-server or as a common gateway interface (CGI). + +> [wikipedia.org/wiki/PHP](http://en.wikipedia.org/wiki/PHP) + +![logo](https://raw.githubusercontent.com/docker-library/docs/01c12653951b2fe592c1f93a13b4e289ada0e3a1/php/logo.png) + +# How to use this image. + +## With Command Line + +For PHP projects run through the command line interface (CLI), you can do the following. + +### Create a `Dockerfile` in your PHP project + +```dockerfile +FROM php:5.5-cli +COPY . /usr/src/myapp +WORKDIR /usr/src/myapp +CMD [ "php", "./your-script.php" ] +``` + +Then, run the commands to build and run the Docker image: + +```console +$ docker build -t my-php-app . +$ docker run -it --rm --name my-running-app my-php-app +``` + +### Run a single PHP script + +For many simple, single file projects, you may find it inconvenient to write a complete `Dockerfile`. In such cases, you can run a PHP script by using the PHP Docker image directly: + +```console +$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp php:5.5-cli php your-script.php +``` + +## With Apache + +More commonly, you will probably want to run PHP in conjunction with Apache httpd. Conveniently, there's a version of the PHP container that's packaged with the Apache web server. + +### Create a `Dockerfile` in your PHP project + +```dockerfile +FROM php:5.5-apache +COPY src/ /var/www/html/ +``` + +Where `src/` is the directory containing all your PHP code. Then, run the commands to build and run the Docker image: + +```console +$ docker build -t 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: + +```dockerfile +FROM php:5.5-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. + +### How to install more PHP extensions + +We provide the helper scripts `docker-php-ext-configure`, `docker-php-ext-install`, and `docker-php-ext-enable` to more easily install PHP extensions. + +In order to keep the images smaller, PHP's source is kept in a compressed tar file. To facilitate linking of PHP's source with any extension, we also provide the helper script `docker-php-source` to easily extract the tar or delete the extracted source. Note: if you do use `docker-php-source` to extract the source, be sure to delete it in the same layer of the docker image. + +```Dockerfile +FROM php:5.5-apache +RUN docker-php-source extract \ + # do important things \ + && docker-php-source delete +``` + +#### PHP Core Extensions + +For example, if you want to have a PHP-FPM image with `iconv`, `mcrypt` and `gd` extensions, you can inherit the base image that you like, and write your own `Dockerfile` like this: + +```dockerfile +FROM php:5.5-fpm +RUN apt-get update && apt-get install -y \ + libfreetype6-dev \ + libjpeg62-turbo-dev \ + libmcrypt-dev \ + libpng12-dev \ + && docker-php-ext-install -j$(nproc) iconv mcrypt \ + && docker-php-ext-configure gd --with-freetype-dir=/usr/include/ --with-jpeg-dir=/usr/include/ \ + && docker-php-ext-install -j$(nproc) gd +``` + +Remember, you must install dependencies for your extensions manually. If an extension needs custom `configure` arguments, you can use the `docker-php-ext-configure` script like this example. There is no need to run `docker-php-source` manually in this case, since that is handled by the `configure` and `install` scripts. + +#### PECL extensions + +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 php:5.5-fpm +RUN apt-get update && apt-get install -y libmemcached-dev \ + && pecl install memcached \ + && docker-php-ext-enable memcached +``` + +#### Other extensions + +Some extensions are not provided via either Core or PECL; these can be installed too, although the process is less automated: + +```dockerfile +FROM php:5.5-apache +RUN curl -fsSL 'https://xcache.lighttpd.net/pub/Releases/3.2.0/xcache-3.2.0.tar.gz' -o xcache.tar.gz \ + && mkdir -p xcache \ + && tar -xf xcache.tar.gz -C xcache --strip-components=1 \ + && rm xcache.tar.gz \ + && ( \ + cd xcache \ + && phpize \ + && ./configure --enable-xcache \ + && make -j$(nproc) \ + && make install \ + ) \ + && rm -r xcache \ + && docker-php-ext-enable xcache +``` + +### Without a `Dockerfile` + +If you don't want to include a `Dockerfile` in your project, it is sufficient to do the following: + +```console +$ docker run -d -p 80:80 --name my-apache-php-app -v "$PWD":/var/www/html php:5.5-apache +``` + +# Image Variants + +The `php` images come in many flavors, each designed for a specific use case. + +## `php:` + +This is the defacto image. If you are unsure about what your needs are, you probably want to use this one. It is designed to be used both as a throw away container (mount your source code and start the container to start your app), as well as the base to build other images off of. + +## `php:alpine` + +This image is based on the popular [Alpine Linux project](http://alpinelinux.org), available in [the `alpine` official image](https://hub.docker.com/_/alpine). Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general. + +This variant is highly recommended when final image size being as small as possible is desired. The main caveat to note is that it does use [musl libc](http://www.musl-libc.org) instead of [glibc and friends](http://www.etalabs.net/compare_libcs.html), so certain software might run into issues depending on the depth of their libc requirements. However, most software doesn't have an issue with this, so this variant is usually a very safe choice. See [this Hacker News comment thread](https://news.ycombinator.com/item?id=10782897) for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images. + +To minimize image size, it's uncommon for additional related tools (such as `git` or `bash`) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the [`alpine` image description](https://hub.docker.com/_/alpine/) for examples of how to install packages if you are unfamiliar). + +# License + +View [license information](http://php.net/license/) for the software contained in this image. + +# Supported Docker versions + +This image is officially supported on Docker version 1.12.1. + +Support for older versions (down to 1.6) is provided on a best-effort basis. + +Please see [the Docker installation documentation](https://docs.docker.com/installation/) for details on how to upgrade your Docker daemon. + +# User Feedback + +## Documentation + +Documentation for this image is stored in the [`php/` directory](https://github.com/docker-library/docs/tree/master/php) of the [`docker-library/docs` GitHub repo](https://github.com/docker-library/docs). Be sure to familiarize yourself with the [repository's `README.md` file](https://github.com/docker-library/docs/blob/master/README.md) before attempting a pull request. + +## Issues + +If you have any problems with or questions about this image, please contact us through a [GitHub issue](https://github.com/docker-library/php/issues). If the issue is related to a CVE, please check for [a `cve-tracker` issue on the `official-images` repository first](https://github.com/docker-library/official-images/issues?q=label%3Acve-tracker). + +You can also reach many of the official image maintainers via the `#docker-library` IRC channel on [Freenode](https://freenode.net). + +## Contributing + +You are invited to contribute new features, fixes, or updates, large or small; we are always thrilled to receive pull requests, and do our best to process them as fast as we can. + +Before you start to code, we recommend discussing your plans through a [GitHub issue](https://github.com/docker-library/php/issues), especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing. diff --git a/README.org.md b/README.org.md new file mode 100644 index 000000000..76720b5b2 --- /dev/null +++ b/README.org.md @@ -0,0 +1,11 @@ +# About this Repo + +This is the Git repo of the Docker [official image](https://docs.docker.com/docker-hub/official_repos/) for [php](https://registry.hub.docker.com/_/php/). See [the Docker Hub page](https://registry.hub.docker.com/_/php/) for the full readme on how to use this Docker image and for information regarding contributing and issues. + +The full readme is generated over in [docker-library/docs](https://github.com/docker-library/docs), specifically in [docker-library/docs/php](https://github.com/docker-library/docs/tree/master/php). + +See a change merged here that doesn't show up on the Docker Hub yet? Check [the "library/php" manifest file in the docker-library/official-images repo](https://github.com/docker-library/official-images/blob/master/library/php), especially [PRs with the "library/php" label on that repo](https://github.com/docker-library/official-images/labels/library%2Fphp). For more information about the official images process, see the [docker-library/official-images readme](https://github.com/docker-library/official-images/blob/master/README.md). + +[![Travis CI](https://img.shields.io/travis/docker-library/php/master.svg)](https://travis-ci.org/docker-library/php/branches) + +