Skip to content
forked from panique/mini

A simple and easy to understand MVC skeleton application. Perfect for quickly building real and clean applications. Perfect to learn how MVC works.

Notifications You must be signed in to change notification settings

kevinisaac/php-mvc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PHP-MVC

An extremely simple and easy to understand MVC skeleton application, reduced to the max. Everything is as simple as possible, as manually as possible and as readable as possible. This project is - by intention - NOT a full framework, it's a bare-bone structure, written in purely native PHP ! The php-mvc skeleton tries to be the extremely slimmed down opposite of big frameworks like Zend2, Symfony or Laravel.

Basic and Advanced version

This is the basic version. There's another "Advanced" version in development which has additional features, currently Twig and SASS. More to come! Have a look here: https://github.com/panique/php-mvc-advanced

Why does this project exist ?

One of the biggest question in the PHP world is "How do I build an application ?". It's hard to find a good base, a good file structure and useful information on that, but at the same time there are masses of frameworks that might be really good, but really hard to understand, hard to use and extremely complex. This project tries to be some kind of naked skeleton bare-bone for quick application building, especially for the not-so-advanced coder.

Goals of this project:

  • give people a clean base MVC structure to build a modern PHP application with
  • teach people the basics of the Model-View-Controller architecture
  • encourage people to code according to PSR 1/2 coding guidelines
  • promote the usage of PDO
  • promote the usage of external libraries via Composer
  • promote development with max. error reporting
  • promote to comment code
  • promote the usage of OOP code
  • using only native PHP code, so people don't have to learn a framework

Installation

On Windows 7 (with EasyPHP)

There's a tutorial on How to install php-mvc on Windows 7, 8 and 8.1.

On Ubuntu etc.

First, copy this repo into a public accessible folder on your server. Common techniques are a) downloading and extracting the .zip / .tgz by hand, b) cloning the repo with git (into var/www)

git clone https://github.com/panique/php-mvc.git /var/www

or c) getting the repo via Composer (here we copy into var/www)

composer create-project panique/php-mvc /var/www dev-master
  1. Install mod_rewrite, for example by following this guideline: How to install mod_rewrite in Ubuntu

  2. Run the SQL statements in the application/_install folder.

  3. Change the .htaccess file from

RewriteBase /php-mvc/

to where you put this project, relative to the web root folder (usually /var/www). So when you put this project into the web root, like directly in /var/www, then the line should look like or can be commented out:

RewriteBase /

If you have put the project into a sub-folder, then put the name of the sub-folder here:

RewriteBase /sub-folder/
  1. Edit the application/config/config.php, change this line
define('URL', 'http://127.0.0.1/php-mvc/');

to where your project is. Real domain, IP or 127.0.0.1 when developing locally. Make sure you put the sub-folder in here (when installing in a sub-folder) too, also don't forget the trailing slash !

  1. Edit the application/config/config.php, change these lines
define('DB_TYPE', 'mysql');
define('DB_HOST', '127.0.0.1');
define('DB_NAME', 'php-mvc');
define('DB_USER', 'root');
define('DB_PASS', 'mysql');

to your database credentials. If you don't have an empty database, create one. Only change the type mysql if you know what you are doing.

A quickstart tutorial

You can also find these tutorial pictures in the _tutorial folder.

php-mvc introduction tutorial - page 1 php-mvc introduction tutorial - page 2 php-mvc introduction tutorial - page 3 php-mvc introduction tutorial - page 4 php-mvc introduction tutorial - page 5

You like what you see ?

Then please also have a look on ...

My other project php-login

A collection of 4 similar login scripts for PHP, from a super-simple one-file script with a SQLite one-file to a highly professional MVC frameworks solution. All scripts use the most advanced hashing algorithms possible in PHP, exactly like the PHP core developers want you to use them.

https://github.com/panique/php-login (full MVC framework)

https://github.com/panique/php-login-minimal (minimal)

https://github.com/panique/php-login-advanced (advanced)

https://github.com/panique/php-login-one-file (one-file)

My PHP and frontend blog

Lots of non-boring development stuff and tutorials there.

http://www.dev-metal.com

Useful information

  1. SQLite does not have a rowCount() method (!). Keep that in mind in case you use SQLite.

  2. Don't use the same name for class and method, as this might trigger an (unintended) __construct of the class. This is really weird behaviour, but documented here: php.net - Constructors and Destructors.

Add external libraries via Composer

To add external libraries/tools/whatever into your project in an extremely clean way, simply add a line with the repo name and version to the composer.json! Take a look on these tutorials if you want to get into Composer: How to install (and update) Composer on Windows 7 or Ubuntu / Debian and Getting started with Composer.

License

This project is licensed under the MIT License. This means you can use and modify it for free in private or commercial projects.

Contribute

Please commit into the develop branch (which holds the in-development version), not into master branch (which holds the tested and stable version).

Support / Donate

If you think this script is useful and saves you a lot of work, then think about supporting the project:

  1. Donate via PayPal or GitTip
  2. Rent your next server at A2 Hosting or DigitalOcean.
  3. Contribute to this project. Feel free to improve this project with your skills.
  4. Spread the word: Tell others about this project.

Linked music tracks in the demo application

The linked tracks in this naked application are just some of my personal favourites of the last few months. I think it's always a good idea to fill boring nerd-code stuff with quality culture.

Statistics (by BitDeli)

Bitdeli Badge

About

A simple and easy to understand MVC skeleton application. Perfect for quickly building real and clean applications. Perfect to learn how MVC works.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published