Introduction and Getting Started
Creating a usable development environment can be half the battle, especially if you are not familiar with configuring packages like Apache and MySQL. This tutorial, while aimed at Linux desktops running Fedora / RedHat / CentOS, offers a set of instructions on how to get up and running with Scorpio. There are additional notes for Windows users at the end of the article and a set of notes for Debian users highlighting some of the differences between Debian and Redhat based distributions.
Please note: this is NOT a guide for configuring a production server and so ignores critical issues such as security and permissions etc. The basic assumption is that you are running a desktop and want to be able to try out or build using Scorpio.
If you have access to a virtual machine, it is strongly recommended to try out in one of these first as they are essentially disposable and it will avoid any potential stability issues. I recommend VMWare Workstation or VMWare Player and an appropriate appliance.
You will need the following available before starting with this tutorial:
- Either a VM Image or a desktop computer running:
- Fedora 7+ or Redhat Enterprise 5+ or CentOS 5+
- Root access or correctly configured sudo
- A configured and working internet connection
- Not essential, but useful: a Linux desktop (Gnome or KDE or whatever you like)
- Confidence using the command line
Finally for development work either a text editor (vi, emacs, nano etc) or a GUI application or IDE. My preferred application is Zend Studio (currently at version 6.1 which is built on Eclipse). This is a commercial application for Windows, Linux and MacOSX. Alternatives include Eclipse with the PDT tools installed or NetBeans 6.5 PHP Edition. Which ever you use, you should be comfortable using it.
This guide uses absolute paths to remove any ambiguity when issuing commands; the exception is when importing SQL files into MySQL.
Finally; the guide assumes that Apache etc are not installed and will need to be installed. If you prefer to compile from source with custom paths and configs, then this guide is probably not for you.
With that said, lets begin...
- Introduction and Getting Started
- Installing Apache, MySQL and PHP
- Creating a user and getting the framework
- Configuring Apache
- Configuring MySQL
- Creating the base Scorpio config file
- Accessing the website
- Adding a pre-built component
- Setting up the article sites
- Variations in setting up a system
- Setting up on Windows
- Tutorial 1: Building a simple guest book
- Tutorial 2: Pulling additional view information
- Tutorial 3: Adding Ajax controls to a controller
This work is licenced under a Creative Commons Licence.