Download Solar

  1. First, read the requirements ...

  2. ... 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.)

Quick Start

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).

  1. Download it to your document root from here:

  2. Go to your document root and extract it:

    $ cd /var/www/html
    $ tar -zxvf solar-system-1.1.2.tgz
  3. Make the tmp/ and 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.

Subversion Repositories

You can browse the Subversion repositories for the core and system, and do anonymous checkouts:

$ svn checkout solar/core
$ svn checkout 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

You can use our channel server to install or upgrade to any version, typically the most-recent version. You need to have PEAR already installed for this.

First, let PEAR discover the channel server...

$ pear channel-discover
Adding Channel "" succeeded
Discovery of channel "" 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
... installation messages follow ...

$ pear upgrade
... 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 /path/to/pear/tests/Solar/.

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