Deutsch
Deutsch
Die FFI-Erweiterung von PHP (Fremdfunction Interface) ermöglicht es uns, C-Sprachfunktionen und Datenstrukturen direkt in PHP aufzurufen. Dies ist sehr nützlich für die Behandlung leistungsempfindlicher oder zugrunde liegender Interaktionsszenarien. Aber sobald Sie es ausführlich verwenden, finden Sie einige versteckte "Minen", wie zum Beispiel - was passiert, wenn Sie vergessen, Strukturen zu schreiben, wenn Sie eine Struktur in ffi :: cDEF () deklarieren?
Angenommen, wir haben eine einfache C -Struktur:
typedef struct {
int x;
int y;
} Point;
Wir verwenden PHPs FFI :: cDEF () Deklaration:
$ffi = FFI::cdef("
typedef struct {
int x;
int y;
} Point;
");
Dann können Sie es so verwenden:
$point = $ffi->new("Point");
$point->x = 10;
$point->y = 20;
echo "Point: ({$point->x}, {$point->y})\n";
Alles läuft normal. Aber jetzt ist die Frage: Was passiert, wenn Sie vergessen, Strukturen zu schreiben?
In der C -Sprache sind Struct Point und Point zwei verschiedene Namenspaces. Wenn Sie nicht typedef verwenden, ist Point kein gültiger Typname. In PHPs FFI :: cDEF () ist die Situation etwas unterschiedlich - seine Parsing -Regeln unterscheiden sich geringfügig von denen des C -Compilers und die Fehlertoleranz ist gering.
Zum Beispiel haben Sie eine solche Erklärung geschrieben:
$ffi = FFI::cdef("
typedef struct Point {
int x;
int y;
} Point;
");
$pt = $ffi->new("Point");
Dieser Code ist in Ordnung. Aber wenn Sie den typedef -Teil nachlässig vermissen, zum Beispiel:
$ffi = FFI::cdef("
struct Point {
int x;
int y;
};
");
$pt = $ffi->new("Point"); // Ein Fehler ist aufgetreten
Hier wird $ ffi-> new ("point") eine Ausnahme auswerfen, was dazu veranlasst, dass der Typ "Punkt" nicht gefunden werden kann. Denn zu diesem Zeitpunkt ist "Punkt" ein Strukturpunkt , kein separater Alias.
Der richtige Anruf sollte sein:
$pt = $ffi->new("struct Point");
Dies ist die Fallstrick, in die sich viele Menschen verletzen: Sie glauben, dass sie den Strukturnamen "Punkt" definiert haben, aber tatsächlich definieren Sie nur "Struct Point". Wenn Sie Typedef nicht tun, können Sie den Punkt nicht direkt verwenden.
Wenn Sie einen Fehler wie folgt sehen:
FFI\Exception: undefined C type 'Point'
Dann müssen Sie zuerst überprüfen, wie Sie es in CDEF () deklarieren. Hast du gerade Struct Point ohne Typedef geschrieben? In diesem Fall können Sie Struct Point nur zur Referenz verwenden.
Eine Debugging -Technik besteht darin, Ihre CDEF () -DEklaration auszudrucken, um zu überprüfen, ob die Struktur beispielsweise typedef ist:
echo $ffi->cdef;
Obwohl diese Methode nicht immer funktioniert (insbesondere in einigen Versionen von PHP), können Sie bestätigen, dass der Typ korrekt registriert ist.
Um Verwirrung zu vermeiden, wird empfohlen, typedef in alle strukturellen Erklärungen zu bringen. Zum Beispiel:
typedef struct {
int x;
int y;
} Point;
Auf diese Weise können Sie gerne $ ffi-> new ("point") in PHP schreiben und müssen sich keine Sorgen mehr machen, ob Sie das Strukturpräfix hinzufügen möchten.
Angenommen, Sie definieren eine Struktur, die eine andere Struktur nistet:
typedef struct {
int x;
int y;
} Point;
typedef struct {
Point start;
Point end;
} Line;
Ffi :: cDEF () in PHP sollte so geschrieben werden:
$ffi = FFI::cdef("
typedef struct {
int x;
int y;
} Point;
typedef struct {
Point start;
Point end;
} Line;
");
Dann können Sie es so verwenden:
$line = $ffi->new("Line");
$line->start->x = 1;
$line->start->y = 2;
$line->end->x = 10;
$line->end->y = 20;
echo "Start: ({$line->start->x}, {$line->start->y})\n";
echo "End: ({$line->end->x}, {$line->end->y})\n";
Wenn Sie Typedef in der Erklärung verpassen, z. B. Punkte nicht typedef, wird die Definition der Zeile einen Fehler meldet, da er den Punkttyp nicht finden kann.
Achten Sie beim Aufrufen der Struktur von C mit PHP FFI unbedingt auf die folgenden Punkte:
Wenn die Struktur nicht typisiert wird, muss der Typname mit Struktur vorangestellt werden
Es wird empfohlen, dass alle Strukturen Typedef -Deklarationen verwenden, um die Benennung von Verwirrung zu vermeiden
Beim Debuggen habe ich einen undefinierten Typfehler gestoßen. Überprüfen Sie zunächst, ob die Deklarationen in CDEF konsistent sind.
Durch diese Spezifikationen können Sie viele unerklärliche Typfehler reduzieren, sodass Sie Fallstricke reduzieren und beim Spielen von C -Schnittstelle mit PHP Haare verlieren können.
Weitere Beispiele zu PHP FFI finden Sie unter https://gitbox.net/docs/php-ffi- examples.
