Table of Contents

Akelos on Windows quickstart

XAMPP installation

Get XAMPP, it's an easy to use package including everything needed to run Akelos and the Booklink tutorial (apache, mysql, php, phpmyadmin)

install xampp at the root of a disk, ie:

  c:\xampp

There's a bug in xampp (as of ver. 1.6.3) that prevents php from being used from the commandline. Change the file c:\xampp\php\php.ini, editing the following line:

  extension=php_svn.dll

to make it look like

  ;extension=php_svn.dll

now start XAMPP by double-clicking

  c:\xampp\xampp_start.exe

Note: You can switch from PHP4 to PHP5 or vice versa executing

  C:\xampp\php-switch.bat

Install mod rewrite??? Somebody else confirm this and clean it up…. But it has caused a lot of trouble. You will also need to uncomment this line ”#LoadModule rewrite_module modules/mod_rewrite.so” in the file xampp\apache\conf\httpd.conf for the url rewrites to work.

Get Akelos

Get Akelos and uncompress it, say in the following directory:

  c:\dev\akelos

Now open a Command Prompt ('accessories' menu), and go to that directory

  cd c:\dev\akelos

Creating a new application

We will create the Booklink application in the webserver document root:

  c:\xampp\php\php.exe script/setup -d c:\xampp\htdocs\booklink

This will create the following structure for the booklink application:

  booklink/
      app/ << The application including controllers, views, models and installers
      config/ << Boring configuration files (will do the config via web)
      public/ << This is the only folder made public under /www/htdocs/booklink softlink
      script/ << Utils for code generation and running tests    

Creating the database

First you need to create your database by using the phpMyAdmin web interface at:

  http://localhost/phpmyadmin

You will need these databases

  booklink
  booklink_dev
  booklink_tests

Generating the configuration file

You can now point your browser to

  http://localhost/booklink/public

Follow the steps in the wizard to set up your database, locales and file permissions and generate a configuration file.

Note: on XAMPP, the default database username is 'root' and the password is empty

On your command line, change your directory to go into your application

  cd c:\xampp\htdocs\booklink

You can now continue the regular Booklink tutorial, starting at the “The booklink database structure” section. Remember that whenever the instruction states that you should do something like this:

  ./script/generate scaffold Book

you will have to type it that way

  c:\xampp\php\php.exe script/generate scaffold Book.

Note

If you add PHP to your path, you will be able to type commands like:

  php script/generate scaffold book

Heres how to do it: Right click on `My Computer`, go to the `Advanced` tab and then click the button `Environnment Variables`. In the `System variables` section, select `path` and click `edit`. At the end of the line, add

  ;C:\xampp\php

Open a new Command Prompt and voila!