百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术教程 > 正文

PHP 扩展开发初探(php扩展开发参考手册)

mhr18 2025-03-14 18:50 30 浏览 0 评论

什么是 PHP 扩展

通俗说,PHP 扩展是增强 PHP 语言功能的插件。PHP 提供了编程语言的语法,比如分支、循环、函数、类等,这些是 PHP 本身所提供的。在某些情况下需要在 PHP 语言的基础上进行扩展,那么就需要通过 PHP 底层提供的数据结构和接口来开发 PHP 扩展,从而来补充或扩展 PHP 语言,使之更加的强大。当然了,PHP 本身就已经集成了一些基本的、强大的、优秀的 PHP 扩展。


PHP 扩展的好处

从上面的了解得知,PHP 扩展可以在 PHP 原有的基础上来扩展 PHP 的功能,使之更为的强大。另一方面,PHP 扩展可以通过“插件式”的方式来管理和维护 PHP 的功能,如果将全部的功能整合到 PHP 语言中,PHP 想必会过于臃肿,且又不够灵活。而有了扩展,就解决了这样的问题。


PHP 扩展的存在形式

在 Linux 系统下,PHP 扩展以 .so 文件存在,在 Windows 下以 .dll 文件存在。


什么时候使用 PHP 扩展

单独的使用 PHP 语言并不能满足所有的开发,比如在项目中使用 Redis 或 MongoDB 时,就需要相应的 PHP 扩展,来增强 PHP 语言,让 PHP 可以来操作 Redis 或者 MongoDB,以完成更加功能强大的项目。


什么时候开发自己的 PHP 扩展

开发自己的 PHP 扩展是必须的么?其实不是。通常情况下,作为一个 PHPer 是不需要自己开发 PHP 扩展的,但是某些情况下可能是必须要开发 PHP 扩展的。比如,我就遇到了这样的问题。合作的第三方提供了 Windows 下的动态链接库文件(.dll 文件,非 COM 的 DLL 文件),而我又没有找到如何在 PHP 下加载调用 DLL 文件的方式,因此我需要写 PHP 扩展,通过 PHP 的扩展来加载和调用第三方提供的 DLL 文件。


开发自己的 PHP 扩展

在前面我已经提到了我遇到的问题,合作的第三方提供了 Windows 下的动态链接库文件,而我又没有找到 PHP 下加载和调用 DLL 文件的方式,因此决定自己编写 PHP 扩展来加载和调用第三方提供的 DLL 文件中的导出函数。以下,就是我对于搭建开发 PHP 扩展环境和编译 PHP 扩展源码的记录。


准备工具

首先说明一点,DLL 文件只能在 Windows 系统上运行,Linux 系统上是无法进行运行的。那么,我们这个扩展是不考虑 Linux 系统的,只考虑 Windows 系统即可。因此,准备的开发工具是 VS2015。起初,我在网上查找了一些资料,很多资料中都写到,在 Windows 下开发 PHP 扩展需要安装 CygWin,经过我自己的学习,可以告诉大家“不需要”。当然了,我们的扩展只在 Windows 系统上运行,如果需要在 Linux 系统上运行,是否需要 Cygwin 我就不得而知了。当然了,其他版本的 VS 也应该是可以的,只是我只测试了 VS2015 罢了。


下载 PHP 的源代码

除了需要安装 VS2015 以外,还需要下载 PHP 的源码,我下载的源码是 PHP 7.2 的源码。

下载 PHP 源码的地址是:
https://windows.php.net/download/

打开该地址后,下载如下图所示的源代码:

在这里,下载 PHP 7.2 的源码,并注意在源码下面有一个 VC15 x64 的字样。

下载完的的文件为:php-7.2.20-src.zip

下载完源码进行解压,解压后的目录为:php-7.2.20-src

下载源码并不是一件复杂的事情,但是页面中有多个版本的源码可供下载,选择哪个有时也是比较纠结的问题,这里就下载 php7.2 的源码,因为我本地使用的就是 php7.2 的环境。


创建扩展

进入 php-7.2.20-src\ext 目录下,在该目录下有一个名为 ext_skel_win32.php 的文件,在命令行中执行:

php ext_skel_win32.php --extname=loaddll

其中,loaddll 是要创建的扩展的名称。想要成功执行该命令,需要将 PHP 的可执行程序添加到环境变量中。

执行情况如下:

λ php ext_skel_win32.php --extname=loaddll
Creating directory loaddll
FIND: Parameter format not correct
chmod: missing operand after ‘644’
Try 'chmod --help' for more information.
FIND: Parameter format not correct
chmod: missing operand after ‘755’
Try 'chmod --help' for more information.
Creating basic files: config.m4 config.w32 .gitignore loaddll.c php_loaddll.h CREDITS EXPERIMENTAL tests/001.phpt loaddll.php [done].

To use your new extension, you will have to execute the following steps:

1.  $ cd ..
2.  $ vi ext/loaddll/config.m4
3.  $ ./buildconf
4.  $ ./configure --[with|enable]-loaddll
5.  $ make
6.  $ ./sapi/cli/php -f ext/loaddll/loaddll.php
7.  $ vi ext/loaddll/loaddll.c
8.  $ make

Repeat steps 3-6 until you are satisfied with ext/loaddll/config.m4 and
step 6 confirms that your module is compiled into PHP. Then, start writing
code and repeat the last two steps as often as necessary.

看到如上的输出提示,则说明我们创建的 PHP 扩展生成成功了。以上输出如下所示:

此时,在 \ext 目录下生成了 loaddll 的目录,该目录是生成出的 PHP 的扩展模板,可以在模板的基础上进行开发。


使用 VS2015 创建扩展项目

打开 VS2015,我这里使用的是 VS2015,其他开发环境没有进行测试。

在 VS2015 中选择 “文件” -> “新建” -> “从现有代码创建项目”,来创建 PHP 扩展的解决方案,如下图:

选择了 “从现有代码创建项目” 后,会出现创建项目的向导,如下图:

直接点击 “下一步”,到如下图:

在此步骤,选择刚才生成的扩展模板的目录,然后填入项目名称,这里是“loaddll”,点击“下一步”,到达如下图:

此步骤选择DLL项目,点击下一步,到达如下图:

直接点击“下一步”,到达如下图:

点击“完成”,等待 VS2015 开始创建项目。


配置编译选项并编译项目

在 VS2015 生成项目完毕后,切换项目为 “Release”和“x64”的选项,如下图:

切换完成后,在项目上右键选择“属性”,如下图:

修改配置类型为 DLL,这样生成的目标文件扩展名自动变为 .dll,如下图所示:

选择“配置属性” -> “C/C++” -> “常规”,在“附加包含目录”中点击“编辑”来添加相关的目录,如下图:

这里需要包含的目录包括如下图的几个目录:

这里主要是添加了 PHP 源码的几个目录,因为编译 PHP 扩展的源码时需要 PHP 的底层内核数据结构进行支持,因此需要包含以上的目录。

选择“配置属性” -> “C/C++” -> “预处理器”,在“预处理器定义”中点击“编辑”来添加相关预处理指令,如下图:

在预处理中,HAVE_LOADDLL 中的 LOADDLL 是扩展的名称,COMPILE_DL_LOADDLL 中的 LOADDLL 同样也是扩展的名称,这个名称与最开始生成扩展模板时的名称应该一致。


编译源代码

把 php-7.2.20-src\win32\build\ 目录下的 config.w32.h.in 复制到 php-7.2.20-src\main\ 目录下,并重命名为 config.w32.h,这个 .h 文件在编译时是需要的,但是在 php-7.2.20-src\main\ 下并没有该文件,因此需要自己手动进行复制。

在 config.w32.h 中增加如下代码

#define PHP_COMPILER_ID "VC15" 

注意这里的 VC15 ,在下载源代码的时候,我们已经见到过这个标识了。

接着,从 PHP 的安装目录中复制 php7ts.lib 文件到 loaddll 目录下,注意,是从PHP 的安装目录中,而不是 PHP 源代码的目录中。

php7ts.lib 在目录 php7.2.10\dev 目录下,我使用的是 wamp64 下的 php7.2.10,大家自己使用对应的 .lib 文件即可,当然,这个 .lib 文件也必须是 php7.2 的,因为我们下载的是 php7.2 的源码。

在项目的 resource Files 下添加 php7ts.lib 文件,添加该文件就比较简单了,同样是右键添加即可。

按下 F7 生成解决方案,如图:

看到“成功 1 个”文件以后,在目录 \php-7.2.20-src\ext\loaddll\x64\Release 下会生成一个 loaddll.dll 文件,这个文件就是我们的 PHP 扩展文件。


PHP 扩展的安装与测试

将VS2015 生成 loaddll.dll 重命名为 php_loaddll.dll ,将其拷贝到 PHP 环境的扩展中,我的路径是 php\php7.2.10\ext,想必熟悉 PHP 的应该都会添加 PHP 扩展。如下图:

在 php.ini 文件中增加配置,如下图:

使用 php -m 来查看是否有 loaddll.dll 模块,如下图:

phpinfo 查看,如下图:

通过上面可以看出,我们的 PHP 扩展已经正常安装了,接下来就需要测试我们的扩展是否可以运行了。

在 PHP 源码目录下 php-7.2.20-src\ext\loaddll\ 有一个 loaddll.php 的测试文件,在命令行下进行执行该命令:

php loaddll.php

输出内容如下:

λ php loaddll.php
Functions available in the test extension:
confirm_loaddll_compiled


Congratulations! You have successfully modified ext/loaddll/config.m4. Module loaddll is now compiled into PHP.

如下图:

看到如上输出,说明该扩展的模板编译成功,可以继续开发实际的扩展模块了。


总结

很多时候,学习编程的第一步就是搭建环境,而往往搭建环境的过程中由于步骤过于复杂,而资料又没有傻瓜化的详细步骤,导致很多想要学习或入门的程序员连第一步都无法踏出。对于开发 PHP 扩展而言也是一样的。

如何通过 PHP 扩展来让 PHP 程序可以直接调用 DLL 中的函数,除了需要掌握 C 语言的知识以外,还需要掌握 Windows 程序设计的知识,本文就不再讨论了,因为有 C 语言的知识和 Windows 程序设计的知识,在 PHP 扩展中调用 DLL 并非难事。

希望本文对大家有所帮助!

相关推荐

【推荐】一个开源免费、AI 驱动的智能数据管理系统,支持多数据库

如果您对源码&技术感兴趣,请点赞+收藏+转发+关注,大家的支持是我分享最大的动力!!!.前言在当今数据驱动的时代,高效、智能地管理数据已成为企业和个人不可或缺的能力。为了满足这一需求,我们推出了这款开...

Pure Storage推出统一数据管理云平台及新闪存阵列

PureStorage公司今日推出企业数据云(EnterpriseDataCloud),称其为组织在混合环境中存储、管理和使用数据方式的全面架构升级。该公司表示,EDC使组织能够在本地、云端和混...

对Java学习的10条建议(对java课程的建议)

不少Java的初学者一开始都是信心满满准备迎接挑战,但是经过一段时间的学习之后,多少都会碰到各种挫败,以下北风网就总结一些对于初学者非常有用的建议,希望能够给他们解决现实中的问题。Java编程的准备:...

SQLShift 重大更新:Oracle→PostgreSQL 存储过程转换功能上线!

官网:https://sqlshift.cn/6月,SQLShift迎来重大版本更新!作为国内首个支持Oracle->OceanBase存储过程智能转换的工具,SQLShift在过去一...

JDK21有没有什么稳定、简单又强势的特性?

佳未阿里云开发者2025年03月05日08:30浙江阿里妹导读这篇文章主要介绍了Java虚拟线程的发展及其在AJDK中的实现和优化。阅前声明:本文介绍的内容基于AJDK21.0.5[1]以及以上...

「松勤软件测试」网站总出现404 bug?总结8个原因,不信解决不了

在进行网站测试的时候,有没有碰到过网站崩溃,打不开,出现404错误等各种现象,如果你碰到了,那么恭喜你,你的网站出问题了,是什么原因导致网站出问题呢,根据松勤软件测试的总结如下:01数据库中的表空间不...

Java面试题及答案最全总结(2025版)

大家好,我是Java面试陪考员最近很多小伙伴在忙着找工作,给大家整理了一份非常全面的Java面试题及答案。涉及的内容非常全面,包含:Spring、MySQL、JVM、Redis、Linux、Sprin...

数据库日常运维工作内容(数据库日常运维 工作内容)

#数据库日常运维工作包括哪些内容?#数据库日常运维工作是一个涵盖多个层面的综合性任务,以下是详细的分类和内容说明:一、数据库运维核心工作监控与告警性能监控:实时监控CPU、内存、I/O、连接数、锁等待...

分布式之系统底层原理(上)(底层分布式技术)

作者:allanpan,腾讯IEG高级后台工程师导言分布式事务是分布式系统必不可少的组成部分,基本上只要实现一个分布式系统就逃不开对分布式事务的支持。本文从分布式事务这个概念切入,尝试对分布式事务...

oracle 死锁了怎么办?kill 进程 直接上干货

1、查看死锁是否存在selectusername,lockwait,status,machine,programfromv$sessionwheresidin(selectsession...

SpringBoot 各种分页查询方式详解(全网最全)

一、分页查询基础概念与原理1.1什么是分页查询分页查询是指将大量数据分割成多个小块(页)进行展示的技术,它是现代Web应用中必不可少的功能。想象一下你去图书馆找书,如果所有书都堆在一张桌子上,你很难...

《战场兄弟》全事件攻略 一般事件合同事件红装及隐藏职业攻略

《战场兄弟》全事件攻略,一般事件合同事件红装及隐藏职业攻略。《战场兄弟》事件奖励,事件条件。《战场兄弟》是OverhypeStudios制作发行的一款由xcom和桌游为灵感来源,以中世纪、低魔奇幻为...

LoadRunner(loadrunner录制不到脚本)

一、核心组件与工作流程LoadRunner性能测试工具-并发测试-正版软件下载-使用教程-价格-官方代理商的架构围绕三大核心组件构建,形成完整测试闭环:VirtualUserGenerator(...

Redis数据类型介绍(redis 数据类型)

介绍Redis支持五种数据类型:String(字符串),Hash(哈希),List(列表),Set(集合)及Zset(sortedset:有序集合)。1、字符串类型概述1.1、数据类型Redis支持...

RMAN备份监控及优化总结(rman备份原理)

今天主要介绍一下如何对RMAN备份监控及优化,这里就不讲rman备份的一些原理了,仅供参考。一、监控RMAN备份1、确定备份源与备份设备的最大速度从磁盘读的速度和磁带写的带度、备份的速度不可能超出这两...

取消回复欢迎 发表评论: