README.md

Endless Suffering

A Twitter-like social media app written in vanilla PHP. Made as a final project for the web dev class at my university.

Unnecessarily complex because I like pain, and regular CRUD app is just plain boring.

Running Locally using XAMPP in Windows

1. Install XAMPP and Composer.

2. Add virtual host, you can use different directory and/or domain, just make sure to set the document root to the public folder.

   In the example, the repo is located in C:\xampp\htdocs\final and the domain is final_0013.test.

   # C:\xampp\apache\conf\extra\httpd-vhosts.conf
   <VirtualHost final_0013.test>
   DocumentRoot "C:/xampp/htdocs/final/public"
   ServerName final_0013.test
       <Directory "C:/xampp/htdocs/final/public">
           Options FollowSymLinks
           AllowOverride All
   
           Order allow,deny
           Allow from all
       </Directory>
   </VirtualHost>

   # C:\Windows\System32\drivers\etc\hosts
   127.0.0.1       final_0013.test
   

3. Start Apache and MySQL module on XAMPP control panel.

4. Copy .env.example to .env and modify if needed.

5. Install Dependencies and migrate database.

   composer install
   php database/migration/0000_all.php
   

   Composer may complain about failing to install mPDF, this is probably caused by some PHP extensions are not enabled.

   Open C:\xampp\php\php.ini, and make sure gd and mbstring extensions are enabled (line not started by a semicolon ;).

   extension=gd
   extension=mbstring

6. Go to final_0013.test.

Libraries

• PHP dotenv
• Faker
• Mpdf
• JQuery
• Bootstrap
• Font Awesome

References

How to Build a Routing System for a PHP App from Scratch