Download Solar

  1. First, read the requirements ...

  2. ... then pick a download method:

Requirements

  • Please note that Solar is in alpha stage and is not yet stable.

  • Solar is written to E_STRICT standards for PHP5, and will not work under PHP4.

  • Solar is completely self-contained and has no external dependencies. When you install Solar, you 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

  • (Microsoft SQL and Oracle support are forthcoming.)

Quick Start

We now provide a quick-start "sandbox" for you to download and work with. This is a full Solar system setup based on the current trunk of development.

You can use Subversion to export it directly from the server into your document root ...

bash-2.05$ cd /var/www/html
bash-2.05$ svn export http://svn.solarphp.com/system/trunk solar

... and then browse to /solar on your server.

Alternatively, you can do a checkout instead of an export, and you'll be able to keep up with the Solar trunk of development (via svn externals) using svn update.

bash-2.05$ cd /var/www/html
bash-2.05$ svn checkout http://svn.solarphp.com/system/trunk solar

The quick-start system is likely to work only on Unix-like systems, since is makes extensive use of symbolic links (unsupported by Windows).

Subversion Repository

You can browse the Subversion repository and do anonymous checkouts:

bash-2.05$ svn checkout http://svn.solarphp.com/core/trunk/ solar

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

bash-2.05$ pear channel-discover solarphp.com
Adding Channel "solarphp.com" succeeded
Discovery of channel "solarphp.com" succeeded
bash-2.05$

... then you can install or upgrade:

bash-2.05$ pear install Solar/Solar-alpha
... installation messages follow ...

bash-2.05$ pear upgrade Solar/Solar-alpha
... upgrade messages follow ...

Because Solar is alpha, you need to specify the "-alpha" flag when installing or upgrading.

Alternatively, you can use PEAR to install or upgrade a specific release directly from a tarball, like this:

bash-2.05$ pear install http://solarphp.com/get/Solar-1.0.0alpha1.tgz
... installation messages follow ...

bash-2.05$ pear upgrade http://solarphp.com/get/Solar-1.0.0alpha1.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 /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:

bash-2.05$ pear clear-cache
reading directory
cache entries cleared

bash-2.05$ pear upgrade Solar/Solar-alpha
... upgrade messages follow ...

If you continue to have trouble, please email pmjones@solarphp.com.

Direct Download

You can download the most-recent Solar tarball directly from this link:

http://solarphp.com/get/Solar-1.0.0alpha1.tgz

Un-compress the tarball, then copy the Solar.php file and Solar/ directory into your include_path.