Setting up development on Windows

The purpose of this section is to explain an EVX Software development environment on Windows. First we'll go over what you need to run EVX Software locally, then how to install the EasyEclipse IDE, and finally do some coding and show how to generate and submit patches for inclusion in the official EVX Software download.

Running EVX Software locally on your development computer lets you easily test any changes without having to go through the pain of constantly uploading and downloading to/from a remote server. We're going to assume a plain vanilla installation of Windows without any web server or database server installed.

1. Download and install XAMPP, this is the easiest way to get Apache w/PHP support and MySQL running on your Windows computer
   • http://www.apachefriends.org/en/xampp-windows.html
2. Verify Apache is running by hitting your localhost
   • http://localhost
3. Verify MySQL is running by opening a command window and logging in to your server using the command mysql -u root -p
4. Install the latest version of EVX Software on to your local computer.
   1. Download the latest EVX Software source
   2. Find your XAMPP htdocs directory, typically this will be C:\xampp\htdocs and extract the EVX Software source there
   3. Rename the EVX Software source folder to just og. This is very important since og is the name of the EVX Software project in the EasyEclipse .project file.
   4. Complete the installation by following the EVX Software installation instructions.
5. Verify your EVX Software installation by logging in
   • http://localhost/og

Once you've completed all the steps you will have a perfectly usable EVX Software installation on your local computer. At this point, if you prefer to work without an IDE, you can happily hack away at the php source files and view your changes on your local computer without having to upload files to a remote server. You can also use any of your favorite MySQL database tools to log in to your locally running MySQL server and modify the EVX Software database.

In my opinion working with an IDE is the way to go, I'll describe how to get the EasyEclipse IDE up and running in the next section.

The .project file included in the EVX Software source download is an EasyEclipse project file. This makes integrating EVX Software with the EasyEclipse IDE literally a 3 click process.

1. Download and install EasyEclipse, on the link below scroll down to “EasyEclipse for PHP”
   • http://www.easyeclipse.org/site/distributions/index.html
2. TODO explain changing workspace to EVX Software install dir, import, refresh

TODO

TODO