Attached is a patch to ext_skel that adds an optional argument (--cpp) that
will create a PHP extension in C++ rather than C. Also attached is
skeleton.cpp, which basically mirrors ext/skeleton/skeleton.c with a few
modifications for using C++. I could've just made some changes to
skeleton.c and done some sed work in the ext_skel script, but I think it's
clearer to have them separated into two files.
The ext_skel patch is based on the current HEAD.
Comments?
J
Index: ext_skel
===================================================================
RCS file: /repository/php4/ext/ext_skel,v
retrieving revision 1.44
diff -u -3 -p -r1.44 ext_skel
--- ext_skel 18 Nov 2002 15:55:07 -0000 1.44
+++ ext_skel 29 Nov 2002 18:20:40 -0000
@@ -7,7 +7,7 @@ givup() {
usage() {
echo "$0 --extname=module [--proto=file] [--stubs=file] [--xml[=file]]"
-echo " [--skel=dir] [--full-xml] [--no-help]"
+echo " [--skel=dir] [--full-xml] [--no-help] [--cpp]"
echo ""
echo " --extname=module module is the name of your extension"
echo " --proto=file file contains prototypes of functions to create"
@@ -18,6 +18,7 @@ echo " --full-xml generate xml
echo " (not yet implemented)"
echo " --no-help don't try to be nice and create comments in the code"
echo " and helper functions to test if the module compiled"
+echo " --cpp create a C++ extension"
exit 1
}
@@ -58,6 +59,9 @@ while test $# -gt 0; do
--skel=?*)
skel_dir=$optarg
;;
+ --cpp)
+ cpp="yes"
+ ;;
*)
usage
;;
@@ -94,7 +98,7 @@ if test -z "$stubs"; then
fi
if test -n "$proto"; then
- cat $proto | awk -v extname=$extname -v stubs=$stubs -v stubfile=$stubfile -v xml=$xml -v full_xml=$full_xml -v i_know_what_to_do_shut_up_i_dont_need_your_help_mode=$no_help -f $skel_dir/create_stubs
+ cat $proto | awk -v extname=$extname -v stubs=$stubs -v stubfile=$stubfile -v xml=$xml -v full_xml=$full_xml -v i_know_what_to_do_shut_up_i_dont_need_your_help_mode=$no_help -v cpp=$cpp -f $skel_dir/create_stubs
fi
if test -z "$stubs"; then
@@ -165,11 +169,16 @@ if test "\$PHP_$EXTNAME" != "no"; then
dnl ])
dnl
dnl PHP_SUBST(${EXTNAME}_SHARED_LIBADD)
+eof
- PHP_NEW_EXTENSION($extname, $extname.c, \$ext_shared)
+if test "$cpp" = "yes"; then
+ echo " PHP_REQUIRE_CXX()" >>config.m4
+ echo " PHP_NEW_EXTENSION($extname, $extname.cpp, \$ext_shared)" >>config.m4
+else
+ echo " PHP_NEW_EXTENSION($extname, $extname.c, \$ext_shared)" >>config.m4
fi
-eof
+echo "fi" >>config.m4
$ECHO_N " .cvsignore$ECHO_C"
cat >.cvsignore <<eof
@@ -178,7 +187,11 @@ cat >.cvsignore <<eof
*.la
eof
-$ECHO_N " $extname.c$ECHO_C"
+if test "$cpp" = "yes"; then
+ $ECHO_N " $extname.cpp$ECHO_C"
+else
+ $ECHO_N " $extname.c$ECHO_C"
+fi
echo "s/extname/$extname/g" > sedscript
echo "s/EXTNAME/$EXTNAME/g" >> sedscript
echo '/__function_entries_here__/r function_entries' >> sedscript
@@ -189,6 +202,7 @@ echo '/__function_entries_here__/D' >>
echo '/__function_stubs_here__/D' >> sedscript
echo '/__header_here__/D' >> sedscript
echo '/__footer_here__/D' >> sedscript
+
if [ ! -z "$no_help" ]; then
echo "/confirm_$extname_compiled/D" >> sedscript
echo '/Remove the following/,/^\*\//D' >> sedscript
@@ -197,7 +211,11 @@ if [ ! -z "$no_help" ]; then
echo '/^[[:space:]]*\/\*/,/^[[:space:]]*\*\//D' >> sedscript
fi
-sed -f sedscript < $skel_dir/skeleton.c > $extname.c
+if test "$cpp" = "yes"; then
+ sed -f sedscript < $skel_dir/skeleton.cpp > $extname.cpp
+else
+ sed -f sedscript < $skel_dir/skeleton.c > $extname.c
+fi
$ECHO_N " php_$extname.h$ECHO_C"
@@ -273,7 +291,15 @@ To use your new extension, you will have
4. $ ./configure --[with|enable]-$extname
5. $ make
6. $ ./php -f ext/$extname/$extname.php
-7. $ vi ext/$extname/$extname.c
+eof
+
+ if test "$cpp" = "yes"; then
+ echo "7. $ vi ext/$extname/$extname.cpp"
+ else
+ echo "7. $ vi ext/$extname/$extname.c"
+ fi
+
+ cat <<eof
8. $ make
Repeat steps 3-6 until you are satisfied with ext/$extname/config.m4 and
/* __header_here__ */
#ifdef HAVE_CONFIG_H
#include "config.h"
#endif
extern "C" {
#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
}
#include "php_extname.h"
// C++ header...
#include <string>
using namespace std;
/* If you declare any globals in php_extname.h uncomment this:
ZEND_DECLARE_MODULE_GLOBALS(extname)
*/
/* True global resources - no need for thread safety here */
static int le_extname;
/* {{{ extname_functions[]
*
* Every user visible function must have an entry in extname_functions[].
*/
function_entry extname_functions[] = {
PHP_FE(confirm_extname_compiled, NULL) /* For testing, remove later. */
/* __function_entries_here__ */
{NULL, NULL, NULL} /* Must be the last line in extname_functions[] */
};
/* }}} */
/* {{{ extname_module_entry
*/
zend_module_entry extname_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
STANDARD_MODULE_HEADER,
#endif
"extname",
extname_functions,
PHP_MINIT(extname),
PHP_MSHUTDOWN(extname),
PHP_RINIT(extname), /* Replace with NULL if there's nothing to do at request start */
PHP_RSHUTDOWN(extname), /* Replace with NULL if there's nothing to do at request end */
PHP_MINFO(extname),
#if ZEND_MODULE_API_NO >= 20010901
"0.1", /* Replace with version number for your extension */
#endif
STANDARD_MODULE_PROPERTIES
};
/* }}} */
#ifdef COMPILE_DL_EXTNAME
BEGIN_EXTERN_C()
ZEND_GET_MODULE(extname)
END_EXTERN_C()
#endif
/* {{{ PHP_INI
*/
/* Remove comments and fill if you need to have entries in php.ini
PHP_INI_BEGIN()
STD_PHP_INI_ENTRY("extname.global_value", "42", PHP_INI_ALL, OnUpdateInt, global_value, zend_extname_globals, extname_globals)
STD_PHP_INI_ENTRY("extname.global_string", "foobar", PHP_INI_ALL, OnUpdateString, global_string, zend_extname_globals, extname_globals)
PHP_INI_END()
*/
/* }}} */
/* {{{ php_extname_init_globals
*/
/* Uncomment this function if you have INI entries
static void php_extname_init_globals(zend_extname_globals *extname_globals)
{
extname_globals->global_value = 0;
extname_globals->global_string = NULL;
}
*/
/* }}} */
/* {{{ PHP_MINIT_FUNCTION
*/
PHP_MINIT_FUNCTION(extname)
{
/* If you have INI entries, uncomment these lines
ZEND_INIT_MODULE_GLOBALS(extname, php_extname_init_globals, NULL);
REGISTER_INI_ENTRIES();
*/
return SUCCESS;
}
/* }}} */
/* {{{ PHP_MSHUTDOWN_FUNCTION
*/
PHP_MSHUTDOWN_FUNCTION(extname)
{
/* uncomment this line if you have INI entries
UNREGISTER_INI_ENTRIES();
*/
return SUCCESS;
}
/* }}} */
/* Remove if there's nothing to do at request start */
/* {{{ PHP_RINIT_FUNCTION
*/
PHP_RINIT_FUNCTION(extname)
{
return SUCCESS;
}
/* }}} */
/* Remove if there's nothing to do at request end */
/* {{{ PHP_RSHUTDOWN_FUNCTION
*/
PHP_RSHUTDOWN_FUNCTION(extname)
{
return SUCCESS;
}
/* }}} */
/* {{{ PHP_MINFO_FUNCTION
*/
PHP_MINFO_FUNCTION(extname)
{
php_info_print_table_start();
php_info_print_table_header(2, "extname support", "enabled");
php_info_print_table_end();
/* Remove comments if you have entries in php.ini
DISPLAY_INI_ENTRIES();
*/
}
/* }}} */
/* A simple C++ class, just to demonstrate that C++ is indeed at work... */
class TestClass
{
public:
TestClass() { itsString = "I am a C++ class"; }
string getString() { return itsString; }
private:
string itsString;
};
/* Remove the following function when you have succesfully modified config.m4
so that your module can be compiled into PHP, it exists only for testing
purposes. */
/* Every user-visible function in PHP should document itself in the source */
/* {{{ proto string confirm_extname_compiled(string arg)
Return a string to confirm that the module is compiled in */
PHP_FUNCTION(confirm_extname_compiled)
{
char *arg = NULL;
int arg_len, len;
char str[256];
TestClass myClass;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &arg, &arg_len) == FAILURE) {
return;
}
len = sprintf(str, "Congratulations! You have successfully modified ext/%.78s/config.m4. Module %.78s is now compiled into PHP. Here is a string from a C++ object: %.78s", "extname", arg, myClass.getString().c_str());
RETURN_STRINGL(str, len, 1);
}
/* }}} */
/* The previous line is meant for vim and emacs, so it can correctly fold and
unfold functions in source code. See the corresponding marks just before
function definition, where the functions purpose is also documented. Please
follow this convention for the convenience of others editing your code.
*/
/* __function_stubs_here__ */
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* End:
* vim600: noet sw=4 ts=4 fdm=marker
* vim<600: noet sw=4 ts=4
*/
--
PHP Development Mailing List <http://www.php.net/>
To unsubscribe, visit: http://www.php.net/unsub.php
