Top

Documentation

Taxido is a unique and innovative app and website that brings a range of professional taxi services to your doorstep. Whether you need a quick ride, a rental, or intercity travel, Taxido offers reliable, convenient, and efficient solutions. Taxido - your all-in-one taxi service!

Prerequisites

XAMPP/MAMP/LAMP Server

A XAMPP/MAMP/LAMP server is necessary for running PHP Laravel on a local server. If a web server is not installed on your computer, refer to the following links for installation guides on various operating systems.

To run the application, you need to download a web server:

  1. For Mac systems, download MAMP or XAMPP Server.
  2. For Windows systems, download MAMP or XAMPP Server.
  3. For Linux systems, download LAMP or XAMPP Server.

MAMP Server can be downloaded from https://www.mamp.info/en/mamp/ for Windows/Mac.

XAMPP Server can be downloaded from https://www.apachefriends.org/download.html for Windows/Linux/Mac.

PHP Version

PHP Version >= 8.2 is required.

To verify the PHP version installed on your server, enter the following command into your terminal or command line: 

php -v

PHP Extensions

The following PHP extensions are required for Laravel to function properly:

  • gd PHP Extension
  • ctype PHP Extension
  • curl PHP Extension
  • fileinfo PHP Extension
  • json PHP Extension
  • mbstring PHP Extension
  • OpenSSL PHP Extension
  • pcre PHP Extension
  • pdo PHP Extension
  • tokenizer PHP Extension
  • pdo_mysql PHP Extension
  • pdo_sqlite PHP Extension
  • xml PHP Extension
  • zip PHP Extension

Composer

Composer is essential for managing Laravel dependencies. If Composer is not installed on your computer, refer to the following links for installation guides:

For Taxido Admin

Node.js is required for frontend asset compilation in Laravel applications. Follow the steps below to install Node.js and npm:

  1. Visit the official Node.js website https://nodejs.org/en and download the recommended version for your operating system.
  2. Open a command prompt or terminal and run the following commands to verify the installation:
node -v

Common Issues & Solutions

Issue: Laravel throws errors related to missing PHP extensions (e.g., gd, mbstring, curl).

Solution: Enable the required PHP extensions in your php.ini file. For example:

extension=gd
extension=mbstring
extension=curl

Restart your server after making changes. For more details, refer to

Install or enable PHP Extension Ubuntu: click here.
Install or enable PHP Extension XAMPP: click here
Install or enable PHP Extension MAMP: click here

Issue: Composer installation fails due to missing dependencies or incorrect PHP configuration.

Solution: Ensure your system meets the requirements for Composer. If the installation fails, refer to the official Composer documentation or this How install composer?.

Issue: Errors occur due to an incompatible Node.js version (e.g., version < 20.x.x).

Solution: Use a Node.js version manager like nvm to install and switch to Node.js version 20.x.x. Run the following commands:

nvm install 20
nvm use 20

For more help, refer to this StackOverflow thread.

Issue: Errors occur due to incorrect or missing configuration in the .env file.

Solution: Ensure your .env file is properly configured with the correct database credentials, app URL, and other settings. Example:

APP_URL=http://localhost
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database
DB_USERNAME=root
DB_PASSWORD=

For more details, refer to the Laravel Configuration Documentation.

Issue: Running npm install fails due to network issues or permission errors.

Solution: Clear the npm cache and try again:

npm cache clean --force
npm install

If the issue persists, refer to Troubleshooting npm install Errors.