In web development, frameworks are essential for building scalable and maintainable applications. While there are many popular frameworks like Laravel and Symfony, building your own custom MVC (Model-View-Controller) framework can help deepen your understanding of PHP and how web frameworks operate. In this article, we’ll walk through the basic concepts and steps involved in creating a simple MVC framework from scratch using PHP.<\/p>\n\n\n\n
MVC (Model-View-Controller) is a design pattern that separates an application into three interconnected components:<\/p>\n\n\n\n
This separation of concerns makes it easier to manage code, improve scalability, and allow different team members to work on various aspects of an application.<\/p>\n\n\n\n
The first step is to create a well-organized file structure for your framework. Here’s a simple structure:<\/p>\n\n\n\n
\/myMVCframework\n \/app\n \/controllers\n \/models\n \/views\n \/core\n Controller.php\n Model.php\n View.php\n \/public\n index.php\n .htaccess\n<\/code><\/pre>\n\n\n\n\n- app\/controllers<\/strong>: This folder will contain your application’s controllers.<\/li>\n\n\n\n
- app\/models<\/strong>: This folder will store your application’s models, which represent the data and business logic.<\/li>\n\n\n\n
- app\/views<\/strong>: This folder will contain the HTML templates and other UI elements that users see.<\/li>\n\n\n\n
- core<\/strong>: This folder will hold the core classes of your framework, such as the base controller, model, and view classes.<\/li>\n\n\n\n
- public\/index.php<\/strong>: This is the entry point of the application. All requests will go through this file.<\/li>\n<\/ul>\n\n\n\n
Step 2: Setting Up Routing in .htaccess<\/code><\/strong><\/h4>\n\n\n\nThe .htaccess<\/code> file will ensure that all requests are directed to index.php<\/code>, which will handle the routing of your application.<\/p>\n\n\n\n.htaccess:<\/strong><\/p>\n\n\n\nRewriteEngine On\nRewriteCond %{REQUEST_FILENAME} !-f\nRewriteCond %{REQUEST_FILENAME} !-d\nRewriteRule ^(.*)$ index.php [QSA,L]\n<\/code><\/pre>\n\n\n\nThis configuration directs all incoming requests to the index.php<\/code> file, regardless of the URL.<\/p>\n\n\n\nStep 3: Creating the Core Files (Controller, Model, and View)<\/strong><\/h4>\n\n\n\nLet’s create the basic functionality for the Controller, Model, and View.<\/p>\n\n\n\n
core\/Controller.php:<\/strong><\/p>\n\n\n\n<?php\nclass Controller {\n public function view($view, $data = []) {\n require_once '..\/app\/views\/' . $view . '.php';\n }\n\n public function model($model) {\n require_once '..\/app\/models\/' . $model . '.php';\n return new $model();\n }\n}\n<\/code><\/pre>\n\n\n\nThis base Controller<\/code> class allows us to load views and models. It will be extended by all specific controllers in the app\/controllers<\/code> directory.<\/p>\n\n\n\ncore\/Model.php:<\/strong><\/p>\n\n\n\n<?php\nclass Model {\n \/\/ Here you can define the database connection and methods to interact with the database\n}\n<\/code><\/pre>\n\n\n\nThe Model.php<\/code> will be used as the parent class for all models. For now, we\u2019ll keep it simple, but later it can be extended to include database interactions.<\/p>\n\n\n\ncore\/View.php:<\/strong><\/p>\n\n\n\n<?php\nclass View {\n \/\/ This class will be responsible for rendering the views\n}\n<\/code><\/pre>\n\n\n\nThe View.php<\/code> class will handle the presentation layer of the application, such as rendering HTML and passing data from the controller to the view.<\/p>\n\n\n\nStep 4: Handling Routing and Requests in index.php<\/code><\/strong><\/h4>\n\n\n\nIn the public\/index.php<\/code> file, we will handle the routing and direct requests to the correct controller and action.<\/p>\n\n\n\npublic\/index.php<\/strong>:<\/p>\n\n\n\n<?php\n\n\/\/ Include the core files\nrequire_once '..\/core\/Controller.php';\n\n\/\/ Get the URL and split it into parts\n$url = isset($_GET['url']) ? $_GET['url'] : null;\n$url = rtrim($url, '\/');\n$url = filter_var($url, FILTER_SANITIZE_URL);\n$url = explode('\/', $url);\n\n\/\/ Example: \/home\/index\n$controller = !empty($url[0]) ? $url[0] : 'home'; \/\/ Default controller is 'home'\n$method = isset($url[1]) ? $url[1] : 'index'; \/\/ Default method is 'index'\n$params = array_slice($url, 2); \/\/ Any additional parameters\n\n\/\/ Check if the controller exists\nif (file_exists('..\/app\/controllers\/' . ucfirst($controller) . '.php')) {\n require_once '..\/app\/controllers\/' . ucfirst($controller) . '.php';\n $controller = new $controller();\n \n \/\/ Check if the method exists\n if (method_exists($controller, $method)) {\n call_user_func_array([$controller, $method], $params);\n } else {\n echo 'Method not found!';\n }\n} else {\n echo 'Controller not found!';\n}\n<\/code><\/pre>\n\n\n\nThis script fetches the controller, method, and parameters from the URL, then loads and calls the appropriate controller and method.<\/p>\n\n\n\n
Step 5: Creating a Simple Controller and View<\/strong><\/h4>\n\n\n\nNow that our core structure is in place, let\u2019s create a simple controller and view to see our framework in action.<\/p>\n\n\n\n
app\/controllers\/Home.php<\/strong>:<\/p>\n\n\n\n<?php\nclass Home extends Controller {\n public function index() {\n $data = ['title' => 'Welcome to My Custom MVC Framework'];\n $this->view('home\/index', $data);\n }\n}\n<\/code><\/pre>\n\n\n\napp\/views\/home\/index.php<\/strong>:<\/p>\n\n\n\n<!DOCTYPE html>\n<html>\n<head>\n <title><?php echo $data['title']; ?><\/title>\n<\/head>\n<body>\n <h1><?php echo $data['title']; ?><\/h1>\n <p>This is a simple MVC framework built with PHP!<\/p>\n<\/body>\n<\/html>\n<\/code><\/pre>\n\n\n\nWhen a user visits \/home\/index<\/code> (or just \/<\/code>, since home\/index<\/code> is the default), the Home<\/code> controller\u2019s index<\/code> method will be called, which loads the home\/index.php<\/code> view with the $data<\/code> array passed from the controller.<\/p>\n\n\n\nStep 6: Adding a Model<\/strong><\/h4>\n\n\n\nWe\u2019ll now add a simple model to demonstrate how the MVC pattern works together.<\/p>\n\n\n\n
app\/models\/User.php<\/strong>:<\/p>\n\n\n\n<?php\nclass User {\n public function getUsers() {\n return ['John', 'Jane', 'Doe'];\n }\n}\n<\/code><\/pre>\n\n\n\nUpdate the controller to use this model:<\/p>\n\n\n\n