PHPStack

What is PHPStack :

A simple and tiny docker-compose to run Apache2, NGINX, PHP-FPM and MariaDB+PHPMyadmin with a single command.

What is NOT PHPStack :

PHPStack is not a good choice to change it's ports from 127.0.0.0:x to 0.0.0.0:x then use for production, to keep it easy to use, there is not any server hardening, even remote root login is enabled for MariaDB!!!

How to run:

Run in normal mode

Clone the repo and run 'docker-compose up' in terminal.

Run in daemon mode

Clone the repo and run 'docker-compose up -d' in terminal.

How to use:

Web Servers

./wwwroot is mounted as /var/www/ to the NGINX and Apache2 containers. Both NGINX and Apache2 will have access to the wwwroot same as each other and at a same time, so you can test your code with both web servers in parallel.

NGINX and PHP-FPM for NGINX

NGINX web server

By default, NGINX will be available on localhost:80 for HTTP and localhost:443 for HTTPS, you can change mentioned ports by modifying the .env file however, avoid port conflict between NGINX and Apache2 else your containers will not start as expected.
To add new virtual host, use './nginx-and-phpfpm/nginx/sites-enabled/default.conf' as sample and put it in './nginx-and-phpfpm/nginx/sites-enabled' then re-run containers or run 'systemctl reload nginx' inside of "nginx-web" container.
To change NGINX default configuration, modify ./nginx-and-phpfpm/nginx.conf .
To use SSL certificates, put them in './ssl-certs' and it will be available as '/ssl-certs' in the "nginx-web" container. The default code includes a self-signed certificate for *.phpstack.local .

PHP-FPM for NGINX

For NGINX, there is a separated container named "nginx-phpfpm". It will serve NGINX for PHP processing using TCP 9000, you can find the sample configuration file in ./nginx-and-phpfpm/nginx/sites-enabled/default.conf' .
to change PHP configurations, there is an .ini file in './nginx-and-phpfpm/php-fpm/extra.ini' .
Many PHP extensions are included in the code, however, if you need to add more extensions like ioncube, use mentioned .ini file and put your extension files in './nginx-and-phpfpm/php-fpm/extra-extensions' and it will be available as '/usr/local/lib/php/extensions/extra-extensions' in the "nginx-phpfpm" container.
For PHP cronjobs, write your cron tasks in the './nginx-and-phpfpm/php-fpm/cronjobs' and after up tp 2 minutes, it will be automatically loaded into the "nginx-phpfpm" crontab.
For ioncube, the default loader is for Mac M1 with Apple Silicon, to change it to Linux or Windows, modify './apache2-and-phpfpm/php-extra.ini', comment M1 loader uncomment what you need and re-run containers.

Apache2 and PHP for Apache2 (Both in a single container named "apache2-with-php")

Apache2 web server

By default, Apache2 will be available on localhost:880 for HTTP and localhost:8443 for HTTPS, you can change mentioned ports by modifying the .env file however, avoid port conflict between Apache2 and NGINX else your containers will not start as expected.
To add new virtual host, use './apache2-and-php/sites-enabled/default.conf' as sample and put it in './apache2-and-php/sites-enabled/sites-enabled' then re-run containers or run 'systemctl reload apache2' inside of "apache2-with-php" container.
To change Apache2 default configuration, modify ./apache2-and-php/apache2.conf .
To use SSL certificates, put them in './ssl-certs' and it will be available as '/ssl-certs' in the "apache2-with-php" container. The default code includes a self-signed certificate for *.phpstack.local .

PHP for Apache2

To change PHP configurations, there is an .ini file in './apache2-and-phpfpm/php-extra.ini' .
Many PHP extensions are included in the code, however, if you need to add more extensions like ioncube, use mentioned .ini file and put your extension files in './apache2-and-php/php-extra-extensions' and it will be available as '/usr/local/lib/php/extensions/extra-extensions' in the "apache2-with-php" container.
For PHP cronjobs, write your cron tasks in the './apache2-and-php/cronjobs' and after up to 2 minutes, it will be automatically loaded into the "apache2-with-php" crontab.
For ioncube, the default loader is for Mac M1 with Apple Silicon, to change it to Linux or Windows, modify './apache2-and-phpfpm/php-extra.ini', comment M1 loader uncomment what you need and re-run containers.

Database Servers

MariaDB (MySQL) Server and PHPMyadmin

PHPMyadmin will be available on http://localhost:8080 , you can change mentioned ports by modifying the .env file.
Default username/password is root/root however, you can change it by modifying ./docker-compose.yml -> "MYSQL_ROOT_PASSWORD:". Keep in mind, after first run, changing the password in mentioned file will not change DB password becuase all MariaDB data files are stored permanently in ./mariadb/data .
MariaDB will be available to containers with server name "mariadb-10.7" on port "TCP 3306", you can change mentioned ports by modifying the .env file.
Data of the MariaDB including Schema and User databases wil be saved in ./mariadb/data .
To change MariaDB configurations, modify './mariadb/conf.d/50-server.cnf' then re-run containers or run 'systemctl restart mariadb' inside of "mariadb-10.7" container.

amirtq/PHPStack