README

Nova Framework

• What is the Nova Framework?
• Requirements
• Installation
  • Recommended
  • Manual
• Documentation
• Contributing
  • Issue Tracker
  • Pull Requests
  • Code Style
• License

What is the Nova Framework?

Nova Framework is a PHP 7.1 MVC system. It's designed to be lightweight and modular, allowing developers to build better and easy to maintain code with PHP.

The base framework comes with a range of helper classes.

Requirements

The framework requirements are limited.

• PHP 7.1 or greater.
• Apache Web Server or equivalent with mod rewrite support.
• IIS with URL Rewrite module installed - http://www.iis.net/downloads/microsoft/url-rewrite

The following PHP extensions should be enabled:

• Fileinfo (edit php.ini and uncomment php_fileinfo.dll or use php selector within cpanel if available.)
• OpenSSL
• INTL
• MBString

Note: Although a database is not required, if a database is to be used, the system is designed to work with a MySQL database using PDO.

Installation

This framework was designed and is strongly recommended to be installed above the document root directory, with it pointing to the webroot folder.

Additionally, installing in a sub-directory, on a production server, will introduce severe security issues. If there is no choice still place the framework files above the document root and have only index.php and .htacess from the webroot folder in the sub folder and adjust the paths accordingly.

Recommended

The framework is located on Packagist.

You can install the framework from a terminal by using:

composer create-project nova-framework/framework foldername 4.* -s dev

The foldername is the desired folder to be created.

Note: You can install the bare application variant from a terminal by using:

composer create-project nova-framework/app foldername 4.* -s dev

Note: For additional installation instructions, for example; setting up a Virtualhost (Recommended for Local Development), Nginx or IIS with URL Rewrite, please visit the install docs.

Documentation

Full docs & tutorials are available on novaframework.com.

Screencasts are available on https://novaframework.com/screencasts.

Contributing

Issue Tracker

You can find outstanding issues on the GitHub Issue Tracker.

Pull Requests

• Each pull request should contain only one new feature or improvement.
• Pull requests should be submitted to the correct version branch ie 4.0/master

Code Style

All pull requests must use the PSR-2 code style.

• Code MUST use the PSR-1 code style.
• Code MUST use 4 spaces for indenting, not tabs.
• There MUST NOT be a hard limit on line length; the soft limit MUST be 120 characters; lines SHOULD be 80 characters or less.
• There MUST be one blank line after the namespace declaration, and there MUST be one blank line after the block of use declarations.
• Opening braces for classes MUST go on the next line, and closing braces MUST go on the next line after the body.
• Opening braces for methods MUST go on the next line, and closing braces MUST go on the next line after the body.
• Visibility MUST be declared on all properties and methods; abstract and final MUST be declared before the visibility; static MUST be declared after the visibility.
• Control structure keywords MUST have one space after them; method and function calls MUST NOT.
• Opening braces for control structures MUST go on the same line, and closing braces MUST go on the next line after the body.
• Opening parentheses for control structures MUST NOT have a space after them, and closing parentheses for control structures MUST NOT have a space before.

License

The Nova Framework is under the MIT License, you can view the license here.