===== Akelos on Windows quickstart =====





==== XAMPP installation ====

Get [[http://www.apachefriends.org/en/xampp.html|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 [[http://akelos.org/download|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!