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.

#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 */

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!