Site-Parameter

Sie können Ihrer Site über die params-Site-Direktive zusätzliche Nginx-fastcgi_param-Werte hinzufügen. Beispielsweise fügen wir einen BAR-Parameter mit dem Wert Foo hinzu:

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

Environment Variables

Sie Dies kann durch Hinzufügen des folgenden Werts zu Homestead.yaml erfolgen Datei zum Festlegen globaler Umgebungsvariablen:

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

Stellen Sie nach dem Aktualisieren der Homestead.yaml-Datei sicher, dass Sie den Computer neu konfigurieren, indem Sie den Befehl vagrant reload --provision ausführen. Dadurch wird die PHP-FPM-Konfiguration für alle installierten PHP-Versionen aktualisiert und die Umgebung für den vagrant-Benutzer aktualisiert.

Konfigurieren eines geplanten Zeitplans

Laravel bietet eine Möglichkeit, geplante Jobs zu planen, indem ein einzelner schedule:run Artisan geplant wird Befehle werden jede Minute ausgeführt. Der Befehl schedule:run überprüft den Zeitplan, den Sie in der Klasse AppConsoleKernel definiert haben, um zu entscheiden, welcher Job ausgeführt werden soll.

Wenn Sie den Befehl schedule:run für eine Homestead-Site ausführen möchten, können Sie beim Definieren der Site die Option schedule auf true setzen:

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

Der Cron-Job für Die Site wird im Verzeichnis /etc/cron.d der virtuellen Maschine definiert.

Mailhog konfigurieren

Mit Mailhog können Sie ausgehende E-Mails einfach erfassen und überprüfen, ohne dass tatsächlich keine Nachrichten gesendet werden an die Empfänger. Aktualisieren Sie zunächst Ihre .env-Datei mit den folgenden E-Mail-Einstellungen:

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

Sobald Mailhog konfiguriert ist, können Sie unter http://localhost:8025 auf das Mailhog-Kontrollfeld zugreifen.

Minio konfigurieren

Minio ist ein Open-Source-Objektspeicherserver mit einer API, die mit Amazon S3 kompatibel ist. Um Minio zu installieren, aktualisieren Sie Ihre Homestead.yaml-Datei mit den folgenden Konfigurationsoptionen:

minio: true

Standardmäßig ist Minio auf Port 9600 verfügbar. Sie können auf das Minio-Kontrollfeld zugreifen, indem Sie http://homestead:9600 aufrufen. Der Standardzugriffsschlüssel ist homestead und der Standardschlüssel ist secretkey. Beim Zugriff auf Minio sollten Sie immer us-east-1 verwenden.

Um Minio verwenden zu können, müssen Sie die S3-Festplattenkonfiguration in Ihrer config/filesystems.phpKonfigurationsdatei anpassen. Sie müssen die Option use_path_style_endpoint zur Festplattenkonfiguration hinzufügen und den Schlüssel url in endpoint ändern:

'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
    ]

Stellen Sie abschließend sicher, dass Ihre .env-Datei die folgende Option hat:

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

Um den Bucket zu konfigurieren, fügen Sie ein buckets zur Homestead-Konfigurationsdatei hinzu Direktive:

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

Zu den unterstützten policy-Werten gehören: none, download, upload und public.

Ports

Standardmäßig werden die folgenden Ports an Ihre Homestead-Umgebung weitergeleitet:

• SSH: 2222 -> Weiterleiten an 22
• ngrok UI: 4040 -> Weiterleiten an 4040
• HTTP: 8000 -> 80
• HTTPS: 44300 -> Weiterleiten an 443
• MySQL: 33060 -> 3306
• PostgreSQL: 54320 -> Weiterleiten an 5432
• MongoDB: 27017 -> 27017
• Mailhog: 8025 -> Weiterleiten an 8025
• Minio: 9600 -> 9600

Zusätzliche Ports weiterleiten

Sie können zusätzliche Ports an Vagrant weiterleiten, wenn Sie möchten Boxen, auch mit Angabe ihrer Protokolle:

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

Teilen Sie Ihre Umgebung

Manchmal möchten Sie den Inhalt Ihrer aktuellen Arbeit mit Kollegen oder Kunden teilen. Vagrant verfügt über eine integrierte Möglichkeit, dies über vagrant share zu unterstützen. Dies funktioniert jedoch nicht, wenn die Datei Homestead.yaml mehrere Site-Konfigurationen enthält.

Um dieses Problem zu lösen, enthält Homestead einen eigenen share-Befehl. Stellen Sie zunächst über vagrant ssh eine SSH-Verbindung zu Ihrem Homestead-Computer her und führen Sie share homestead.test aus. Dadurch wird die Homestead.yaml-Site aus Ihrem homestead.test-Profil geteilt. Natürlich können Sie jede andere konfigurierte Site durch homestead.test ersetzen:

share homestead.test

Nach dem Ausführen dieses Befehls wird ein Ngrok-Bildschirm mit dem Aktivitätsprotokoll und zugänglichen URLs für die freigegebene Site angezeigt. Wenn Sie eine benutzerdefinierte Region, Subdomain oder andere Ngrok-Laufzeitoptionen angeben möchten, können Sie diese zu Ihrem share-Befehl hinzufügen:

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

{note} Denken Sie daran, dass Vagrant wichtig ist, unsicher ist und exponiert die virtuelle Maschine mit dem Internet verbinden, wenn Sie den Befehl share ausführen.

Mehrere PHP-Versionen

Homestead 6 führt Unterstützung für mehrere PHP auf derselben virtuellen Maschinenversion ein Unterstützung. Sie können die PHP-Version angeben, die für eine bestimmte Site in Ihrer Homestead.yaml-Datei verwendet werden soll. Die verfügbaren PHP-Versionen sind: 『7.1』, 『7.2』 und 『7.3』 (Standard):

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

Außerdem können Sie jede unterstützte PHP-Version über CLI verwenden:

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

Web Server

Homestead verwendet standardmäßig den Nginx-Webserver. Wenn jedoch apache als Site-Typ angegeben ist, wird Apache installiert. Obwohl zwei Webserver gleichzeitig installiert sind, können sie nicht gleichzeitig ausgeführt werden. flip Skriptbefehle können verwendet werden, um den Wechsel zwischen Webservern einfach zu handhaben. Der Befehl flip ermittelt automatisch den laufenden Webserver und fährt ihn herunter. Dann starten Sie andere Server. Um diesen Befehl zu verwenden, stellen Sie eine SSH-Verbindung zu Ihrem Homestead-Computer her und führen Sie den Befehl im Terminal aus:

flip

Mail

Homestead enthält den Postfix-Mail-Transfer-Agent, der standardmäßig auf Port 1025 lauscht. Daher können Sie Ihre Anwendung anweisen, den localhost Mail-Treiber am 1025 Port smtp zu verwenden. Alle ausgehenden E-Mails werden von Postfix verarbeitet und von Mailhog erfasst. Um gesendete Nachrichten anzuzeigen, öffnen Sie http://localhost:8025 in einem Webbrowser.

-Attribut in

Homestead.yamlnetworks konfiguriert die Netzwerkschnittstelle für die Homestead-Umgebung. Sie können nach Bedarf mehrere Schnittstellen konfigurieren:

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

Um eine überbrückte -Schnittstelle zu aktivieren, konfigurieren Sie die bridge-Einstellungen und ändern Sie den public_network Netzwerktyp:

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

, um ihn zu aktivieren DHCP, entfernen Sie es einfach aus Ihrer Konfigurationip Optionen:

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

Homestead erweitern

Sie können Homestead mit dem after.sh-Skript im Homestead-Stammverzeichnis erweitern . In dieser Datei können Sie alle Shell-Befehle hinzufügen, die zum ordnungsgemäßen Konfigurieren und Anpassen der virtuellen Maschine erforderlich sind.

Beim Anpassen von Homestead fragt Ubuntu Sie möglicherweise, ob Sie die ursprüngliche Konfiguration des Pakets beibehalten oder mit einer neuen Konfigurationsdatei überschreiben möchten. Um dies zu vermeiden, sollten Sie bei der Installation des Pakets den folgenden Befehl verwenden, um zu vermeiden, dass zuvor von Homestead geschriebene Konfigurationen überschrieben werden:

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

Updating Homestead

Sie können Homestead aktualisieren, indem Sie einige einfache Schritte befolgen. Zuerst sollten Sie die Vagrant-Box mit dem Befehl vagrant box update aktualisieren:

vagrant box update

Als nächstes müssen Sie den Homestead-Quellcode aktualisieren. Wenn Sie das Repository geklont haben, können Sie die folgenden Befehle an dem Ort ausführen, an dem Sie das Repository ursprünglich geklont haben:

git fetchgit checkout v8.0.1

Diese Befehle rufen den neuesten Homestead-Code aus dem GitHub-Repository ab, rufen die neuesten Tags ab und überprüfen ihn dann Holen Sie sich die neueste Tag-Version. Die neueste stabile Version finden Sie auf der GitHub-Releases-Seite.

Wenn Sie Homestead über composer.json Ihres Projekts installiert haben, sollten Sie sicherstellen, dass Ihr composer.json "laravel/homestead": "^8" enthält, und Ihre Abhängigkeiten aktualisieren:

composer update

Schließlich müssen Sie Ihr Projekt zerstören und neu erstellen Homestead-Box, um die neueste Vagrant-Installation zu nutzen. Um dies zu erreichen, in Ihrem Homestead Führen Sie im Verzeichnis den folgenden Befehl aus:

vagrant destroy
vagrant up

Besondere Einstellungen bereitstellen

VirtualBox

natdnshostresolver

Standardmäßig Homestead Setzen Sie die natdnshostresolver-Konfiguration auf on. Dadurch kann Homestead die DNS-Einstellungen Ihres Host-Betriebssystems verwenden. Wenn Sie dieses Verhalten nicht außer Kraft setzen möchten, fügen Sie die folgende Zeile zu Ihrer Homestead.yaml-Datei hinzu:

provider: virtualbox
natdnshostresolver: off

Symbolische Links unter Windows

Wenn symbolische Links auf Ihrem Windows-Computer nicht ordnungsgemäß funktionieren, müssen Sie möglicherweise den folgenden Block zur Vagrantfile-Datei hinzufügen:

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