MINI2 link

README.md

@@ -39,10 +39,27 @@ SASS-compiling, Twig, Unit Tests, etc.
 - mod_rewrite activated (tutorials below, but there's also [TINY](https://github.com/panique/tiny), a mod_rewrite-less 
 version of MINI)
 
+## Installation (in Vagrant, 100% automatic)
+
+If you are using Vagrant for your development, then you can install MINI with one click (or one command on the
+command line) [[Vagrant doc](https://docs.vagrantup.com/v2/getting-started/provisioning.html)]. MINI comes with a demo 
+Vagrant-file (defines your Vagrant box) and a demo bootstrap.sh which automatically installs Apache, PHP, MySQL, 
+PHPMyAdmin, git and Composer, sets a chosen password in MySQL and PHPMyadmin and even inside the application code, 
+downloads the Composer-dependencies, activates mod_rewrite and edits the Apache settings, downloads the code from GitHub
+and runs the demo SQL statements (for demo data). This is 100% automatic, you'll end up after +/- 5 minutes with a fully 
+running installation of MINI2 inside an Ubuntu 14.04 LTS Vagrant box.
+
+To do so, put `Vagrantfile` and `bootstrap.sh` from `_vagrant` inside a folder (and nothing else). 
+Do `vagrant box add ubuntu/trusty64` to add Ubuntu 14.04 LTS ("Trusty Thar") 64bit to Vagrant (unless you already have 
+it), then do `vagrant up` to run the box. When installation is finished you can directly use the fully installed demo 
+app on `192.168.33.44`. As this just a quick demo environment the MySQL root password and the PHPMyAdmin root password 
+are set to `12345678`, the project is installed in `/var/www/html/myproject`. You can change this for sure inside
+`bootstrap.sh`.
+
 ## Installation
 
 1. Edit the database credentials in `application/config/config.php`
-2. Execute the .sql statements in the `_installation/`-folder (with PHPMyAdmin for example).
+2. Execute the .sql statements in the `_install/`-folder (with PHPMyAdmin for example).
 3. Make sure you have mod_rewrite activated on your server / in your environment. Some guidelines:
    [Ubuntu 14.04 LTS](http://www.dev-metal.com/enable-mod_rewrite-ubuntu-14-04-lts/),
    [Ubuntu 12.04 LTS](http://www.dev-metal.com/enable-mod_rewrite-ubuntu-12-04-lts/),
@@ -64,11 +81,11 @@ A very early documentation can be found on [php-mini.com/documentation](http://p
 
 ### nginx
 
-TODO
+TODO (please commit if you have a perfect config)
 
 ### IIS
 
-TODO
+TODO (please commit if you have a perfect config)
 
 ## Security
 
@@ -223,6 +240,8 @@ Please commit into the develop branch (which holds the in-development version),
 ## Changelog
 
 **November 2014**
+- [panique] auto-install script for Vagrant
+- [panique] basic documentation
 - [panique] PDO-debugger is now a static helper-method, not a global function anymore
 - [panique] folder renaming
 - [reg4in] JS AJAX calls runs now properly even when using script in sub-folder

_vagrant/Vagrantfile

@@ -0,0 +1,22 @@
+# -*- mode: ruby -*-
+# vi: set ft=ruby :
+
+# Vagrantfile API/syntax version. Don't touch unless you know what you're doing!
+VAGRANTFILE_API_VERSION = "2"
+
+Vagrant.configure(VAGRANTFILE_API_VERSION) do |config|
+
+  # Every Vagrant virtual environment requires a box to build off of.
+  config.vm.box = "ubuntu/trusty64"
+
+  # Create a private network, which allows host-only access to the machine using a specific IP.
+  config.vm.network "private_network", ip: "192.168.33.44"
+
+  # Share an additional folder to the guest VM. The first argument is the path on the host to the actual folder.
+  # The second argument is the path on the guest to mount the folder.
+  config.vm.synced_folder "./", "/var/www/html"
+
+  # Define the bootstrap file: A (shell) script that runs after first setup of your box (= provisioning)
+  config.vm.provision :shell, path: "bootstrap.sh"
+
+end

_vagrant/bootstrap.sh

@@ -0,0 +1,73 @@
+#!/usr/bin/env bash
+
+# Use single quotes instead of double quotes to make it work with special-character passwords
+PASSWORD='12345678'
+PROJECTFOLDER='myproject'
+
+# create project folder
+sudo mkdir "/var/www/html/${PROJECTFOLDER}"
+
+sudo apt-get update
+sudo apt-get -y upgrade
+
+sudo apt-get install -y apache2
+sudo apt-get install -y php5
+
+sudo debconf-set-selections <<< "mysql-server mysql-server/root_password password $PASSWORD"
+sudo debconf-set-selections <<< "mysql-server mysql-server/root_password_again password $PASSWORD"
+sudo apt-get -y install mysql-server
+sudo apt-get install php5-mysql
+
+sudo debconf-set-selections <<< "phpmyadmin phpmyadmin/dbconfig-install boolean true"
+sudo debconf-set-selections <<< "phpmyadmin phpmyadmin/app-password-confirm password $PASSWORD"
+sudo debconf-set-selections <<< "phpmyadmin phpmyadmin/mysql/admin-pass password $PASSWORD"
+sudo debconf-set-selections <<< "phpmyadmin phpmyadmin/mysql/app-pass password $PASSWORD"
+sudo debconf-set-selections <<< "phpmyadmin phpmyadmin/reconfigure-webserver multiselect apache2"
+sudo apt-get -y install phpmyadmin
+
+# setup hosts file
+VHOST=$(cat <<EOF
+<VirtualHost *:80>
+    DocumentRoot "/var/www/html/${PROJECTFOLDER}/public"
+    <Directory "/var/www/html/${PROJECTFOLDER}/public">
+        AllowOverride All
+        Require all granted
+    </Directory>
+</VirtualHost>
+EOF
+)
+echo "${VHOST}" > /etc/apache2/sites-available/000-default.conf
+
+# enable mod_rewrite
+sudo a2enmod rewrite
+
+# restart apache
+service apache2 restart
+
+# remove default apache index.html
+sudo rm "/var/www/html/index.html"
+
+# install git
+sudo apt-get -y install git
+
+# git clone MINI
+sudo git clone https://github.com/panique/mini "/var/www/html/${PROJECTFOLDER}"
+
+# install Composer (not necessary by default)
+#curl -s https://getcomposer.org/installer | php
+#mv composer.phar /usr/local/bin/composer
+
+# go to project folder, load Composer packages (not necessary by default)
+#cd "/var/www/html/${PROJECTFOLDER}"
+#composer install --dev
+
+# run SQL statements from MINI folder
+sudo mysql -h "localhost" -u "root" "-p${PASSWORD}" < "/var/www/html/${PROJECTFOLDER}/_install/01-create-database.sql"
+sudo mysql -h "localhost" -u "root" "-p${PASSWORD}" < "/var/www/html/${PROJECTFOLDER}/_install/02-create-table-song.sql"
+sudo mysql -h "localhost" -u "root" "-p${PASSWORD}" < "/var/www/html/${PROJECTFOLDER}/_install/03-insert-demo-data-into-table-song.sql"
+
+# put the password into the application's config. This is quite hardcore, but why not :)
+sed -i "s/your_password/${PASSWORD}/" "/var/www/html/${PROJECTFOLDER}/application/config.php"
+
+# final feedback
+echo "Voila!"

application/config/config.php

@@ -50,4 +50,4 @@
 define('DB_HOST', '127.0.0.1');
 define('DB_NAME', 'mini');
 define('DB_USER', 'root');
-define('DB_PASS', '');
+define('DB_PASS', 'your_password');