Nephtali

A simple, security-focused web framework

Install guide Apache servers running PHP 5

  1. Download the framework

    Download the latest stable release from the Nephtali website. Unzip the archive and read the Nephtali license information.

  2. Upload the Nephtali directory

    Upload the Nephtali directory to your website. For security reasons, the Nephtali directory should be one level above the public directory of your website (typically labeled 'public_html'.)

  3. Edit the configuration files for your server

    Nephtali works by prepending and appending Nephali scripts to each PHP page request (and making sure some other settings are secure.)

    Follow the instructions below for the configuration of the server you're on:

    • Standard install

      1. Copy the contents of the doc/standard_install directory to your public web directory (often, public_html.)
      2. View the file http://yourwebsite.com/setup.php to easily retrieve your include path, view a suggested include path, and learn if there are any known configuration issues.
      3. Open the file htaccess and add the path to the Nephatli 'src' directory to the PHP include path

        For example, a typical path to the directory would be:
        /home/username/nephtali_x_x_x/src
      4. Rename the file htaccess so it has the preceding '.', making htaccess an extension rather than a name.
    • suPHP install

      1. Copy the contents of the doc/standard_install directory to your public web directory (often, public_html.)
      2. View the file http://yourwebsite.com/setup.php to easily retrieve your include path, view a suggested include path, and learn if there are any known configuration issues.
      3. Open the file htaccess and add the path to your public web directory to your suPHP configuration path.
      4. Rename the file htaccess so it has the preceding '.', making htaccess an extension rather than a name.
      5. Open the file php.ini and add the path to the Nephatli 'src' directory to the PHP include path.

        For example, a typical path to the directory woudl be:
        /home/username/nephtali_x_x_x/src
  4. Upload the file(s)

    Upload the test.php and the configuration files you edited to the public directory of your website, then view http://yourwebsite.com/test.php to confirm that everything is working correctly.

    Congratulations on installing Nephtali :)

What about upgrading?

Upgrading to new versions of Nephtali is easy, too. New versions of Nephtali only involve edits to files within the NCore directory.

You could upgrade by just replacing the NCore directory of your current version with the NCore directory of your new version, but it's best to keep a working version of your previous setup.

To upgrade, merely:

  1. Make a copy of the Nephtali directory currently on your web server, and label it 'nephtali_x_x_x' (matching the version number of the new version of Nephtali you're grabbing.)
  2. Download the new version of Nephtali.
  3. Replace the old NCore directory with the NCore directory found in the new version.
  4. Edit the configuration files of your server (item 3 of the install guide) to point to the new Nephtali directory.

Copyright © 2007, Adam J. Richardson, unless otherwise noted.

The Nephtali web framework is released under the MIT License.