Wie schreibe ich eine PHP-Erweiterung?

Für die Erstellung jeder PHP-Erweiterung sind mindestens zwei Dateien erforderlich: eine Konfigurationsdatei, die der Kompilierungszeit mitteilt, welche Dateien erstellt werden sollen und welche externen Bibliotheken erforderlich sind, und mindestens eine Quelldatei, die die eigentliche Arbeit ausführt.

Profilierung einer Erweiterung

In der Praxis benötigen Sie normalerweise eine zweite oder dritte Konfigurationsdatei sowie eine oder mehrere Header-Dateien Fügen Sie eine Datei jedes Typs hinzu und arbeiten Sie mit ihnen.

Konfigurationsdateien

Um zu beginnen, erstellen Sie zunächst ein Verzeichnis mit dem Namen „sample“ im Verzeichnis „ext/“ Ihres PHP-Quellbaums kann überall platziert werden, aber um später in diesem Kapitel die Win32- und statischen Build-Optionen zu demonstrieren, erstellen wir es zuerst im Quellcodeverzeichnis.

Als nächstes geben Sie dieses Verzeichnis ein und erstellen eine Datei mit dem Namen config.m4 Geben Sie den folgenden Inhalt ein:

PHP_ARG_ENABLE(sample,  
  [Whether to enable the "sample" extension],  
  [  enable-sample        Enable "sample" extension support])  
      
if test $PHP_SAMPLE != "no"; then  
  PHP_SUBST(SAMPLE_SHARED_LIBADD)  
  PHP_NEW_EXTENSION(sample, sample.c, $ext_shared)  
fi

Dies ist die Mindestanforderung, um die Option „enable-sample“ aufrufen zu können, wenn ./configure Der zweite Parameter von PHP_ARG_ENABLE wird in ./configure verarbeitet Während des Vorgangs wird die erweiterte Konfigurationsdatei erreicht. Der dritte Parameter wird als Hilfemeldung angezeigt, wenn der Terminalbenutzer ./configure --help ausführt.

Haben Sie sich jemals gefragt, warum einige Erweiterungskonfigurationen „enable-extname“ verwenden? und einige Erweiterungen verwenden with-extname? Es gibt keinen funktionalen Unterschied zwischen den beiden. Tatsächlich bedeutet „enable“, dass für die Aktivierung dieser Funktion keine anderen Bibliotheken von Drittanbietern erforderlich sind, während „with“ bedeutet, dass Sie diese und andere Funktionen verwenden möchten Voraussetzungen

Jetzt muss Ihre Beispielerweiterung nicht mehr mit anderen Bibliotheken verknüpft werden, Sie müssen also nur die Aktivierungsversion verwenden. In Kapitel 17 „Externe Bibliotheken“ werden wir die Verwendung von with vorstellen und den Compiler dazu anweisen Verwenden Sie zusätzliche CFLAGS- und LDFLAGS-Einstellungen.

Wenn der Endbenutzer ./configure mit der Option „enable-sample“ aufruft, wird die lokale Umgebungsvariable $PHP_SAMPLE auf „yes“ gesetzt. ) ist eine von PHP modifizierte Version des Standard-Autoconf-Makros AC_SUBST(), das beim Erstellen von Erweiterungen als gemeinsam genutzte Module erforderlich ist.

Zu guter Letzt definiert PHP_NEW_EXTENSION() das Modul und listet alle Module auf, die vorhanden sein müssen Wird verwendet als Eine Quelldatei, die als Teil einer Erweiterung kompiliert wurde. Wenn mehrere Dateien erforderlich sind, können sie durch Leerzeichen getrennt im zweiten Argument aufgelistet werden, zum Beispiel:

PHP_NEW_EXTENSION(sample, sample.c sample2.c sample3 .c, $ ext_shared)

Der letzte Parameter entspricht dem Befehl PHP_SUBST(SAMPLE_SHARED_LIBADD), der auch beim Erstellen eines gemeinsam genutzten Moduls benötigt wird.

Header-Datei

Bei Entwicklung Bei Verwendung von C ist es manchmal üblich, die Datentypdefinitionen in externen Header-Dateien zu isolieren und in die Quelldateien einzubinden. Obwohl PHP dies nicht erfordert, wird es vereinfacht, wenn das Modul so weit wächst, dass es nicht mehr in einem platziert werden kann einzelne Quelldatei. Funktional.

Beginnen Sie in Ihrer Header-Datei php_sample.h mit Folgendem:

#ifndef PHP_SAMPLE_H  
/* 防止重复包含 */
#define PHP_SAMPLE_H  
      
/* 定义扩展的属性 */
#define PHP_SAMPLE_EXTNAME    "sample"  
#define PHP_SAMPLE_EXTVER    "1.0"  
      
/* 在php源码树外面构建时引入配置选项 */
#ifdef HAVE_CONFIG_H  
#include "config.h"  
#endif  
      
/* 包含php的标准头文件 */
#include "php.h"  
      
/* 定义入口点符号, Zend在加载这个模块的时候使用 */
extern zend_module_entry sample_module_entry;  
#define phpext_sample_ptr &sample_module_entry  
      
#endif /* PHP_SAMPLE_H */

Diese Header-Datei erfüllt zwei Hauptaufgaben: Wenn die Erweiterung mit phpize erstellt wurde Tool (Dieses Buch verwendet normalerweise diese Methode), dann wird HAVE_CONFG_H definiert, sodass config.h normalerweise eingebunden wird. Unabhängig davon, wie die Erweiterung kompiliert wird, wird php.h aus dem PHP-Quellbaum eingebunden. Enthält andere Header-Dateien, die für den Zugriff auf die meisten PHPAPIs im PHP-Quellcode verwendet werden. Als Nächstes wird die von Ihrer Erweiterung verwendete zend_module_entry-Struktur als extern definiert, sodass sie beim Laden dieses Moduls mit extension=xxx von Zend abgerufen werden kann mit dlopen und dlsym().

Die Header-Datei enthält auch einige Vorverarbeitungen, die die Informationen definieren, die in der Originaldatei verwendet werden.

Quellcode

Schließlich die Das Wichtigste, was Sie erstellen müssen, ist ein einfaches Quellcode-Skelett in sample.c:

Das obige ist der detaillierte Inhalt vonWie schreibe ich eine PHP-Erweiterung?. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!