Download the PHP package dawidgorecki/litemvc without Composer

LiteMVC PHP framework

This is a simple MVC framework for PHP 7.1.0 and later.

Minimum Requirements

• PHP 7.1.0+
• PDO driver for your respective database
• mod_rewrite activated

Usage

1. Install LiteMVC framework on your machine.
2. Run composer update to install the project dependencies.
3. Enter your configuration data in a specified files.
4. Configure your web server.
5. Add routes, create controllers, views and models.

Installation

There are a few ways to install this framework.

• Use Composer:

• Download the framework directly.
• Clone the repository.

Configuration

Configuration files are stored in the Application/Configs directory. Default settings include database connection setting, SMTP configuration and some others. You can access the settings in your code like this: Config::get('DB_HOST'). Also you can add your own configuration settings in here.

For development environment, file config-production.php is used on production environment.

To change environment add one of the following instruction in bootstrap.php file.

Naming convention

• Controller Class - Singular with the first letter of each word capitalized and Controller suffix (e.g., UserController)
• View Class - Singular with the first letter of each word capitalized and View suffix (e.g., UserView)
• Database Table - Plural with underscores separating words (e.g., user_details)
• Model Class - Singular with the first letter of each word capitalized (e.g., UserDetail)

Web server configuration

Configure your web server to have the Public folder as the web root. Also add or update ServerAdmin variable in vhost configuration file. This will be used on the error pages.

Routing

The routes.php file in the Application/Configs directory.

Routes are added with the add method. You can add fixed URL routes, and specify the controller and action:

Or you can add route variables, like this:

You can specify any parameter you like within curly braces.

Controllers

Controllers are stored in the Application/Controllers folder. Controllers are classes that extend the Controller.php class, and need to be in the Controllers namespace. You can put any controller in subdirectory, but then you need to specify the namespace when adding route for these controller.

Controller has two special methods executed before and after any other actions:

Getting model and view:

Model with the same name as controller is loaded automatically. You can load another models:

Views

Views are used to display information (usually HTML). View files are in the Application/Views folder and should be a Smarty template file (*.tpl). You can find some examples with bootstrap components in Application/Views dir.

Rendering view:

Getting view as PDF file:

You can use View static methods to check witch controller and action is active:

Models

Models are used to get and store data in your application. Models extend the Model.php class and use PDO to access the database. They're stored in the Application/Models folder.

Example of database usage:

Model private properties should have the same names as columns in database table if you want to use ActiveRecord features (CRUD).

Basic CRUD

Create

To create a new record in database (e.g. add new user) we instantiating a new object (model) and then invoking the save() method.

Read

These are your basic methods to find and retrieve records from your database.

Update

To update you would just need to find a record first and then change one of attributes.

Delete

That will call SQL query to delete the record in your database.

Number of rows in table

Captcha

You can create and add captcha image to the page by using this code:

Generated phrase will be stored in the session variable captcha. You can change some settings in the CaptchaController.php file.

To reload captcha use this code:

You can compare the phrase with user input:

Emails

To send email message use this code. Be sure you are changed SMTP configuration in config file.

Logs & Errors

All errors are reporting and saved in file defined in configuration file. Default location is /Logs/error.log.

You can add log by using this code:

Error Views are stored in Application/Views/Templates/Errors folder.

You can render error View with following code:

License

Licensed under the MIT license. (http://opensource.org/licenses/MIT)