diff --git a/php/README-content.md b/php/README-content.md
new file mode 100644
index 000000000..7634c993a
--- /dev/null
+++ b/php/README-content.md
@@ -0,0 +1,48 @@
+# What is PHP?
+PHP is a server-side scripting language designed for web development but also used as a general-purpose programming language. As of January 2013, PHP was installed on more than 240 million websites and 2.1 million web servers.
+
+>[wikipedia.org/wiki/PHP](http://en.wikipedia.org/wiki/PHP)
+
+# How to use this image.
+
+## Commandline
+
+In the case that you have a PHP project run through the command line interface, you can do the following.
+
+### Create a `Dockerfile` in your php project.
+
+    FROM php:5.6-cli
+    ADD . /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 single file projects, it may not be convenient to write a `Dockerfile` for your project. 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
+
+In the more common case, 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
+    ADD . /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, then it is sufficient to do the following.
+
+    docker run -it --rm --name my-apache-php-app -v $(pwd):/var/www/html php:5.6-cli
diff --git a/php/README.md b/php/README.md
new file mode 100644
index 000000000..192d9dd13
--- /dev/null
+++ b/php/README.md
@@ -0,0 +1,60 @@
+# What is PHP?
+PHP is a server-side scripting language designed for web development but also used as a general-purpose programming language. As of January 2013, PHP was installed on more than 240 million websites and 2.1 million web servers.
+
+>[wikipedia.org/wiki/PHP](http://en.wikipedia.org/wiki/PHP)
+
+# How to use this image.
+
+## Commandline
+
+In the case that you have a PHP project run through the command line interface, you can do the following.
+
+### Create a `Dockerfile` in your php project.
+
+    FROM php:5.6-cli
+    ADD . /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 single file projects, it may not be convenient to write a `Dockerfile` for your project. 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
+
+In the more common case, 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
+    ADD . /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, then it is sufficient to do the following.
+
+    docker run -it --rm --name my-apache-php-app -v $(pwd):/var/www/html php:5.6-cli
+
+# User Feedback
+
+## Issues
+
+If you have any questions about the image, please contact us through a [GitHub issue](https://github.com/docker-library/php/issues) or in the IRC channel `#docker-library` on [Freenode](https://freenode.net).
+
+## Contributing
+
+If you want to contribute new features or updates, we are always thrilled to receive pull requests, and do our best to process them as fast as possible.
+
+We recommend discussing your plans through a [GitHub issue](https://github.com/docker-library/php/issues) before starting to code - especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give feedback on your design, and maybe point out if someone else is working on the same thing.