dofda3 (in Arabic ضفدع) is A vagrant box Ready to use as A Linux Development Environment for PHP Developers Includes Ubuntu 18.04.2, Apache 2.4.39 MySQL 5.7.25, Multi PHP Versions (PHP 5.6, PHP 7.0, PHP 7.1, PHP 7.2, PHP 7.3), phpMyAdmin 4.8.5, MailHog
To use dofda3 you must have Virtual Box and Vagrant Installed into your machine.
You can download from Vagrant Cloud:
https://app.vagrantup.com/mshannaq/boxes/dofda3
dofda3 box version 0.0.2 comes alive
version 0.0.2: (released 23-Apr-2019)
https://app.vagrantup.com/mshannaq/boxes/dofda3/versions/0.0.2
Take a look to ChangeLog to know what is the changes
This release is ready to use as A Development Environment for PHP Developers Includes Ubuntu 18.04.1, Apache 2.4.29 MySQL 5.7.25, Multi PHP Versions (PHP 5.6, PHP 7.0, PHP 7.1, PHP 7.2, PHP 7.3), phpMyAdmin 4.8.5, MailHog
USE THE BOX FOR INTERNAL USE ONLY!, It is not secure to use in public !!
Never use this box for production use , and never run it public online on the internet (Until you change the root password and the mysql password and secure the box)
You must forward ports 80 , 8025 to use the dofda3 box features.
You are advised to disable auto update check in Vagrantfile because this is a beta release and next releases may conatins big changes
You can find A sample of Vagrantfile that I have used on the following link https://ms.per.jo/downloads/dofda3box/Vagrantfile
after you initialize the box using vagrant init and vagrant upyou can login into the ssh server by vagrant ssh or by using root username from any other ssh client (for example Putty or Cmder)
If machine freez when going up in "default: SSH auth method: private key" double check from virtualbox that serial port is enabled and pointed to already exists file in your system.
after you run vagrant up you can ssh 192.168.33.10 with root username (don't forget to change the IP to the current used IP)
the ssh root username password is: toor
mysql root password is: toor
mysql server can be accessible outside localhost
to access phpmyadmin visit http://192.168.33.10/phpmyadmin (don't forget to change the IP to the current used IP)
Uploading PHP Project files to the server
Where to put your PHP projects?
Upload your PHP files into the folder /var/www/html/
You can use the following ssh username to upload files to /var/www/html
ssh username: dofda3
ssh password: ribbit
dofda3 user is Sudo User so you can use sudo command with dofda3 user
do not upload php files as A root (use user dofda3 instead) to keep files permissions in good stand and writable by Apache
This user can upload files using SFTP , SCP into the folder /var/www/html which is used as apache2 document root
You are advised to keep your php projects structured into /var/www/html , for example each project has its own folder. (eg project1 /var/www/html/project1 , project2 /var/www/html/project2 .. etc)
dofda3 support multiple PHP versions
The current release of dofda3 support PHP 5.6.40 , 7.0.33 , 7.1.26 , 7.2.15 , 7.3
You can change the current used PHP version which used by linux cli and apache2 on the fly from ssh command line by running dofda3 command with appropriate parameters
for example to change the running php version to PHP 5.6 ssh to the box and run the following command
sudo dofda3 --php=5.6
for more help run dofda3 -h
PHP 5.6 , 7.0 & 7.1 uses Ondřej Surý PPA ppa:ondrej/php repository
Tracking Email Messages
dofda3 using MailHog to track and analyze outgoing email instead of sending emails to real word, so when use php send mail feature it will passed to MailHog instead of sending it in real.
to track and view sent emails by php visit http://192.168.33.10:8025/ (don't forget to use your server IP)
Configuration files
Apache 2 config file can be found in /etc/apache2/apache2.conf and the definition of apache 2 document root can be found in /etc/apache2/sites-enabled/000-default.conf
php.ini file which handle php configuration while running from linux cli can be found in /etc/php/N.N/cli/php.ini after change N.N to the specific PHP Version (eg php 5.6 php.ini can be found at /etc/php/5.6/cli/php.ini and 7.1 php.ini can be found in /etc/php/7.1/cli/php.ini ... etc.
php.ini file which handle php configuration while running from apache2 can be found in /etc/php/N.N/apache2/php.ini after change N.N to the specific PHP Version (eg php 5.6 php.ini can be found at /etc/php/5.6/apache2/php.ini and 7.1 php.ini can be found in /etc/php/7.1/apache2/php.ini ... etc.
when restarting services like apache2 you may be asked for Authentication , so use "dofda3 user for webserver (dofda3)" to authenticate by choosing dofda3 and enter the user ssh password
dofda3 box initial release 0.0.1
version 0.0.1 :
https://app.vagrantup.com/mshannaq/boxes/dofda3/versions/0.0.1
This release is ready to use as A Development Environment for PHP Developers Includes Ubuntu 18.04.1, Apache 2.4.29 MySQL 5.7.25, Multi PHP Versions (PHP 5.6, PHP 7.0, PHP 7.1, PHP 7.2), phpMyAdmin 4.8.5, MailHog
USE THE BOX FOR INTERNAL USE ONLY!, It is not secure to use in public !!
Never use this box for production use , and never run it public online on the internet (Until you change the root password and the mysql password and secure the box)
You must forward ports 80 , 8025 to use the dofda3 box features.
You are advised to disable auto update check in Vagrantfile because this is a beta release and next releases may conatins big changes
You can find A sample of Vagrantfile that I have used on the following link https://ms.per.jo/downloads/dofda3box/Vagrantfile
after you initialize the box using vagrant init and vagrant upyou can login into the ssh server by vagrant ssh or by using root username from any other ssh client (for example Putty or Cmder)
If machine freez when going up in "default: SSH auth method: private key" double check from virtualbox that serial port is enabled and pointed to already exists file in your system.
after you run vagrant up you can ssh 192.168.33.10 with root username (don't forget to change the IP to the current used IP)
the ssh root username password is: toor
mysql root password is: toor
mysql server can be accessible outside localhost
to access phpmyadmin visit http://192.168.33.10/phpmyadmin (don't forget to change the IP to the current used IP)
Uploading PHP Project files to the server
Where to put your PHP projects?
Upload your PHP files into the folder /var/www/html/
You can use the following ssh username to upload files to /var/www/html
ssh username: dofda3
ssh password: ribbit
dofda3 user is Sudo User so you can use sudo command with dofda3 user
do not upload php files as A root (use user dofda3 instead) to keep files permissions in good stand and writable by Apache
This user can upload files using SFTP , SCP into the folder /var/www/html which is used as apache2 document root
You are advised to keep your php projects structured into /var/www/html , for example each project has its own folder. (eg project1 /var/www/html/project1 , project2 /var/www/html/project2 .. etc)
dofda3 support multiple PHP versions
The current release of dofda3 support PHP 5.6.40 , 7.0.33 , 7.1.26 , 7.2.15
You can change the current used PHP version which used by linux cli and apache2 on the fly from ssh command line by running dofda3 command with appropriate parameters
for example to change the running php version to PHP 5.6 ssh to the box and run the following command
sudo dofda3 --php=5.6
for more help run dofda3 -h
PHP 5.6 , 7.0 & 7.1 uses Ondřej Surý PPA ppa:ondrej/php repository
Tracking Email Messages
dofda3 using MailHog to track and analyze outgoing email instead of sending emails to real word, so when use php send mail feature it will passed to MailHog instead of sending it in real.
to track and view sent emails by php visit http://192.168.33.10:8025/ (don't forget to use your server IP)
Configuration files
Apache 2 config file can be found in /etc/apache2/apache2.conf and the definition of apache 2 document root can be found in /etc/apache2/sites-enabled/000-default.conf
php.ini file which handle php configuration while running from linux cli can be found in /etc/php/N.N/cli/php.ini after change N.N to the specific PHP Version (eg php 5.6 php.ini can be found at /etc/php/5.6/cli/php.ini and 7.1 php.ini can be found in /etc/php/7.1/cli/php.ini ... etc.
php.ini file which handle php configuration while running from apache2 can be found in /etc/php/N.N/apache2/php.ini after change N.N to the specific PHP Version (eg php 5.6 php.ini can be found at /etc/php/5.6/apache2/php.ini and 7.1 php.ini can be found in /etc/php/7.1/apache2/php.ini ... etc.
when restarting services like apache2 you may be asked for Authentication , so use "dofda3 user for webserver (dofda3)" to authenticate by choosing dofda3 and enter the user ssh password
Tools that can be used
ssh commands
createmysqldb : use this command to create a new mysql database.
Leave a comment