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.

Revisions

  1. bradtraversy created this gist Apr 22, 2022.
    89 changes: 89 additions & 0 deletions laravel_xampp_setup.md
    Original file line number Diff line number Diff line change
    @@ -0,0 +1,89 @@
    # 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