High speed low drag PHP using Docker.

I use this setup specifically with PhpStorm.

Development environment as code AKA Infrastructure as code

Make sure you have Docker and Docker Compose installed.

Installing Docker on Windows 10

YouTube: Installing Docker on Windows 10

YouTube: Installing Docker on Ubuntu

From the directory root of the project run docker-compose up open your browser to http://localhost:8001.

To stop the Docker container, from the Docker CLI windows press [Control]-C.

Edit the docker-compose.yml file changing the /app path appropriately, or replace the code in /app with your code.

You may need to put your project on the Linux side of WSL2 to get better performance and file permissions.

https://docs.microsoft.com/en-us/windows/wsl/compare-versions#performance-across-os-file-systems

Stop the Docker containers.

Do a search and replace in the file docker-compose.yml for php8 with php5 or php7.

For PHP 5 you will need to switch from the xdebug_3.x.x.ini file to the xdebug_2.x.x.ini file.

Then run docker-compose build.

Next, start the docker container by running docker-compose up.

PHP Composer https://getcomposer.org/ is installed by default and can be run inside the dev-server container with the command composer.

docker exec -it dev-server bash

user@45640a57cf9f:/app$ composer (command)

The current configuration will look for an SSH key in ~/.ssh/id_rsa.

If you don't need that comment out any lines that reference that.

XDebug is installed and configured separately for the command line (CLI) and web (HTTP).

The XDebug configuration for the command line can be found in ./docker/php/confi.d for each version of PHP.

The command line is not configured for debugging by default, but is configured for profiling and coverage. This is to support PHPUnit and Codeception. It also keeps the IDE debugger from being triggered by the PHP cli tools. You can change this behaviour by editing the ./docker/php/confi.d file.

XDebug for the web with breakpoints is accomplished via the environment variables for PHP.

During dev server startup the XDebug environment variables override the CLI setup. XDebug will attempt to open a connection back to your IDE on port 9000 for web requests.

You can edit the line command: bash -c 'export XDEBUG_MODE=debug,develop,gcstats,profile,trace XDEBUG_CONFIG="remote_enable=on"; php -S 0.0.0.0:80 -t /app/html' in the docker-compose.yml file to change this behaviour.

Execution statistics will be dumped in \xdebug.info. You can use profiling tools like PhpStorms' Tools->Analyze XDebug Profile Snapshot.

The profile file will be called profile.out.

Other statistic like garbage collect gcstats.out and trace trace.out.txt can also be found in xdebug.info.

Codeception https://codeception.com/ is installed by default and can be run inside the dev-server container with codeception.

docker exec -it dev-server bash

user@45640a57cf9f:/app$ codeception (command)

The docker-compose.yml includes a MariaDB server and PhpMyAdmin setup by default. It is set up to allow quick access to the database using a browser.

To access the PhpMyAdmin tool open http://localhost:9082.

To change the default database name, edit the docker-compose.yml file and change "database_name" to your default database name.

A startup database can be created by placing a scrip in the db-startup directory. See the README.md file in that directory for detail.

The docker-compose.yml includes a Redis cache server.

To access to Redis web tool open http://localhost:9083.

The prod-server can be used to simulate the code in a production type environment, without the overhead of the debugger or other libraries.

Be sure to tell composer to install the production libraries using composer install --no-dev from the development container.

The production server is available at http://localhost:8002.

The performance-testing container is used for testing the code relative to itself. You can use this tool to test different versions of PHP. Different caching methodologies and different database select.

The idea is that using this tool you can see if your code is getting faster of slower for any given changes.

You can keep a record of past performance tests to make a before and after comparison.

To run the sample test, open a bash shell into the performance-testing container. From that change directory into performance-testing and run ./test1.sh.

https://httpd.apache.org/docs/2.4/programs/ab.html

After testing and checking in the code to the dev branch, checkout the qa branch and run the same tests.
Using this as a baseline you can see if your code has gotten faster or slower.

This is just a starting point. Use this project a template for starting or moving your project to docker.

10/6/2021 - If you are using the PhpStorm and your files are in the wsl os, ie \\wsl$\..., you will need to start Docker Desktop after you start PhpStorm. If you do not, PhpStorm may hang on Indexing. This may also apply to other JetBrains products. You can "Exit" Docker Desktop restart PhpStorm let it finish indexing then restart Docker Desktop as well to get past the PhpStorm hang.

Sometimes you will just need to purge all the images docker system prune -a and restart Docker.