Introduction

This is the quickstart guide for the Ubar PHP MVC Framework. More information can be found at the following locations:

Resources

• Project Details
• Docs
• Wiki
• Source
• Issues
• Downloads
• Dev Group

Before You Start

First, you will need to download a copy of the framework. If you have not already done so, you can download one from the Downloads page (above) or checkout and build your own distribution using the SVN location listed on the Source page (above).

Requirements:

• PHP 5.1 or greater. 5.3 is recommended but not required at this time.
• Apache 2.2 or other web server.

Suggestions:

• Mysql 5.0 or greater if you wish to use build in database tools.
• PHPUnit 3.4 if you intend to use framework tools for unit testing.
• Eclipse with phpeclipse is an ideal development environment.

1. Set up the following folder structure, items marked with '*' are optional:

[web] (or [html] as is common in some hosting facilities)
	[css]*
	[images]*
	[js]*
	[static]*
	index.php (from the ubar [install] directory)
	.htdocs (from the ubar [install] directory)
[WEB-INF]
	[controller]
	[lib]
		[ubar]
			...
	[model]
	[properties]
	[sql]*
	[test]*
	[view]

2. Configure your web server to use the web directory as the document root.
3. Place the downloaded ubar directory where depicted in step 1.
4. Move the files in ubar's install directory to the web directory as depicted in step 1.
5. Edit ubar_config.properties to override default values as necessary. Note that this is also where you add database configuration if you would like to use the built in database utilities.
6. Verify the setup by following the "Hello World" guide. Alternatively you may use the wiki pages or the sample application included in the release to start development.

• Hello World Guide
• Wiki