Skip to content

Instantly share code, notes, and snippets.

@bradtraversy
Created April 22, 2022 01:16
Show Gist options
  • Save bradtraversy/7485f928e3e8f08ee6bccbe0a681a821 to your computer and use it in GitHub Desktop.
Save bradtraversy/7485f928e3e8f08ee6bccbe0a681a821 to your computer and use it in GitHub Desktop.
Laravel Xampp setup on Mac and Windows

Laravel Xampp Setup (Windows & Mac)

Install Xampp

Install Xampp from https://www.apachefriends.org/index.html

  • Run the Xampp installer and open the Xampp control panel
  • Make sure that you enable the Apache and MySQL services
  • On mac you need to click "Start" on the Home tab, "Enable" on the Network tab and "Mount" on the Location Tab. Click "Explore" on the location tab to open your Xampp/Lampp folder

Install Composer

Go to https://getcomposer.org/download

  • On Windows, download and run the installer
  • On Mac, copy the php commands and run in the terminal. Then copy the mv command and run in terminal. You can also install composer with Homebrew

Create a New Laravel Project With Composer

Open a terminal in the htdocs folder. htdocs is where all of your local projects go.

htdocs folder location:

  • Windows - C:\Xampp\htdocs
  • Mac - /opt/lampp/htdocs
composer create-project --prefer-dist laravel/laravel PROJECT_NAME

Virtual Host Setup

We now need to create a virtual host for our project

Edit Hosts File

  • Windows - C:/Windows/System32/drivers/etc/hosts
  • Mac - /etc/hosts

Add these lines

127.0.0.1	localhost
127.0.0.1	PROJECT_NAME.test

Edit Virtual Hosts File

  • Windows - C:/xampp/apache/conf/extra/httpd-vhosts.conf
<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs"
    ServerName localhost
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/PROJECT_NAME/public"
    ServerName PROJECT_NAME.test
 </VirtualHost>
  • Mac - /opt/lampp/etc/extra/httpd-vhosts.conf
<VirtualHost *:80>
    DocumentRoot /opt/lampp/htdocs
    ServerName localhost
    ServerAlias www.localhost
</VirtualHost>


<VirtualHost *:80>
    DocumentRoot /opt/lampp/htdocs/PROJECT_NAME/public
    ServerName PROJECT_NAME.test
    ServerAlias www.PROJECT_NAME.test
</VirtualHost>

Restart Apache with the Xampp panel

Now visit http://laravel.test ot htttp://laravel.test:8080 on Mac

If it does not work, make sure virtual hosts file is enabled in httpd.conf

  • Windows - C:/xampp/apache/conf/httpd.conf
  • Mac - /opt/lampp/etc/httpd.conf

Remove the # from the beginning of this line

#Include etc/extra/httpd-vhosts.conf

Save the file

@imannms000
Copy link

imannms000 commented Sep 21, 2023

Change server name from PROJECT_NAME.test to localhost. It's works!

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs"
    ServerName xampp.test
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/PROJECT_NAME/public"
    ServerName localhost
 </VirtualHost>

@HoussemMhiri
Copy link

https://youtu.be/ABxWF4WjLLE this worked for me

@Ango1415
Copy link

https://youtu.be/ABxWF4WjLLE this worked for me

For me too, just follow the original instructions of this post and change some names as in the example of the youtube video, works fine!
Thanks HoussemMhiri

@NathanMysolution
Copy link

I also struggled with the instructions on this page. I've documented the steps I took, and will paste them below.

This worked for me:

Software to Install

Install Xampp
Install Composer

Configure PHP.ini

Open Xampp and click on the Config button to the right of the Apache server. Choose PHP (php.ini) to edit the PHP configuration file.

Setup PHP Ini

Find the line that says ;extension=zip and remove the ; comment symbol to activate the ZIP extension.
Save the php.ini file.

Activate ZIP Extension

Setup a New Laravel Project

Open a new Command Prompt (tap Windows key and search for cmd).
Type cd \xampp\htdocs (or another path if you installed Xampp anywhere else)

Go to htdocs folder

Create a new Laravel Project (laragigs in the below example), by typing the following:

composer create-project --prefer-dist laravel/laravel laragigs

Create a Virtual Host

To setup a virtual http://laragigs.test host for testing purposes, do the following:

Open a File Explorer and go to C:/Windows/System32/drivers/etc.
Open the file called hosts in a text editor with Admin Privileges.

Add these two lines to the bottom of the hosts file:

127.0.0.1	localhost
127.0.0.1	laragigs.test

Save the file.

Then go to C:/xampp/apache/conf/extra and open the file called httpd-vhosts.conf.

Add these lines to the bottom:

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs"
    ServerName localhost
</VirtualHost>

<VirtualHost *:80>
    DocumentRoot "C:/xampp/htdocs/laragigs/public"
    ServerName laragigs.test
 </VirtualHost>

Save the document and restart the Apache Server in Xampp.

Restart Apache from XAMPP

Then surf to http://laragigs.test and you should see the default Laravel startpage.

Open Laravel Project Folder in Visual Studio Code

Open a Command Prompt if you haven't done so already and cd into the \xampp\htdocs\laragigs folder.

Now, type in code . to open the current folder in Visual Studio Code.

Open Laragigs in VS Code

Et voilá!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment