Skip to content

Latest commit

History

History
108 lines (64 loc) 路 3.36 KB

README.md

File metadata and controls

108 lines (64 loc) 路 3.36 KB

Isosceles: Starter kit for PHP5 webapps Build Status

Isosceles is an object-oriented, PHP5 web application starter kit based on ThinkUp's underpinnings. Isosceles provides a simple MVC framework, database agnosticism, caching, dynamic class loading, single-file configuration, URL routing and (eventually) common actions like user registration, login, and logging.

Isosceles' name refers to the architecture of New York City's One World Trade Center.

Features

Isosceles is the PHP framework that runs ThinkUp, extracted and abstracted for reuse. It is nowhere near done. Its current feature set includes:

Isosceles is in beta and incomplete. In future releases it will get more features which demonstrate its use, like user registration, login, application settings, and logging.

License

Isosceles' source code is licensed under the GNU General Public License, except for the external libraries listed below.

External libraries

The following libraries are included in Isosceles:

Develop Locally via Vagrant Virtual Machine

Requirements

Install

Clone the repository:

$ git clone git@github.com:ginatrapani/isosceles.git

Get required submodules:

$ cd isosceles; git submodule init; git submodule update --recursive

Run Development Environment

Spin up virtual machine: (first run takes awhile)

$ vagrant up

All done? Congratulations!

SSH in and run the tests

[host] $ vagrant ssh
[guest] $ cd /var/www/; sudo php tests/all_tests.php

Use

See Isosceles example web app in your browser:

Note: If isosceles.dev doesn't resolve, make sure the following line is in your host computer's /etc/hosts file:

192.168.56.101 default isosceles.dev www.isosceles.dev

Use the code editor and git client of your choice on your host machine. Edit files in the isosceles directory.

Tools

Adminer database admin:

MailCatcher

SSH in:

$ vagrant ssh

Destroy virtual machine:

$ vagrant destroy

Note: This does not delete setup files or the contents of the default directory.

Modify

This Vagrant virtual machine was built with PuPHPet. To modify it for your own purposes, drag and drop puphpet/config.yaml onto (http://puphpet.com) and regenerate.