Installationsanleitung

Workerman ist tatsächlich ein PHP-Codepaket. Wenn Ihre PHP-Umgebung bereits eingerichtet ist, müssen Sie lediglich den Workerman-Quellcode oder das Demo herunterladen, um ihn auszuführen.

Composer Installation:

composer require workerman/workerman

Hinweis
Einige Composer-Proxy-Optionen sind unvollständig. Verwenden Sie den oben genannten Befehl composer config -g --unset repos.packagist, um den Proxy zu entfernen.

Windows-Nutzer (wichtig)

Seit der Version 3.5.3 unterstützt Workerman sowohl Windows- als auch Linux-Systeme. Windows-Nutzer müssen die PHP-Umgebungsvariablen konfigurieren.

=== Diese Seite gilt nur für die Linux-Umgebung von Workerman, Windows-Nutzer können dies ignorieren ===

Linux-Systemumgebung Überprüfung

Sie können folgendes Skript verwenden, um zu testen, ob Ihre PHP-Umgebung die Anforderungen für Workerman erfüllt.
curl -Ss https://www.workerman.net/check | php

Wenn das obige Skript alles mit ok anzeigt, bedeutet dies, dass die Anforderungen von Workerman erfüllt sind, und Sie können direkt die Beispiele von der offiziellen Webseite herunterladen und ausführen.

Wenn nicht alles ok ist, befolgen Sie die unten stehenden Dokumente, um die fehlenden Erweiterungen zu installieren.

(Hinweis: Das Überprüfungsskript überprüft nicht die event-Erweiterung. Wenn die Anzahl der gleichzeitigen Verbindungen über 1024 liegt, muss die event-Erweiterung installiert werden und der Linux-Kernel optimiert werden. Informationen zur Installation der Erweiterung finden Sie im folgenden Abschnitt.)

Fehlende Erweiterungen in einer vorhandenen PHP-Umgebung installieren

Installation der pcntl- und posix-Erweiterungen:

CentOS-System
Wenn PHP über yum installiert wurde, führen Sie den folgenden Befehl aus, um die pcntl- und posix-Erweiterungen zu installieren:

yum install php-process

Wenn die Installation fehlschlägt oder PHP nicht über yum installiert wurde, folgen Sie der Anleitung im Handbuch Anhang - Erweiterungen installieren, Methode 3 zur Quellcodekompilierung.

Debian/Ubuntu/macOS-System
Folgen Sie der Anleitung im Handbuch Anhang - Erweiterungen installieren, Methode 3 zur Quellcodekompilierung.

Installation der event-Erweiterung:

Um eine größere Anzahl gleichzeitiger Verbindungen zu unterstützen, muss die event-Erweiterung installiert werden, und der Linux-Kernel muss optimiert werden. Die Installation erfolgt wie folgt:

CentOS-System

  1. Installieren Sie das Abhängigkeitspaket libevent-devel für die event-Erweiterung, führen Sie folgenden Befehl aus:

    yum install libevent-devel -y
# Wenn die Installation fehlschlägt, versuchen Sie den folgenden Befehl
# yum install libevent2-devel -y

  2. Installieren Sie die event-Erweiterung, führen Sie folgenden Befehl aus:
    (event-Erweiterung erfordert PHP>=5.4)

    pecl install event

    Achten Sie darauf, bei der Aufforderung Include libevent OpenSSL support [yes] : no einzugeben und die Eingabetaste zu drücken, bei anderen Eingaben drücken Sie einfach die Eingabetaste.

  3. Führen Sie php --ini aus, um die php.ini-Datei zu finden und zu öffnen. Fügen Sie am Ende der Datei die folgende Konfiguration hinzu:

    extension=event.so

Debian/Ubuntu-Systeminstallation

  1. Installieren Sie das Abhängigkeitspaket libevent-dev für die event-Erweiterung, führen Sie folgenden Befehl aus:

    apt-get install libevent-dev -y
# Wenn die Installation fehlschlägt, versuchen Sie den folgenden Befehl
# apt-get install libevent2-dev -y

  2. Installieren Sie die event-Erweiterung, führen Sie folgenden Befehl aus:

    pecl install event

    Achten Sie darauf, bei der Aufforderung Include libevent OpenSSL support [yes] : no einzugeben und die Eingabetaste zu drücken, bei anderen Eingaben drücken Sie einfach die Eingabetaste.

  3. Führen Sie php --ini aus, um die php.ini-Datei zu finden und zu öffnen. Fügen Sie am Ende der Datei die folgende Konfiguration hinzu:

    extension=event.so

macOS-Systeminstallation

macOS-Systems sind in der Regel als Entwicklungsmaschinen konzipiert und benötigen nicht unbedingt die installation der event-Erweiterung.

Neuinstallationen (PHP + Erweiterungen neu installieren)

CentOS-Systeminstallationsanleitung

  1. Führen Sie den folgenden Befehl aus (dieser Schritt umfasst die Installation des php-cli-Hauptprogramms sowie der pcntl-, posix-, und libevent-Bibliotheken sowie des git-Programms):

    yum install php-cli php-process git gcc php-devel php-pear libevent-devel -y

  2. Installieren Sie die event-Erweiterung, führen Sie folgenden Befehl aus:
    (Hinweis: event-Erweiterung erfordert PHP>=5.4)

    pecl install event

    Achten Sie darauf, bei der Aufforderung Include libevent OpenSSL support [yes] : no einzugeben und die Eingabetaste zu drücken, bei anderen Eingaben drücken Sie einfach die Eingabetaste.

  3. Führen Sie php --ini aus, um die php.ini-Datei zu finden und zu öffnen. Fügen Sie am Ende der Datei die folgende Konfiguration hinzu:

    extension=event.so

  4. Führen Sie folgenden Befehl aus (dieser Schritt lädt das Workerman-Hauptprogramm von GitHub herunter):

    git clone https://github.com/walkor/Workerman

  5. Befolgen Sie die Anleitung im Einführungsleitfaden - Teil über einfache Entwicklungsbeispiele, um die Einstiegspunktdatei zu erstellen und auszuführen.
    Alternativ können Sie das gebündelte Demo von der offiziellen Webseite herunterladen und ausführen.

Debian/Ubuntu-Systeminstallationsanleitung

  1. Führen Sie folgenden Befehl aus (dieser Schritt umfasst die Installation des php-cli-Hauptprogramms sowie der libevent-Bibliotheken und des git-Programms):

    apt-get install php-cli git gcc php-pear php-dev libevent-dev -y

  2. Installieren Sie die event-Erweiterung, führen Sie folgenden Befehl aus:
    (Hinweis: event-Erweiterung erfordert PHP>=5.4)

    pecl install event

    Achten Sie darauf, bei der Aufforderung Include libevent OpenSSL support [yes] : no einzugeben und die Eingabetaste zu drücken, bei anderen Eingaben drücken Sie einfach die Eingabetaste.

  3. Führen Sie php --ini aus, um die php.ini-Datei zu finden und zu öffnen. Fügen Sie am Ende der Datei die folgende Konfiguration hinzu:

    extension=event.so

  4. Führen Sie folgenden Befehl aus (dieser Schritt lädt das Workerman-Hauptprogramm von GitHub herunter):

    git clone https://github.com/walkor/Workerman

  5. Befolgen Sie die Anleitung im Einführungsleitfaden - Teil über einfache Entwicklungsbeispiele, um die Einstiegspunktdatei zu erstellen und auszuführen.
    Alternativ können Sie das gebündelte Demo von der offiziellen Webseite herunterladen und ausführen.

macOS-Systeminstallationsanleitung

Methode 1: macOS hat normalerweise PHP Cli vorinstalliert, kann jedoch die pcntl-Erweiterung vermissen.

  1. Befolgen Sie die Anleitung im Handbuch Anhang - Erweiterungen installieren, Methode 3 zur Quellcodekompilierung der pcntl-Erweiterung.

  2. Befolgen Sie die Anleitung im Handbuch Anhang - Erweiterungen installieren, Methode 4 zur Installation der event-Erweiterung mit phpize (kann als Entwicklungsmaschine weggelassen werden).

  3. Laden Sie das Workerman-Hauptprogramm von https://www.workerman.net/download/workermanzip herunter oder besuchen Sie die offizielle Webseite, um Beispiele auszuführen.

Methode 2: Installieren Sie PHP und die entsprechenden Erweiterungen über den brew-Befehl.

  1. Führen Sie den folgenden Befehl aus, um das brew-Tool zu installieren (wenn brew bereits installiert ist, können Sie diesen Schritt überspringen):

    /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

  2. Führen Sie den folgenden Befehl aus, um php zu installieren:

    brew install php

  3. Führen Sie den folgenden Befehl aus, um die event-Erweiterung zu installieren:

    brew install php-event

  4. Besuchen Sie die offizielle Webseite, um Beispiele auszuführen.

Beschreibung der Event-Erweiterung

Die Event-Erweiterung ist nicht zwingend erforderlich. Wenn Ihr Geschäft mehr als 1000 gleichzeitige Verbindungen unterstützen muss, wird empfohlen, die Event-Erweiterung zu installieren, da sie eine enorme Anzahl gleichzeitiger Verbindungen unterstützt. Wenn die Anzahl der gleichzeitigen Verbindungen niedrig ist, beispielsweise unter 1000, ist die Installation nicht erforderlich.

Häufige Fragen

  1. Wenn der folgende Fehler auftritt: checking for include/event2/event.h... not found, versuchen Sie zunächst, das libevent-dev(el) Paket zu entfernen und libevent2-dev(el) zu installieren.
    CentOS-System: yum remove libevent-devel && yum install libevent2-devel
    Debian/Ubuntu-System: apt-get remove libevent-dev && apt-get install libevent2-dev

  2. Wenn der folgende Fehler auftritt: NOTICE: PHP message: PHP Warning: PHP Startup: Unable to load dynamic library '.../event.so' - ..../event.so: undefined symbol: php_sockets_le_socket in Unknown on line 0.
    Bitte ändern Sie die Lade-Reihenfolge von event.so und socket.so, indem Sie in der php.ini extension=socket.so vor extension=event.so schreiben, um sicherzustellen, dass die Socket-Erweiterung zuerst geladen wird.