docs/php/README.md

105 lines
4.3 KiB
Markdown

# Supported tags and respective `Dockerfile` links
- [`5.4.34-cli`, `5.4-cli`, `5.4.34`, `5.4` (*5.4/Dockerfile*)](https://github.com/docker-library/php/blob/f8a3ea57872453063f6416d1a1e92011daa19a0e/5.4/Dockerfile)
- [`5.4.34-apache`, `5.4-apache` (*5.4/apache/Dockerfile*)](https://github.com/docker-library/php/blob/9fc452451b227d1d20b77183cacc26906c9f669d/5.4/apache/Dockerfile)
- [`5.5.18-cli`, `5.5-cli`, `5.5.18`, `5.5` (*5.5/Dockerfile*)](https://github.com/docker-library/php/blob/f8a3ea57872453063f6416d1a1e92011daa19a0e/5.5/Dockerfile)
- [`5.5.18-apache`, `5.5-apache` (*5.5/apache/Dockerfile*)](https://github.com/docker-library/php/blob/6527e41240379ce1112b629a505ef9752f42a64f/5.5/apache/Dockerfile)
- [`5.6.2-cli`, `5.6-cli`, `5-cli`, `cli`, `5.6.2`, `5.6`, `5`, `latest` (*5.6/Dockerfile*)](https://github.com/docker-library/php/blob/f8a3ea57872453063f6416d1a1e92011daa19a0e/5.6/Dockerfile)
- [`5.6.2-apache`, `5.6-apache`, `5-apache`, `apache` (*5.6/apache/Dockerfile*)](https://github.com/docker-library/php/blob/524908779e1de87ab8fbd50f544c798782d8fc06/5.6/apache/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)
in the [`docker-library/official-images` GitHub
repo](https://github.com/docker-library/official-images).
# 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/master/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
FROM php:5.6-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:
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:
docker run -it --rm --name my-running-script -v "$(pwd)":/usr/src/myapp -w /usr/src/myapp php:5.6-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
FROM php:5.6-apache
COPY . /var/www/html
Then, run the commands to build and run the Docker image:
docker build -t my-php-app .
docker run -it --rm --name my-running-app my-php-app
### Without a `Dockerfile`
If you don't want to include a `Dockerfile` in your project, it is sufficient to
do the following:
docker run -it --rm --name my-apache-php-app -v "$(pwd)":/var/www/html php:5.6-apache
# License
View [license information](http://php.net/license/)
for the software contained in this image.
# User Feedback
## 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).
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.