How to run PHP in Docker?

When running PHP, you need to pay attention to the environment configuration and container stability when running Docker. First, prepare a PHP project with a clear structure, ensure that there are dependent files such as composer.json, and place the code in an independent directory for mounting; second, use the official PHP image to quickly start container testing, such as using the CLI image to execute simple scripts; then write a custom Dockerfile image, copy the code, install the extensions, and enable the necessary modules; finally handle debugging and common problems, including permissions, missing dependencies, Apache operation and log viewing. It is recommended to build a custom image and optimize the configuration when deploying and launching it online.

Running PHP is not difficult on Docker, but to ensure that the environment is configured correctly and the container runs stably, you need to pay attention to several key points. Let’s talk about how to operate it directly.

Get your PHP project ready

Before using Docker, make sure that your PHP project has a clear structure and necessary dependencies, such as composer.json (if you use Composer to manage dependencies). This way, the extension can be installed smoothly when building the image later.

In addition, it is recommended to place the code in a separate directory to facilitate mounting into the container. You don't need to package it into a mirror from the beginning. Just try it quickly with the official mirror.

Run containers using the official PHP image

Docker Hub provides multiple versions of PHP official images , you can choose a version with Apache or FPM, or you can use the CLI version for testing.

For example, running a simple PHP CLI container:

 docker run -it --rm -v $(pwd):/var/www/html php:8.2-cli php /var/www/html/index.php

This line of command does a few things:

• Start a temporary container ( --rm means automatically deleted after exiting)
• Mount the current directory into /var/www/html in the container
• Execute php index.php , which is your local PHP file

If it is a web project, you can use Apache or Nginx PHP-FPM combination, but it is not necessary to be too complicated at the beginning.

Write a Dockerfile custom image

When you need a fixed environment or deployment to go live, you should write a Dockerfile to build your own image. For example, this example:

 FROM php:8.2-apache
COPY . /var/www/html/
RUN docker-php-ext-install mysqli && a2enmod rewrite

Let me explain:

• Building based on PHP image with Apache
• Copy the local code into
• Install common extensions (such as mysqli) and enable mod_rewrite to support pseudostatic

Then build and run with the following command:

 docker build -t my-php-app .
docker run -d -p 8080:80 my-php-app

Visit localhost:8080 to see your PHP page.

Debugging and handling of FAQs

After running, you may encounter these problems:

• Permissions issue : Make sure that the files in the mount directory are loaded and the users in the container have read permissions.
• Dependency is not installed : Some PHP extensions are not provided by default and need to be manually installed in Dockerfile
• Apache is not started : When using Apache mirror, make sure the foreground is running or CMD is configured correctly
• Log viewing : Use docker logs to view the run log, and troubleshoot errors are faster

If it is just a development test, you can directly use the official image to add the mount directory; if you want to deploy it online, it is recommended to build a custom image and add steps such as expansion and configuration optimization.

Basically that's it. Don’t think about getting it done in one step as soon as you come up, run it first and then optimize it.

The above is the detailed content of How to run PHP in Docker?. For more information, please follow other related articles on the PHP Chinese website!