README

Drivin that train...

Conductor is a webapp framework for PHP+Javascript providing specific support for single page Javascript heavy applications.

Prerequisites:

composer
node,npm
bower
grunt

Install

Add as a Composer dependency. (in composer.json)

{
    "require": {
        "zeptech/conductor": "dev-master"
    }
}

Run Composer install: composer install
Run Conductor initialization script: ./vendor/bin/cdt-init

If you get errors about not being able to change groups run the following command: sudo chgrp -R www-data target

*Install bower dependencies:

$ cd vendor/zeptech/conductor
$ bower install

*Run Grunt build:

$ cd vendor/zeptech/conductor
$ npm install
$ grunt

* These steps will be eliminated either through a composer install/update hook or in the cdt-init script.

Configuration

Wherever possible, Conductor will provide/adopt a convention in order to keep configuration to a minimum. However there is still a small amount of configuration necessary to use Conductor to power your site.

Conductor configuration is defined in a YAML file conductor.yml in the root directory of your site.

Here is a sample configuration file with comments explaining each configuration value:

# You can override the values of any block for different environments using
# an env block.

# This is display name for you site.
# It will appear as a prefix to each HTML page's <title> tag
title: My Awesome Site

# This is the root namespace where all of your sites PHP files are found.
namespace: mysite
 
# Database configuration.  All settings are required.
db:
  # Currently only MySQL is supported.  There are plans to also
  # support PostgreSQL and SQLite
  driver: mysql
  host: localhost
  username: mysite_d
  password: 123abc
  schema: mysite_d

  # When deploying your site to either staging, or production, the
  # values in the following blocks will be used.
  env:
    stage:
      schema: mysite_s
      username: mysite_s
      password: abc123
    prod:
      schema: mysite
      username: mysite
      password: !123@abc#

# This is web path from your server's domain to the root of your site.
# This value is optional and defaults to /
webRoot: /

# You can put an env block at any level
env:
  dev:
    webRoot: /mysite

zeptech / conductor

Maintainers

Details

README

Prerequisites:

Install

Configuration