An MVC application written in plain PHP without libraries or frameworks
Laconia is a personal project created by Tania Rascia to learn the fundamentals of programming and modern web development from scratch. The main goals of the project are to learn MVC (Model View Controller) architecture, the OOP (Object-Oriented Programming) paradigm, routing, authentication, security, modern development practices, and how to tie it all together to make a functional web app.
Laconia runs on PHP 7.2 and MySQL. It uses Composer to autoload classes and configuration and utility files, as well as future tests through PHPUnit. Node.js is used to compile Sass to CSS via npm scripts. I utilized Primitive, my Sass workflow, for the styles.
Please feel free to fork, use, comment, critique, suggest, improve or help in any way.
View the live test or install a local copy with the instructions below.
Install Apache, MySQL, and PHP
If using MAMP, add MAMP to the PHP command line by adding this line to
Composer is the standard in PHP for dependency management, class autoloading, and much more.
curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer
Set up server
Create a virtual host called
laconia.server. The server should point to the
/public directory. For me,
httpd-vhosts.conf looks like this.
<VirtualHost *:80> DocumentRoot "/Users/tania/hosts/laconia/public" ServerName laconia.server </VirtualHost>
Run install script
php bin/install.phpin the root directory to initialize the database.
composer installto autoload classes and configuration.
npm installto allow use of Sass
- In order to run Sass, use
npm run sass.
Laconia is all set up and ready to use!
The entire program flows through
/public/index.php, and the rest of the project is a directory above public.
In Laconia, you can register an account, log in, log out, reset your password, create and edit lists, and view public profiles.
/register- Register a new user
/login- Login to user account
/home- Logged in home screen
/logout- Logout of user session
/forgot-password- Get a password reset link
/create-password- Create a new password
/view-users- View all users
/settings- Edit user settings
/create- Create a new list
/edit/:list_id- Edit an existing list
/:username- View public profile
/404- Any not found redirects to 404.
Laconia uses PHPUnit for unit testing. Tests will go in the
/tests directory. For now, here is how to run a Hello, World! script.
- Set up SSL and put on a live server
- Make nav responsive
- Email empty password forgot - PHP Mailer
- Comment board
- Make sure users can't comment as someone else
- Instant display of comment state in the DOM
- Allow users to delete list items in add mode
- Make router class
- Fix issue with trailing slash in URL
- Forgot Password
- Create Password
- Create List
- Edit List
- Do not allow > 255 chars for lists
- Add ability to delete a user account
- Disallow spaces in usernames
- Comment all code
- Create a user settings page
- Make view for public user lists
- Prevent adding new list items if post is empty
- Create a top navigation bar when logged in
- Add CSS styles (Primitive)
- Disallow multiple same usernames with different casing
- Make Sass watch
- Integrate Composer for autoloading of classes and config
- Clean up password validation code
- Allow users to edit their own lists - /edit
- Allow user to create a list with list items - /create
- Create public facing user profile - laconia.test/$username - will require Apache redirects? or PHP redirects?
- Make routing dynamic based on incoming pathname and existing files, rather than a switch with each filename
- Separate POST and GET into different functions - do not display POST code in GET view
- Turn all controllers into classes
- Route all URLs through index.php
- Separate views into partials
- Separate business logic (controller) from HTML (view)
- Add ability to reset password of users
- Add ability to log in, log out, and register a user
I've used a combination of many tutorials and StackOverflow posts to create this project. These have been the most important.
- How to reset user password
- How to create a user login
- How to make a PDO class
- How to validate passwords
- General structure of a PHP application
- Directory structure example
- Promisify XHR
- MVC concepts and routing class
The code is open source and available under the MIT License.
Written and maintained by Tania Rascia.