Skip to main content

Guide to Install Laravel on Mac

This guide will help you install Laravel on your Mac machine. Laravel is a PHP framework that is used to build web applications. It is a powerful and flexible framework that makes it easy to build web applications quickly.

Prerequisites​

Before you start, make sure you have the following installed on your Mac machine:

Step 1: Install Homebrew​

  1. Open a terminal window.
  2. Run the following command to install Homebrew:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  1. Follow the on-screen instructions to complete the installation.

Step 2: Install Composer​

  1. Open a terminal window.
  2. Run the following command to install Composer:
brew install composer
  1. Verify the installation by running the following command:
composer --version

Step 3: Install Node.js​

  1. Open a terminal window.
  2. Run the following command to install Node.js:
brew install node
  1. Verify the installation by running the following command:
node --version

Step 4: Install PHP​

  1. Open a terminal window.

  2. Run the following command to install PHP:

brew install php
  1. Verify the installation by running the following command:
php --version

Step 5: Install MySQL​

  1. Open a terminal window.

  2. Run the following command to install MySQL:

brew install mysql
  1. Start the MySQL service by running the following command:
brew services start mysql
  1. Verify the installation by running the following command:
mysql --version

  1. Create a new MySQL database for your Laravel project:

  2. Open a terminal window.

  3. Run the following command to log in to MySQL:

mysql -u root -p
  1. Enter your MySQL root password when prompted.
  2. Create a new database Laravel project:
CREATE DATABASE botivus;
  1. Create a new user:
CREATE USER 'botivus'@'localhost' IDENTIFIED BY 'password';
  1. Grant the user all privileges on the database:
GRANT ALL PRIVILEGES ON botivus.* TO 'botivus'@'localhost';
  1. Flush the privileges to ensure that the changes take effect:
FLUSH PRIVILEGES;
  1. Exit the MySQL shell by running the following command:
EXIT;

Step 6: Set Up Our Laravel Project​

Note: If you are a developer please follow the below steps to install our Laravel project. If you are not a developer please use don't use the below steps only follow GUI steps.

  1. Extract the Laravel project files and navigate to the project directory.
cd ~/Downloads/laravel-project
  1. Comment the below line on /public/index.php file:
 if (! file_exists(__DIR__.'/../storage/installed')) {
     header('Location: /installer/index.php');
     exit;
 }
//  to

// if (! file_exists(__DIR__.'/../storage/installed')) {
//     header('Location: /installer/index.php');
//     exit;
// }
  1. Install the project dependencies using Composer:
composer install
  1. Create a copy of the .env.example file and rename it to .env:
cp .env.example .env

  1. Configure your .env file with the correct database credentials.

  2. Generate an application key by running the following command:

php artisan key:generate
  1. Run the following command to migrate the database:
php artisan migrate
  1. Generate the application storage link by running the following command:
php artisan storage:link
  1. Generate dummy data by running the following command:
php artisan db:seed
  1. Run the following command to start the Laravel development server:
php artisan serve
  1. Start vite by running the following command:
npm run dev

Alternative: Using Laravel Valet​

If you want a more seamless local development experience, install Laravel Valet:

composer global require laravel/valet
valet install
cd ~/Projects/my-laravel-app
valet link
valet open

Now you can open your project in your browser using the valet open command.

Step 7: Access Your Laravel Project​

Open a web browser and navigate to http://localhost:8000 to view your Laravel project.

Conclusion​

Congratulations! You have successfully installed Laravel on your Mac. You can now start building web applications with Laravel. If you have any questions, feel free to reach out to our support team. 🚀