Aspen:Installation

From Aspen Documentation

Contents

Minimum Requirements

  • PHP 5.1+
  • MySQL 4.1+

Installing

  1. Upload the code to your server.
  2. Setup an empty database. You will need the database name and user account information during the installation.
  3. Once the files are uploaded and an empty database is ready, visit the URL that points to your framework code. You will automatically be routed to the first step in the installation process.

If Aspen detects that your system does not meet the minimum requirements, a page will be displayed with important information about what requirement does not appear to have been met.


Step One: Database Connection

The first step is to configure access to your database. Aspen will ask you for the hostname, database name, username, and password so that it may connect to your database.

Hostname may often be left as 'localhost'. If it's different, your webhost will provide that information. The rest of the information will be specific to your database.

Once entered, click next and the framework will attempt a to write a config file to your server.


Config File

If the web server does not have the permissions necessary to write the configuration file automatically it will display the generated file contents in a text box.

Select and copy the contents of the text box into a new plain text file called 'config.php'. Save the pasted content and upload to your server. A sample configuration file called 'config.sample.php' is included with the source code that you may also use as an example.

Once the file has been saved and uploaded, click next to continue.


Step Two: Creating A User Account

If the database connection was verified you will be asked to create a default user account. If the database connection failed, you will be returned to step one to correct the information.

Enter your email address to be used as your username and choose a password. Enter your password twice to confirm it and click next.

Your account will be automatically created and you will see a confirmation of a successful installation.

Note: Accounts are not required, but are enabled by default. You may remove the configuration parameter enabling accounts after installation.

You may now begin using and developing with the Aspen framework.

Next: Choosing Your Setup