httpd-node v0.1.8

httpd-node

A super simple HTTPD server for node.js

Overview

httpd-node is a simple HTTPD that includes support for ssl and multiple subdomains.

Installation

npm install httpd-node

Usage

Standalone

npm start

The standalone config can be found in standalone.js.

Requiring

var httpd = require( 'httpd-node' );

Setting Up the Environment

httpd.environ( 'root' , '/path/to/your/public/directory' );

Creating an Instance

An options object can be passed to the httpd constructor:

var server = new httpd( options );

Examples

First, require httpd and setup your environment:

var httpd = require( 'httpd-node' );
httpd.environ( 'root' , '/path/to/your/public/directory' );

Basic

Assuming your public directory contains a www directory, all you need to get started is:

var server = new httpd();
server.start();

Subdomains

Point yourdomain.com and rad.yourdomain.com to different directories:

var server = new httpd();

server.setHttpDir( 'default' , '/cool' );
server.setHttpDir( 'rad' , '/rad' );

server.start();

SSL

HTTPS on port 8080:

var server = new httpd({
    port: 8080,
    ssl: {
        key: '/absolute/path/to/ssl/key.key',
        cert: '/absolute/path/to/ssl/cert.crt'
    }
});

server.start();

Methods

server.setHttpDir

• Adds a new http directory and subdomain. The default directory is /www.

server.setHttpDir( 'www' , '/www' );
server.setHttpDir( 'cdn' , '/cdn' );

// to override the default
server.setHttpDir( 'default' , '/some_other_path' );

server.use

• Adds a callback that will be executed before the response is sent.
• data is an object containing subdomain, httpRoot, and request path.

server.use(function( request , response , data ) {
    // do stuff here
});

server.environ

• Same as httpd.environ, but sets the environment for the server instance rather than the default httpd environment.

server.environ( 'root' , '/path/to/your/public/directory' );

server.start

• Starts the httpd instance.

server.start();