Skip to content

vaibhav-kaushal/qc-framework

 
 

Repository files navigation

Getting started with QCubed

Build Status

Releases

**Newest stable release: [version 3.0.6, released on Oct. 25, 2016].

The most recent stable version of version 2 can be found in the v2 branch.

Community

Join us on Slack on qcubed.slack.com. Get your invite here.

What is QCubed?

QCubed (pronounced 'Q' - cubed) is a PHP Model-View-Controller Rapid Application Development framework with support for PHP5 (5.4 and above) and PHP7. The goal of the framework is to save development time around mundane, repetitive tasks - allowing you to concentrate on things that are useful AND fun. QCubed excels in situations where you have a large database structure that you quickly want to make available to users.

Stateful architecture

With QCubed, you don't have to deal with POSTs and GETs coming from the browser. QCubed automatically handles that for you and packages the information into object oriented forms and controls. Programming with QCubed feels very much like programming a desktop application. If you are familiar with ASP, it is similar.

The Code Generator

The Code Generator automatically creates object classes with matching forms and controls based on your database schema. It uses the concept of ORM, object-relational mapping, to practically create your whole model layer for you.

Codegen can take advantage of foreign key relationships and field constraints to generate ready-to-use data models complete with validation routines and powerful CRUD methods, allowing you to manipulate objects instead of constantly issuing SQL queries.

More info as well as examples are available online at http://examples.qcu.be/

Object-oriented querying

Using QQueries allows for simple yet powerful loading of models, all generated ORM classes have Query methods and QQNodes. By using these methods, getting a complex subset of data is pretty straightforward - and can be used on almost any relational database.

User Interface Library

QCubed uses the concept of a QForm to keep form state between POST transactions. A QForm serves as the controller and can contain QControls which are UI components.

All QControls (including QForm itself) can use a template which is the view layer, completing the MVC structure.

QControls can take advantage of the QForm's FormState to update themselves through Ajax callbacks as easily as synchronous server POSTs. All jQuery UI core widgets are available as QControls.

Some QControls include:

  • QDialog
  • QTextBox
  • QListBox
  • QTabs
  • QAccordion

The easiest way to learn QCubed is to see the examples tutorial at http://qcu.be/examples/

Plugins

Through its plugin system, QCubed makes it easy to package and deliver enhancements and additions to the core codebase. Plugins for the currently active version of QCubed live in repositories that begin with plugin.

System Requirements

  • A development computer that you can set up so that the browser can write to a directory in your file system.
  • v3.0.x, requires PHP 5.4 and above. PHP 7 and HHVM are supported as well.
  • All html code is html5 compliant.
  • QCubed relies on jQuery for some of its ajax interactions. Also, many of the built-in controls beyond basic html controls require JQuery UI.
  • A SQL database engine. MySQL, SqlServer, Postgres, Oracle, PDO, SqlLite, Informix adapters are included. Creating another adapter is not hard if you have a different SQL.

Installation

The installation procedure is described in detail here: Installation instructions.


Latest commits

A list of the latest changes is available at https://github.com/qcubed/qcubed/commits/master

Credits

QCubed was branched out of QCodo, a project by Michael Ho. QCubed relies on JQuery and uses jQuery UI libraries for some of its core controls.

About

The official QCubed framework git repo

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 98.2%
  • JavaScript 1.5%
  • Other 0.3%