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

@emandtf
Copy link

emandtf commented Feb 14, 2025

Without explaining how configure/use Vite during Laravel development using XAMPP, this guide/manual it's quite uselese........

@y0hannesHK
Copy link

in editing the hosts file you can do this on windows 10:

You can edit and save the host file (C:\Windows\System32\drivers\etc\hosts) in a few simple steps: Copy or drag the host file to your machine's desktop. Edit the file with notepad or any word processor of your choice. Copy or drag the file back to the /system32/drivers/etc folder.

Thanks

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