PHP开发第一个扩展

dnl $Id$  
dnl config.m4 for extension example  
PHP_ARG_WITH(example, for example support,  
[  --with-example[=FILE]       Include example support. File is the optional path to example-config])  
PHP_ARG_ENABLE(example-debug, whether to enable debugging support in example,  
[  --enable-example-debug        example: Enable debugging support in example], no, no)  
PHP_ARG_WITH(example-extra, for extra libraries for example,  
[  --with-example-extra=DIR      example: Location of extra libraries for example], no, no)  

dnl 检测扩展是否已启用  
if test "$PHP_EXAMPLE" != "no"; then  

dnl 检测 example-config。首先尝试所给出的路径，然后在 $PATH 中寻找  
AC_MSG_CHECKING([for example-config])  
EXAMPLE_CONFIG="example-config"  
if test "$PHP_EXAMPLE" != "yes"; then  
EXAMPLE_PATH=$PHP_EXAMPLE  
else  
EXAMPLE_PATH=`$php_shtool path $EXAMPLE_CONFIG`  
fi  

dnl 如果找到可用的 example-config，就使用它  
if test -f "$EXAMPLE_PATH" && test -x "$EXAMPLE_PATH" && $EXAMPLE_PATH --version > /dev/null 2>&1; then  
AC_MSG_RESULT([$EXAMPLE_PATH])  
EXAMPLE_LIB_NAME=`$EXAMPLE_PATH --libname`  
EXAMPLE_INCDIRS=`$EXAMPLE_PATH --incdirs`  
EXAMPLE_LIBS=`$EXAMPLE_PATH --libs`  
  
dnl 检测扩展库是否工作正常  
PHP_CHECK_LIBRARY($EXAMPLE_LIB_NAME, example_critical_function,  
[  
  dnl 添加所需的 include 目录  
  PHP_EVAL_INCLINE($EXAMPLE_INCDIRS)  
  dnl 添加所需的扩展库及扩展库所在目录  
  PHP_EVAL_LIBLINE($EXAMPLE_LIBS, EXAMPLE_SHARED_LIBADD)  
],[  
  dnl 跳出  
  AC_MSG_ERROR([example library not found. Check config.log for more information.])  
],[$EXAMPLE_LIBS]  
)  
else  
dnl 没有可用的 example-config，跳出  
AC_MSG_RESULT([not found])  
AC_MSG_ERROR([Please check your example installation.])  
fi  

dnl 检测是否启用调试  
if test "$PHP_EXAMPLE_DEBUG" != "no"; then  
dnl 是，则设置 C 语言宏指令  
AC_DEFINE(USE_EXAMPLE_DEBUG,1,[Include debugging support in example])  
fi  

dnl 检测额外的支持  
if test "$PHP_EXAMPLE_EXTRA" != "no"; then  
if test "$PHP_EXAMPLE_EXTRA" == "yes"; then  
  AC_MSG_ERROR([You must specify a path when using --with-example-extra])  
fi  
  
PHP_CHECK_LIBRARY(example-extra, example_critical_extra_function,  
[  
  dnl 添加所需路径  
  PHP_ADD_INCLUDE($PHP_EXAMPLE_EXTRA/include)  
  PHP_ADD_LIBRARY_WITH_PATH(example-extra, $PHP_EXAMPLE_EXTRA/lib, EXAMPLE_SHARED_LIBADD)  
  AC_DEFINE(HAVE_EXAMPLEEXTRALIB,1,[Whether example-extra support is present and requested])  
  EXAMPLE_SOURCES="$EXAMPLE_SOURCES example_extra.c"  
],[  
  AC_MSG_ERROR([example-extra lib not found. See config.log for more information.])  
],[-L$PHP_EXAMPLE_EXTRA/lib]  
)  
fi  

dnl 最后，将扩展及其所需文件等信息传给构建系统  
PHP_NEW_EXTENSION(example, example.c $EXAMPLE_SOURCES, $ext_shared)  
PHP_SUBST(EXAMPLE_SHARED_LIBADD)  
fi  

dnl PHP_ARG_ENABLE(hello_module, whether to enablehello_module support,
dnl Make sure that the comment is aligned:
dnl [　--enable-hello_module　　　　　 Enablehello_module support])
修改成
PHP_ARG_ENABLE(hello_module, whether to enablehello_module support,
dnl Make sure that the comment is aligned:
[　--enable-hello_module　　　　　 Enablehello_module support])

if test "$PHP_MY_MODULE" == "yes"; thendnl
      PHP_EXTENSION(hello_module, $ext_shared)
fi 

第一个参数是扩展的名称，和包含它的目录同名。 
第二个参数是做为扩展的一部分的所有源文件的列表，参见 PHP_ADD_BUILD_DIR() 以获取将在子目录中源文件添加到构建过程的相关信息。 
第三个参数总是 $ext_shared， 当为了 --with-example[=FILE] 而调用 PHP_ARG_WITH()时，由 configure 决定参数的值。 
第四个参数指定一个“SAPI 类”，仅用于专门需要 CGI 或 CLI SAPI 的扩展。其他情况下应留空。 
第五个参数指定了构建时要加入 CFLAGS 的标志列表。
第六个参数是一个布尔值，为 "yes" 时会强迫整个扩展使用 $CXX 代替 $CC 来构建。
第三个以后的所有参数都是可选的。最后，调用 PHP_SUBST() 来启用扩展的共享构建。

dnl $Id$  
dnl config.m4 for extension hello  
PHP_ARG_ENABLE(hello, whether to enable hello support,  
[  --enable-hello           Enable hello support])  
if test "$PHP_HELLO" != "no"; then  
PHP_NEW_EXTENSION(hello_module, hello_module.c, $ext_shared)  
fi  

它的内容为
string getstring(string str)

执行：
./ext_skel --extname=helloworld--proto=helloworld.skel

 1、.svnignore 当在SVN协作模式下开发时，默认使文件不被SVN识别。

2、EXPERIMENTAL 该文件用来标识并记录稳定版发布前的开发日志、敬告、提示等相关的信息。当正式发行时应该删除它。

3、config.w32 在Windows环境下用到的配置文件，通常是需要修改的。

4、config.m4 在linux/Unix环境下用到的配置文件，通常也是需要修改的。

5、phpext.c 默认包含基本的扩展示例源码，即，默认情况下，扩展的代码写到这里面。

6、php_phpext.h 扩展的源文件所包含的头文件，里面包含对函数的定义。

7、CREDITS 第一行写扩展的名字，第二行写参与者的名字，多个用逗号隔开。

8、phpext.php 一个用来较验扩展是否正常加载、工作的PHP文件，根据实际情况修改。

9、tests 文件夹内将默认存储与扩展Test相关的数据或文件。

dnl PHP_ARG_WITH(helloworld, for helloworldsupport,
dnl Make sure that the comment is aligned:
dnl [  --with-helloworld     Include helloworld support])

修改为

PHP_ARG_WITH(helloworld, for helloworld  support,
Make sure that the comment is aligned:
[  --with-helloworld     Include helloworld   support])

PHP_FUNCTION(getstring)
{
    char *str = NULL;
    int argc = ZEND_NUM_ARGS();
    int str_len;
    char *result;

    if (zend_parse_parameters(argc TSRMLS_CC, "s", &str, &str_len) == FAILURE)
        return;

    str_len = spprintf(&result, 0, "%s", str);
    RETURN_STRINGL(result, str_len, 0);
}

phpize
./configure --with-php-config=/usr/local/php/bin/php-config
make && make install

vim /usr/local/php/etc/php.ini
extension=helloworld.so #在php.ini文件最后增加这一行
service php-fpm restart #重启PHP服务