Skip to content
master
Switch branches/tags
Code

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
 
 
 
 
 
 
src
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

PHPDocker.io

This is the repository for both the website and the generator over at PHPDocker.io, opensourced on an Apache 2.0 license and open for anyone to contribute as they please

Contributing

The usual Github model of forking and pull request. We're following trunk based development, so please create your branches against the master branch. There are no unit tests to keep an eye on, but until I get a functional suite testing ready, code merges can take a while.

All I ask is to thoroughly test, manually, any changes made to the generators. You will need to run the containers with example apps to ensure they're working. Functional tests in the future will do precisely this, with a combination of PHP versions, frameworks, databases, etc. Setting this up is an area you could contribute on.

If you would like to add new containers, please either base them on alpine images, debian:jessie (used by many official images such as MySQL, ElasticSearch...) or Ubuntu 16.04 as these are in use for the generated environments and will optimise deployment and provisioning to users.

Please follow PSR code formatting standards, and Symfony best practices and, in general, do what you see already done in the current code.

Please note everything is really in very early stages; if you see anything at all you can improve upon, please do so.

Running the project

Project is given with a PHPDocker.io generated environment.

Recommended installation is running a make init script: this will set up the app (bower install, composer install, etc) through docker and docker-compose commands.

  • Clone

  • Run make init - this will:

    • clean up caches
    • provision a cert using mkcert
    • create a hosts entry (phpdocker.local)
    • composer and bower install
    • ensure web assets are available
    • start up the environment
  • You can then head off to the /generator route.

This is an initial fail-safe set up and not always you need to run it, after it's done once you'll just need to do a good old docker-compose up -d.

Running the app on Windows is possible using Wsl2 and Docker. More info here: Docker Desktop WSL 2 backend. App will be available at https://localhost:10000/generator route.