wave-framework/scaffolding-app

An example application using the Wave Framework

Wave Scaffolding App

An example application to get started with the Wave framework., _(*1)

To get started first install Composer

$ curl -s http://getcomposer.org/installer | php

Then create a new wave-framework/scaffolding-app project

The simplest thing to do is just clone the master branch, (dev-master), e.g., _(*2)

$ composer.phar create-project wave-framework/scaffolding-app ./test dev-master

Then you can run a few of the setup scripts, but at the very minimum you need to generate the routes cache, _(*3)

$ cd test
$ ./vendor/bin/wave generate/routes
Regenerating Routes...  done
$

You can also have a script populate the default database configuration by running, _(*4)

$ ./vendor/bin/wave install

Manually regenerating views can be done with, _(*5)

$ ./vendor/bin/wave generate/views

In development mode views are automatically regenerated when they change., _(*6)

Apache configuration

Wave requires Apache mod_rewrite (or an equivilent that can transform each request into public/index.php)., _(*7)

A typical VirtualHost configuration might look something like this:, _(*8)

<VirtualHost *:80>
  ServerName wave-app.localhost

  DocumentRoot /var/www/wave-app/public
  <Directory /var/www/wave-app/public>
     # Rewrite directives are set in public/.htaccess. Move
     # them here if you prefer to leave AllowOverride None
     AllowOverride all
  </Directory>
  # Consolidate log files into the same directory the app logs
  # go into.
  ErrorLog /var/www/wave-app/logs/web_error.log
  CustomLog /var/www/wave-app/logs/web_access.log common
</VirtualHost>

Once you have configured your Apache environment you should be able to browse to the application in your browser and be met with a welcome page (and an obligatory gold star)., _(*9)