Installing Homestead

You can install Homestead by cloning the code. It is recommended to clone the code into the Homestead folder in your "home" directory, so that the Homestead box can serve as the host for all your Laravel projects:

git clone https://github.com/laravel/homestead.git ~/Homestead

Because of the master branch of Homestead It is not stable, you should use the tagged stable version. You can find the latest stable version on the GitHub releases page::

cd ~/Homestead// 克隆期望的发行版本...git checkout v8.0.1

Once cloning the Homestead code is complete, use the bash init.sh command in the Homestead directory To create the Homestead.yaml configuration file. Homestead.yaml The file will be placed in the Homestead directory:

// Mac / Linux...bash init.sh// Windows...init.bat

Configuring Homestead

Set the provider

Homestead.yaml The provider parameter in the file determines which Vagrant provider you use: virtualbox, vmware_fusion, vmware_workstation, parallels and hyperv. You can set them up according to your preferences:

provider: virtualbox

Configuring shared folders

The folders attribute of the Homestead.yaml file lists all shared folders with the Homestead environment folder. If the files in these folders change, they remain in sync between the local machine and the Homestead environment. You can configure as many shared folders as needed:

folders: 
   - map: ~/code
      to: /home/vagrant/code

This general mapping will work just fine if you only create a few websites. However, as the number of sites continues to increase, you may start to experience performance issues. This problem can be very noticeable on low-performance machines or projects with a large number of files. If you encounter this problem, try mapping each project to its own Vagrant folder:

folders: 
   - map: ~/code/project1
      to: /home/vagrant/code/project1  
    - map: ~/code/project2
      to: /home/vagrant/code/project2

To enable NFS, you just need to add one to the shared folder configuration Simple flag:

folders:    - map: ~/code
      to: /home/vagrant/code
      type: "nfs"

{note} When using NFS, you'd better use the vagrant-winnfsd extension. This plugin will handle file or directory permission issues in the Homestead box for you.

You can also do this by listing any of the options supported by Vagrant's Shared Folders in options:

folders:    - map: ~/code
      to: /home/vagrant/code
      type: "rsync"
      options:
          rsync__args: ["--verbose", "--archive", "--delete", "-zz"]
          rsync__exclude: ["node_modules"]

Configuring Nginx site

Not familiar with Nginx? It doesn't matter. The sites feature allows you to easily map a "domain name" to a folder on Homestead. A simple site configuration example is included in the Homestead.yaml file. Likewise, you can add as many sites to your Homestead environment as you need. Homestead can provide a convenient virtualization environment for each Laravel project you are developing:

sites:    - map: homestead.test
      to: /home/vagrant/code/my-project/public

If you change the sites option after configuring the Homestead virtual machine, you will need to run it againvagrant reload --provision Command to update the Nginx configuration on the virtual machine.

Hosts file

You must add the domain name to the Nginx site Add it to your local hosts file. The hosts file will redirect requests to your Homestead site to your Homestead virtual machine. This file is located at /etc/hosts on Mac and Linux, and C:\Windows\System32\drivers\etc\hosts on Windows. The format for adding a new site is as follows:

192.168.10.10  homestead.test

Make sure the listening IP address is the one you set in the Homestead.yaml file. Once you've added your domain name to your hosts file and launched Vagrant Box, you can access the site through your browser:

http://homestead.test

Start Vagrant Box

Edit Homestead.yaml according to your needs, and run the vagrant up command in your Homestead folder . Vagrant will start the virtual machine and automatically configure your shared folders and Nginx site.

To delete a virtual machine, just run the vagrant destroy --force command.

Installation by project

In addition to installing Homestead globally and sharing the same Homestead box in all projects, you can configure a Homestead instance for each project. By creating a Vagrantfile under the project, other project members can have the same development environment by simply running vagrant up.

To install Homestead directly into the project, you need to use the Composer command:

composer require laravel/homestead --dev

After Homestead is installed, use the make command to generate the Vagrantfile in the project root directory and Homestead.yaml files. The make command will automatically configure the sites and folders directives in the Homestead.yaml file.

Mac/Linux:

php vendor/bin/homestead make

Windows:

vendor\bin\homestead make

Next, run the vagrant up command on the command line and access it in your browser http://homestead.test . Remember, you still need to add your homestead.test record or other domain name in the /etc/hosts file before accessing it.

Install MariaDB

If you prefer to use MariaDB instead of MySQL, you can install it in Homestead.yaml Add a mariadb option to the file. This option will remove MySQL and install MariaDB. MariaDB is only a side replacement for MySQL, so you can still use the mysql database driver in your application's database configuration:

box: laravel/homestead
ip: "192.168.10.10"memory: 2048cpus: 4provider: virtualbox
mariadb: true

Install MongoDB

If you need to install MongoDB Community Edition, you can modify the configuration in the Homestead.yaml file to:

mongodb: true

MongoDB default The installation method will set the database username to homestead and the default password to secret.

Homestead.yaml Add the elasticsearch option to the file and specify the supported version number. It can contain only the major version, or it can be a specific version number (major.minor.patch). The default installation creates a cluster named 'homestead'. Be careful to never give Elasticsearch more than half of the operating system's memory, so make sure your Homestead allocates at least twice the memory of Elasticsearch:

box: laravel/homestead
ip: "192.168.10.10"memory: 4096cpus: 4provider: virtualbox
elasticsearch: 6

{tip} You can check out the Elasticsearch documentation to learn how to do it yourself Define your configuration.

neo4j: true

alias c='clear'alias ..='cd ..'

function homestead() { 
   ( cd ~/Homestead && vagrant $* )
   }

@echo off

set cwd=%cd%
set homesteadVagrant=C:\Homestead
cd /d %homesteadVagrant% && vagrant %*
cd /d %cwd%
set cwd=
set homesteadVagrant=

backup: true

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
    - map: another.test
      to: /home/vagrant/code/another/public

192.168.10.10  homestead.test
192.168.10.10  another.test

sites:
    - map: symfony2.test
      to: /home/vagrant/code/my-symfony-project/web
      type: "symfony2"

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      params:
          - key: FOO
            value: BAR

variables:
    - key: APP_ENV
      value: local
    - key: FOO
      value: bar

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      schedule: true

MAIL_DRIVER=smtp
MAIL_HOST=localhost
MAIL_PORT=1025
MAIL_USERNAME=null
MAIL_PASSWORD=null
MAIL_ENCRYPTION=null

minio: true

's3' => [
    'driver' => 's3',
    'key' => env('AWS_ACCESS_KEY_ID'),    
    'secret' => env('AWS_SECRET_ACCESS_KEY'),    
    'region' => env('AWS_DEFAULT_REGION'),    
    'bucket' => env('AWS_BUCKET'),    
    'endpoint' => env('AWS_URL'),    
    'use_path_style_endpoint' => true
    ]

AWS_ACCESS_KEY_ID=homestead
AWS_SECRET_ACCESS_KEY=secretkey
AWS_DEFAULT_REGION=us-east-1
AWS_URL=http://homestead:9600

buckets:
    - name: your-bucket
      policy: public
    - name: your-private-bucket
      policy: none

ports:
    - send: 50000
      to: 5000
    - send: 7777
      to: 777
      protocol: udp

share homestead.test

share homestead.test -region=eu -subdomain=laravel

sites:
    - map: homestead.test
      to: /home/vagrant/code/my-project/public
      php: "7.1"

php7.1 artisan list
php7.2 artisan list
php7.3 artisan list

flip

networks:
    - type: "private_network"
      ip: "192.168.10.20"

networks:
    - type: "public_network"
      ip: "192.168.10.20"
      bridge: "en1: Wi-Fi (AirPort)"

networks:
    - type: "public_network"
      bridge: "en1: Wi-Fi (AirPort)"

sudo apt-get -y \
    -o Dpkg::Options::="--force-confdef" \
    -o Dpkg::Options::="--force-confold" \    
    install your-package

vagrant box update

git fetchgit checkout v8.0.1

composer update

vagrant destroy
vagrant up

provider: virtualbox
natdnshostresolver: off

config.vm.provider "virtualbox" do |v|
    v.customize ["setextradata", :id, "VBoxInternal2/SharedFoldersEnableSymlinksCreate/v-root", "1"]
    end