After downloading the zip file you need to uncompress asp2php. You can do this with any version of pkzip or winzip or whatever. You should have an asp2php directory now with asp2php.exe in it. You can download pkzip from

Using asp2php on Windows is the same as Unix. You need to open a DOS prompt box. Then you need to set your PATH to point to the directory asp2php is installed in or else when you use asp2php you must use full paths. For example:

C:\apache\htdocs> asp2php -o phpdir -dir aspdir

C:\apache\htdocs> c:\temp\asp2php\asp2php asppages -o phpdir -dir

To set your path correctly (assuming asp2php is installed in c:\temp\asp2php) you can type:

set path=c:\temp\asp2php

If this is too much work you can download a graphical interface to asp2php by Jonas Lindau at

Requirements

There are no requirements for asp2php. You do not need a web server installed on your system to run this program. This is a stand-alone program that converts text files written in asp/vbscript (soon jscript) into text files written in PHP.

Uncompressing and Compiling

First untar the archive with:

tar xvzf asp2php.tgz

Next type:

make (to compile asp2php)
make install (this will install asp2php in /usr/local/bin/ if you want. This is not required)
make gui (optional if you want the gui)

The Command Line

Usage: asp2php <-options>
-o

-dir (input and output files are directories so copy recursively)
-mysql -odbc -oracle -sybase -postgres (to select database)
-uid
-passwd
-database
-address
-dsn
-pngs (for converting links to gifs into png)
-y2k (if your asp came from non-y2k compliant NT Box)
-php3 or -php4 (change extension to .php3 or php4 instead of .php)
-toupper (change all variables to uppercase)
-tolower (change all variables to lowercase)
-html (change links to .htm files to .html)
-includes (change #includes to php requires())
-addextension .xxx (filenames with .xxx extension get asp2php translated)
-spacer (Space out php code differently)
-gif2png (use gif2png instead of ImageMagick [-pngs mode only])
-nomagick (don't convert gif files to png [-pngs mode only])
-global_asa (include global.php in all pages)
-fixwinpaths (fix windows paths [ '\' becomes '/' ])

Basically you can just type:

asp2php myaspfile.asp

asp2php will create a php file called: myaspfile.php

Asp2php will use default options to convert your pages. If you have database connections in your asp, asp2php will automatically try and figure out what to use for username, password, etc. for the PHP app. If you'd like to override these you can do so with command line options. Other command line options let you tell asp2php which type of database you'll be using on the PHP side, what the output file should be, or if asp2php should convert links to gifs to php.

The -pngs mode allows asp2php to convert image tags to point to pngs instead of gifs (this is due to the fact that web pages that use GIF's must pay a big unnamed company $5,000 for licensing). For example:

<img src="mike.gif"> will get converted to:
<img src="mike.png"> in the new php code.

Explaination of command line options

The GUI

To build the GUI simply type:

make gui

To run the GUI just type: ./gtkasp2php

I'll have more docs on how to use it later. I don't have time to write documentation right now. Hopefully it's simple enough so you don't need docs tho.