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.
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
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.
- 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
If you are stuck with something even AFTER reading and following the install tutorials and the quick-manual, then feel free to ask in the official forum. Note that this forum is fresh and new, more content will come over time.
There's a tutorial on How to install php-mvc on Windows 7, 8 and 8.1.
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
-
Install mod_rewrite, for example by following this guideline: How to install mod_rewrite in Ubuntu
-
Run the SQL statements in the application/_install folder.
-
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/
- 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 !
- 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.
You can also find these tutorial pictures in the _tutorial folder.
Then please also have a look on ...
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)
Lots of non-boring development stuff and tutorials there.
-
SQLite does not have a rowCount() method (!). Keep that in mind in case you use SQLite.
-
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.
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.
This project is licensed under the MIT License. This means you can use and modify it for free in private or commercial projects.
Please commit into the develop branch (which holds the in-development version), not into master branch (which holds the tested and stable version).
If you think this script is useful and saves you a lot of work, then think about supporting the project:
- Donate via PayPal, GitTip or Flattr.
- Rent your next server at A2 Hosting or DigitalOcean.
- Contribute to this project. Feel free to improve this project with your skills.
- Spread the word: Tell others about this project.
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.