First, read the requirements ...
... then pick a download method:
Solar is written to E_STRICT standards for PHP 5, and will not work under PHP 4. PHP version 5.2 or later is preferred.
Solar is completely self-contained and has no external dependencies. When you install Solar, you get all of the components together, not separate packages. This helps to avoid "dependency hell" when upgrading.
Solar supports the following database backends; while not required, you will probably want one of them installed:
MySQL 4.1 or later
PostgreSQL 7.3 or later
SQLite 3 or later
Oracle 10g or later
(Microsoft SQL support is forthcoming.)
We provide a quick-start "system" for you to download and start your project with. This is a full Solar project setup with the latest core release already in place (1.1.2 as of 2010-11-09).
Download it to your document root from here: https://solarphp-system.googlecode.com/svn/download/solar-system-1.1.2.tgz
Go to your document root and extract it:
$ cd /var/www/html $ tar -zxvf solar-system-1.1.2.tgz
sqlite/directrories writable by the web server process, e.g.:
$ chmod -R 777 solar/tmp solar/sqlite
Now you can browse to
/solar on your server for "Hello World!". For more information, and a blog demo, see the manual.
The quick-start system is likely to work only on Unix-like systems and Windows 6 or later, since it makes extensive use of symbolic links.
$ svn checkout http://solarphp.googlecode.com/svn/trunk solar/core $ svn checkout http://solarphp-system.googlecode.com/svn/trunk/ solar/system
Direct Core Download
You can download the most-recent Solar core release tarball directly from this link:
Un-compress the tarball, then copy the resulting files into your Solar-system
source/solar directory (or into your include-path).
Install Core Using PEAR
First, let PEAR discover the channel server...
$ pear channel-discover solarphp.com Adding Channel "solarphp.com" succeeded Discovery of channel "solarphp.com" succeeded
... then you can install or upgrade:
$ pear install Solar/Solar ... installation messages follow ... $ pear upgrade Solar/Solar ... upgrade messages follow ...
Alternatively, you can use PEAR to install or upgrade a specific release directly from a tarball, like this:
$ pear install http://solarphp.com/get/Solar-1.1.2.tgz ... installation messages follow ... $ pear upgrade http://solarphp.com/get/Solar-1.1.2.tgz ... upgrade messages follow ...
Where Are The Files Placed?
After installation, you will find the classes in
/path/to/pear/, while documentation will be in
/path/to/pear/docs/Solar/, and test files in
It's Not Working!
If you have problems with the channel not delivering the most-recent release, clear your local PEAR cache and try again:
$ pear clear-cache reading directory cache entries cleared $ pear upgrade Solar/Solar ... upgrade messages follow ...
If you continue to have trouble, please email firstname.lastname@example.org.