Development with IIS on Windows

It is possible to run Rogo on Windows using IIS

Prerequisites

  1. You must have the World Wide Web Services and Web Management Tools enabled via Windows features

  2. It is recommended you have the Microsoft Web Platform Installer

  3. Install PHP manager

  4. Install MySQL

  5. Have a local Rogo git repository with the develop branch checked out

Using the Web platform installer install the following:

  1. PHP (Any versions you wish you wish to test Rogo with)

Setup web server

  1. Open the Internet Information Services (IIS) Manager tool

  2. Right click on the Default Web Site and select Add Virtual Directory

  3. Enter an alias (for example rogo) and set the physical path to be the directory your local Rogo repository

  4. In the Default Web Site click on the Bindings… action and add a http port on 8001 (you can then use that port to run behat tests)

  5. Select the rogo directory that will not be showing up and open the PHP Manager

  6. Ensure that the version of PHP you need for Rogo is selected

  7. Configure error reporting to be Development machine

  8. Ensure that the extensions that Rogo requires are enabled

XDebug

Download and install xdebug for the version of PHP you are using.

Manually edit your php.ini file to add the configuration for xdebug

1 2 3 4 5 6 [XDEBUG] zend_extension=php_xdebug-your.version.details.dll xdebug.remote_enable=on xdebug.xdebug.remote_port=9000 xdebug.remote_host=localhost xdebug.remote_autostart=off

Node package manager (npm)

It is recommended to use a manager for npm such as nvm for Windows after you have installed it run the following set of commands:

1 2 nvm install 6.14.15 nvm use 6.14.15

You should replace the version numbers above with what ever the most current supported version of npm is for Rogo

Composer

Download the latest version of composer into the root directory of Rogo.

Install Rogo

Before you can install Rogo you will need to run several things to ensure all the dependencies are downloaded.

1 2 3 4 5 npm install php composer.phar install grunt cd plugins/texteditor/plugin_tinymce_texteditor npm install

The following can be used to create a batch script to do it (you will want to run this every time you pull new updates into Rogo)

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 @echo off echo Setting up development environment... echo Rogo NPM: call npm install echo Rogo composer: call php composer.phar install echo Tiny MCE: cd plugins/texteditor/plugin_tinymce_texteditor call npm install cd ../../.. echo Grunt: call grunt echo Rogo development setup complete.

You will now be able to follow the normal Rogo installation procedure (assuming you used the suggested virtual directory) by going to http://localhost/rogo/install, or you can use the command line installer

You will now probably want to setup both your unit testing and behat test suites.