首页 > 代码库 > PHP扩展调用C++静态库

PHP扩展调用C++静态库

概述

      php通过扩展方式,调用c++源码,这样做的理由有很多,当你搜到这篇文章时,相信你已经有自己的考虑了。

写这篇博客的理由有二:

  1. 整理下php扩展调用c++代码的过程。嗯,对,网上有很多类似的文章,不过对于php扩展c++的方式,很多文章在关键的地方并没有说明,或者说,大部分都是扩展调用c代码的。
  2. 已经两年有余没写博客了,在这2017刚开始的时候,开个博客,开始新的旅程,也是不错的,哈哈。

 

大概目录

  • c++编译静态库
  • php 扩展编辑
  • 结语

注:下面步骤的操作环境——系统macOS10.12.2,PHP版本 5.6.29.

 c++编译静态库

头文件:hello.h

#include<string>
std::string hello_joint(std::string a, std::string b);

实现头文件定义的函数:hello.cpp

 #include "hello.h" 
 std::string hello_joint(std::string a, std::string b)
 {
     std::string str = a+b;
     return str;
 }   

生成hello.o文件

g++ -c hello.cpp

生成静态库libhello.a文件

ar -r libhello.a hello.o

写个简单的test.cpp测试下:

1 #include<iostream>
2 #include "hello.h"
3 int main()
4 {
5     std::string a = std::string("Hello ");
6     std::string b = std::string("World!");
7     std::cout<<hello_joint(a, b)<<std::endl;
8     return 0;
9 }

编译

g++ test.cpp libhello.a 

运行

./a.out 

终端输出

Hello World!

  这样,你的c++静态库制作完成。

 

php 扩展编辑

      如果要编辑php扩展,需要下载php源码,这里下载的是php-5.6.16。写文章的时候,才发现php源码版本和系统的php版本不一致。因为是先下载的php源码,然后通过brew install php56,不过,影响不大,不用纠结。

运行如下命令,产生扩展文件夹january

./ext_skel --extname=january 

  命名为january,主要是不想跟c++源码hello产生任何关系,以免后面混淆,当然,也是因为想不出其他比较好的名字。

 

首先编辑config.m4,需要改的地方大概归结为三处:

  1、找到如下三行,并把前面的注释dnl去掉。

PHP_ARG_ENABLE(january, whether to enable january support,
Make sure that the comment
is aligned:
[
--enable-january Enable january support])

  2、找到如下的代码,并在它的下面加上相应代码,以支持c++调用。

if test "$PHP_JANUARY" != "no"; then
  dnl Write more examples of tests here...

要加上的相应代码,注意其中的参数名。

if test "$PHP_JANUARY" != "no"; then
  dnl Write more examples of tests here...


  PHP_ADD_INCLUDE(./include)
  PHP_ADD_LIBRARY(stdc++, 1, JANUARY_SHARED_LIBADD)
  PHP_ADD_LIBRARY_WITH_PATH(hello, ./lib, JANUARY_SHARED_LIBADD)
  PHP_REQUIRE_CXX()
  PHP_SUBST(JANUARY_SHARED_LIBADD)

  3、同时,在该函数的最后一行,把january.c改为january.cpp

PHP_NEW_EXTENSION(january, january.cpp, $ext_shared)

 

january.cpp需要做的工作比较多:

  1、重命名:把january.c改为为january.cpp;

  2、在两处地方加上EXTERN "C"标识,这点不要忘了:

第一处加extern "C"{},并在下面加上需要的c++头文件:

extern "C" {
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
#include "php_january.h"
}

#include<string>
#include "hello.h"

第二处加BEGIN_EXTERN_C()和END_EXTERN_C():

#ifdef COMPILE_DL_JANUARY
BEGIN_EXTERN_C()       ==>添加的
ZEND_GET_MODULE(january)
END_EXTERN_C()         ==>添加的
#endif

  3、在如下的地方,加入函数名称,可以理解为php要调用的函数的声明:

const zend_function_entry january_functions[] = {
    PHP_FE(confirm_january_compiled,    NULL)       /* For testing, remove later. */
    PHP_FE(january_say, NULL)
    PHP_FE_END  /* Must be the last line in january_functions[] */
};

  4、注意到january.cpp中,它编写了一个函数例子confirm_january_compiled,现在,我们也需要完成january_say的函数实现,它接收来自php的参数,并在函数中调用c++函数。

PHP_FUNCTION(january_say)
{
    char *arg1 = NULL, *arg2 = NULL;
    int arg1_len, arg2_len;
    int argc = ZEND_NUM_ARGS();
    if(zend_parse_parameters(argc TSRMLS_CC, "ss", &arg1, &arg1_len, &arg2, &arg2_len) == FAILURE)
        return;
    std::string a = std::string(arg1);
    std::string b = std::string(arg2);
    std::string res = hello_joint(a, b);
    RETURN_STRING(res.c_str(), res.length());
}

  完成这些步骤之后,剩下的工作就少多了。

 

要接下去做其他步骤的话,建议先做两个拷贝动作:
  1,新建lib文件夹,将之前制作的libhello.a拷贝到lib里;
  2,新建include文件夹(也可以等到./configure的时候,它会帮你创建这个文件夹),将hello.h头文件拷贝到这里。

利用php工具,按顺序运行如下四个命令:

phpize
./configure
make
make install

  注:如果中间修改了程序代码什么的,记得要从第一个phpize重新执行来过。

  运行正常的话,january.so会安装到.../lib/php/extensions/no-debug-non-zts-20131226/目录下。

 

最后,需要加载january.so,主要是改配置php.ini。如果不知道这个文件在哪的话,你可以在php程序中输出(echo phpinfo())。

echo phpinfo()的输出,可以看到指明了php.ini的所在目录。
Virtual Directory Support => disabled
Configuration File (php.ini) Path => /usr/local/etc/php/5.6
Loaded Configuration File => /usr/local/etc/php/5.6/php.ini

  首先,找到enable_dl,改为On;

enable_dl = On         --在php.ini 中开启php动态加载dl

  再找到有很多extension=xxxxxx.so的地方,添加下面句子,加载动态库,当然也可以在程序中手动加载。

extension=january.so  

  在php程序中测试:

echo january_say("hello ", "world!");

  输出:

hello world!

 

结语

  快过年了,都不能静心的好好写博客了(真的是水平不够,经验有限的极好借口\(^o^)/~),如果有错误的地方,欢迎指正。

  同时,刚开始做的时候,可能会碰到这样那样的问题,希望你最终能顺利完成!当然,如果这篇博客能对你有一点点帮助的话,就更好了.

PHP扩展调用C++静态库