This environment provies the following tools to develop in PHP :
Available version :
- `7.0`
- `7.1`
- `7.2`
The version is configured in .env file. Default: 7.2
PHP Stack run on Alpine version to keep a small size image.
- Database
Two different database are available :
- [MySQL](https://www.mysql.com)
- [MongoDB](https://www.mongodb.com)
The database wished is configured in .env file. Default: mysql
- Web server
Two web server are available :
- [Nginx](https://nginx.org)
- [Apache](https://httpd.apache.org/)
All of them are in Alpine version.
- Cache server
Two cache server are available :
- [Redis](https://redis.io/)
- [Memcached](https://memcached.org/)
All of them are in Alpine version
- MongoExpress : Manage Mongo database instances
- PHPMyAdmin : Manage Mongo database instances
- MailDev : SMTP Server + Web Interface for viewing and testing emails during development
- Composer : Dependency Manager for PHP
- NodeJs : JavaScript runtime
A Makefile is available in command line to manage several actions.
Type following command to display help :
makeor
make helpOutput:
help: Show this help
servers: Start all containers
start: Start all containers
stop: Stop all containers
restart: Restart all containers
certificate: Generate a SSL certificate
renewal: Renewal a knowed SSL certificate
install: Install EnvDev container environment
homepage: Launch EnvDev homepage in default browserOptional tools are available to use in EnvDev. They are not included by default but can be added easily.
- APIGen : Documentation for your PHP project
Image container : vfac/apigen
- Deployer : Deployment tool for PHP
Image container : vfac/deployer
Two system dependencies are required :
- Docker
- Docker Compose
git clone git@github.com:vfalies/EnvDev.gitCreate a .env file to define your configuration.
An example is available with .env.dist file.
To install environment
make installTo start the environment, type the following command:
make serversor
make startSeveral containers are created from .env configuration:
| Description | Container's name |
|---|---|
| Maildev hub mail | maildev |
| NodeJs | nodejs |
| Web server ( Apache or Nginx ) | web |
| PHP container | php |
| Cache server | cache |
| Database server | db |
| Database admin tool | dbadmin |
composer is available through php container:
docker exec php composer -vnode, npm are available through node container:
docker run --rm node node -vdocker run --rm node npm -vTo open default home page in browser
make homepageYou can add your own hosts file for all your projects.
With NGinx
In conf/nginx/vhosts directory, all your yourhost.conf file. A default host file is available for example : /conf/nginx/vhosts/default.conf.
server {
listen 80;
server_name localhost;
root /var/www/html;
index index.php index.html index.htm;
location ~* \.PHP$ {
fastcgi_index index.php;
fastcgi_pass php:9000;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
With Apache
In conf/apache/vhosts directory, all your yourhost.conf file. A default host file is available for example : /conf/apache/vhosts/default.conf.
<VirtualHost *:80>
ServerName localhost
DocumentRoot /var/www/html/projects
<Directory /var/www/html/projects>
Require all granted
</Directory>
<FilesMatch \.php$>
SetHandler "proxy:fcgi://php:9000"
</FilesMatch>
</VirtualHost>
The SSL support is possible during development. To activate it on one of your vhosts, you must follow steps:
- Create the SSL self-signed certificate
you can use the command:
make certificate- Add the activation of SSL in VHost file
On Nginx:
listen 443 ssl;
ssl_certificate /etc/nginx/ssl/envdev.crt;
ssl_certificate_key /etc/nginx/ssl/envdev.key;
On Apache:
<VirtualHost *:80 *:443>
...
SSLEngine on
SSLCertificateFile /usr/local/apache2/conf/custom/envdev.crt
SSLCertificateKeyFile /usr/local/apache2/conf/custom/envdev.key
...
where envdev is the name chosen during the step of the certificate creation.
Don't forget to restart web container to restart the web server
docker restart webTips: If you certificate is out of date, you can renew it with the command:
make renewalYou can create .env file to manage applications and tools.
An example is available with .env.dist file.
The following versions, paths and ports can be configured :
| Description | Variable name | Possible values | Default |
|---|---|---|---|
| PHP Version | PHP_VERSION | 7.0, 7.1, 7.2 |
7.2 |
| Database type | DB | mariadb, mysql, mongodb |
mysql |
| Cache server type | CACHE_SERVER | redis, memcached |
redis |
| Projects Path | PROJECTS_PATH | any | /your/projects/directory/path |
| HTTP web port | WEB_PORT | any | 80 |
| HTTPS web port | WEBSSL_PORT | any | 443 |
| MailDev port | MAILDEV_PORT | any | 1080 |
| PHPMyAdmin port | PHPMYADMIN_PORT | any | 9090 |
| MongoExpress port | MONGOEXPRESS_PORT | any | 8081 |
| Cache server port | CACHE_PORT | any | 6380 |
If you access to the url http://envdev.localhost a page summarizes all projets and propose access link to PHPMyAdmin, MailDev and PHPInfo.
Nginx configuration file is available at /conf/nginx/nginx.conf to custom the web server configuration.
Apache configuration file is available at /conf/apache/httpd.conf to custom the web server configuration.
A custom php.ini file is available at /conf/php/php.ini. The default PHP configuration is with these options:
date.timezone = Europe/Paris
display_errors=1
error_reporting=E_ALL
log_errors = on
error_log = /var/log/php_errors.log
memory_limit = 256M
upload_max_filesize = 200M
post_max_size = 40M
To simplify projects source sharing between containers, you can install source projects in the path define in .env with variable PROJECTS_PATH.
Naturally, you can change the default path. In this case, the default summary will not be available.
EnvDev is licensed under the MIT License and published through GitHub