mirror of
https://github.com/php/php-src.git
synced 2026-04-15 03:51:07 +02:00
447b41f6bb
The `.deps` file(s) was once used by Automake and created to write
dependencies to it. The file creation has been removed via the commit
779c11af21.
The phpize and ./configure script create a redundant .deps file in a
PECL extension directory which might cause confusions why is it used.
Today it is no longer relevant so this redundant artefact can be
removed in the phpize configure script.
332 lines
8.4 KiB
Bash
Executable File
332 lines
8.4 KiB
Bash
Executable File
#!/bin/sh
|
|
|
|
givup() {
|
|
echo $*
|
|
exit 1
|
|
}
|
|
|
|
usage() {
|
|
echo "$0 --extname=module [--proto=file] [--stubs=file] [--xml[=file]]"
|
|
echo " [--skel=dir] [--full-xml] [--no-help]"
|
|
echo ""
|
|
echo " --extname=module module is the name of your extension"
|
|
echo " --proto=file file contains prototypes of functions to create"
|
|
echo " --stubs=file generate only function stubs in file"
|
|
echo " --xml generate xml documentation to be added to phpdoc-svn"
|
|
echo " --skel=dir path to the skeleton directory"
|
|
echo " --full-xml generate xml documentation for a self-contained extension"
|
|
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"
|
|
exit 1
|
|
}
|
|
|
|
if test $# = 0; then
|
|
usage
|
|
fi
|
|
|
|
while test $# -gt 0; do
|
|
case "$1" in
|
|
-*=*) optarg=`echo "$1" | sed 's/[-_a-zA-Z0-9]*=//'` ;;
|
|
*) optarg= ;;
|
|
esac
|
|
|
|
case $1 in
|
|
--extname=?*)
|
|
extname=$optarg
|
|
EXTNAME=`echo $extname | tr "[:lower:]" "[:upper:]"`
|
|
;;
|
|
--proto=?*)
|
|
proto=$optarg
|
|
;;
|
|
--stubs=*)
|
|
stubs=yes
|
|
stubfile=$optarg
|
|
;;
|
|
--xml)
|
|
xml="yes"
|
|
;;
|
|
--xml=?*)
|
|
xml=$optarg
|
|
;;
|
|
--full-xml)
|
|
full_xml="yes"
|
|
;;
|
|
--no-help)
|
|
no_help="yes"
|
|
;;
|
|
--skel=?*)
|
|
skel_dir=$optarg
|
|
;;
|
|
*)
|
|
usage
|
|
;;
|
|
esac
|
|
shift
|
|
done
|
|
|
|
if test -d "$extname" ; then
|
|
givup "Directory $extname already exists."
|
|
fi
|
|
|
|
if test -z "$skel_dir"; then
|
|
skel_dir="skeleton"
|
|
fi
|
|
|
|
## convert skel_dir to full path
|
|
skel_dir=`cd $skel_dir && pwd`
|
|
|
|
test -d $skel_dir || givup "directory $skel_dir does not exist or is not directory"
|
|
|
|
if echo '\c' | grep -s c >/dev/null 2>&1
|
|
then
|
|
ECHO_N="echo -n"
|
|
ECHO_C=""
|
|
else
|
|
ECHO_N="echo"
|
|
ECHO_C='\c'
|
|
fi
|
|
|
|
if test -z "$stubs"; then
|
|
echo "Creating directory $extname"
|
|
stubfile=$extname"/function_stubs"
|
|
mkdir $extname || givup "Cannot create directory $extname"
|
|
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
|
|
fi
|
|
|
|
if test -z "$stubs"; then
|
|
cd $extname
|
|
chmod 755 .
|
|
|
|
$ECHO_N "Creating basic files:$ECHO_C"
|
|
|
|
$ECHO_N " config.m4$ECHO_C"
|
|
cat >config.m4 <<eof
|
|
dnl \$Id\$
|
|
dnl config.m4 for extension $extname
|
|
|
|
dnl Comments in this file start with the string 'dnl'.
|
|
dnl Remove where necessary. This file will not work
|
|
dnl without editing.
|
|
|
|
dnl If your extension references something external, use with:
|
|
|
|
dnl PHP_ARG_WITH($extname, for $extname support,
|
|
dnl Make sure that the comment is aligned:
|
|
dnl [ --with-$extname Include $extname support])
|
|
|
|
dnl Otherwise use enable:
|
|
|
|
PHP_ARG_ENABLE($extname, whether to enable $extname support,
|
|
dnl Make sure that the comment is aligned:
|
|
[ --enable-$extname Enable $extname support])
|
|
|
|
if test "\$PHP_$EXTNAME" != "no"; then
|
|
dnl Write more examples of tests here...
|
|
|
|
dnl # --with-$extname -> check with-path
|
|
dnl SEARCH_PATH="/usr/local /usr" # you might want to change this
|
|
dnl SEARCH_FOR="/include/$extname.h" # you most likely want to change this
|
|
dnl if test -r \$PHP_$EXTNAME/\$SEARCH_FOR; then # path given as parameter
|
|
dnl ${EXTNAME}_DIR=\$PHP_$EXTNAME
|
|
dnl else # search default path list
|
|
dnl AC_MSG_CHECKING([for $extname files in default path])
|
|
dnl for i in \$SEARCH_PATH ; do
|
|
dnl if test -r \$i/\$SEARCH_FOR; then
|
|
dnl ${EXTNAME}_DIR=\$i
|
|
dnl AC_MSG_RESULT(found in \$i)
|
|
dnl fi
|
|
dnl done
|
|
dnl fi
|
|
dnl
|
|
dnl if test -z "\$${EXTNAME}_DIR"; then
|
|
dnl AC_MSG_RESULT([not found])
|
|
dnl AC_MSG_ERROR([Please reinstall the $extname distribution])
|
|
dnl fi
|
|
|
|
dnl # --with-$extname -> add include path
|
|
dnl PHP_ADD_INCLUDE(\$${EXTNAME}_DIR/include)
|
|
|
|
dnl # --with-$extname -> check for lib and symbol presence
|
|
dnl LIBNAME=$extname # you may want to change this
|
|
dnl LIBSYMBOL=$extname # you most likely want to change this
|
|
|
|
dnl PHP_CHECK_LIBRARY(\$LIBNAME,\$LIBSYMBOL,
|
|
dnl [
|
|
dnl PHP_ADD_LIBRARY_WITH_PATH(\$LIBNAME, \$${EXTNAME}_DIR/\$PHP_LIBDIR, ${EXTNAME}_SHARED_LIBADD)
|
|
dnl AC_DEFINE(HAVE_${EXTNAME}LIB,1,[ ])
|
|
dnl ],[
|
|
dnl AC_MSG_ERROR([wrong $extname lib version or lib not found])
|
|
dnl ],[
|
|
dnl -L\$${EXTNAME}_DIR/\$PHP_LIBDIR -lm
|
|
dnl ])
|
|
dnl
|
|
dnl PHP_SUBST(${EXTNAME}_SHARED_LIBADD)
|
|
|
|
PHP_NEW_EXTENSION($extname, $extname.c, \$ext_shared,, -DZEND_ENABLE_STATIC_TSRMLS_CACHE=1)
|
|
fi
|
|
eof
|
|
|
|
$ECHO_N " config.w32$ECHO_C"
|
|
cat >config.w32 <<eof
|
|
// \$Id\$
|
|
// vim:ft=javascript
|
|
|
|
// If your extension references something external, use ARG_WITH
|
|
// ARG_WITH("$extname", "for $extname support", "no");
|
|
|
|
// Otherwise, use ARG_ENABLE
|
|
ARG_ENABLE("$extname", "enable $extname support", "no");
|
|
|
|
if (PHP_$EXTNAME != "no") {
|
|
EXTENSION("$extname", "$extname.c", PHP_EXTNAME_SHARED, "/DZEND_ENABLE_STATIC_TSRMLS_CACHE=1");
|
|
}
|
|
|
|
eof
|
|
|
|
$ECHO_N " .gitignore$ECHO_C"
|
|
cat >.gitignore <<eof
|
|
*.lo
|
|
*.la
|
|
.libs
|
|
acinclude.m4
|
|
aclocal.m4
|
|
autom4te.cache
|
|
build
|
|
config.guess
|
|
config.h
|
|
config.h.in
|
|
config.log
|
|
config.nice
|
|
config.status
|
|
config.sub
|
|
configure
|
|
configure.in
|
|
include
|
|
install-sh
|
|
libtool
|
|
ltmain.sh
|
|
Makefile
|
|
Makefile.fragments
|
|
Makefile.global
|
|
Makefile.objects
|
|
missing
|
|
mkinstalldirs
|
|
modules
|
|
run-tests.php
|
|
tests/*/*.diff
|
|
tests/*/*.out
|
|
tests/*/*.php
|
|
tests/*/*.exp
|
|
tests/*/*.log
|
|
tests/*/*.sh
|
|
eof
|
|
|
|
$ECHO_N " $extname.c$ECHO_C"
|
|
echo "s/extname/$extname/g" > sedscript
|
|
echo "s/EXTNAME/$EXTNAME/g" >> sedscript
|
|
echo '/__function_entries_here__/r function_entries' >> sedscript
|
|
echo '/__function_stubs_here__/r function_stubs' >> sedscript
|
|
echo '/__header_here__/r ../../header' >> sedscript
|
|
echo '/__footer_here__/r ../../footer' >> sedscript
|
|
echo '/__function_entries_here__/D' >> sedscript
|
|
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
|
|
echo 's/[[:space:]]\/\*.\+\*\///' >> sedscript
|
|
echo 's/^\/\*.*\*\/$//' >> sedscript
|
|
echo '/^[[:space:]]*\/\*/,/^[[:space:]]*\*\//D' >> sedscript
|
|
fi
|
|
|
|
sed -f sedscript < $skel_dir/skeleton.c > $extname.c
|
|
|
|
|
|
$ECHO_N " php_$extname.h$ECHO_C"
|
|
echo "s/extname/$extname/g" > sedscript
|
|
echo "s/EXTNAME/$EXTNAME/g" >> sedscript
|
|
echo '/__function_declarations_here__/r function_declarations' >> sedscript
|
|
echo '/__header_here__/r ../../header' >> sedscript
|
|
echo '/__footer_here__/r ../../footer' >> sedscript
|
|
echo '/__function_declarations_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 's/[[:space:]]\/\*.\+\*\///' >> sedscript
|
|
echo 's/^\/\*.*\*\/$//' >> sedscript
|
|
echo '/^[[:space:]]*\/\*/,/^[[:space:]]*\*\//D' >> sedscript
|
|
fi
|
|
sed -f sedscript <$skel_dir/php_skeleton.h > php_$extname.h
|
|
|
|
$ECHO_N " CREDITS$ECHO_C"
|
|
echo "s/extname/$extname/g" > sedscript
|
|
sed -f sedscript <$skel_dir/CREDITS > CREDITS
|
|
|
|
$ECHO_N " EXPERIMENTAL$ECHO_C"
|
|
echo "s/extname/$extname/g" > sedscript
|
|
sed -f sedscript <$skel_dir/EXPERIMENTAL > EXPERIMENTAL
|
|
|
|
$ECHO_N " tests/001.phpt$ECHO_C"
|
|
mkdir tests || givup "Cannot create tests directory"
|
|
chmod 755 tests
|
|
sed -f sedscript <$skel_dir/tests/001.phpt > tests/001.phpt
|
|
|
|
if test -z "$stubs" && test -z "$no_help"; then
|
|
$ECHO_N " $extname.php$ECHO_C"
|
|
sed \
|
|
-e "s/extname/$extname/g" \
|
|
<$skel_dir/skeleton.php \
|
|
> $extname.php
|
|
fi
|
|
|
|
rm sedscript
|
|
|
|
if test -n "$proto"; then
|
|
if test -z "$stubs"; then
|
|
rm function_entries
|
|
rm function_declarations
|
|
rm function_stubs
|
|
fi
|
|
if test -f function_warning; then
|
|
rm function_warning
|
|
warning="
|
|
NOTE! Because some arguments to functions were resources, the code generated
|
|
cannot yet be compiled without editing. Please consider this to be step 4.5
|
|
in the instructions above.
|
|
"
|
|
fi
|
|
fi
|
|
|
|
find . -type f | xargs chmod 644
|
|
find . -type d | xargs chmod 755
|
|
fi
|
|
|
|
echo " [done]."
|
|
|
|
if test -z "$no_help" && test -z "$stubs"; then
|
|
cat <<eof
|
|
|
|
To use your new extension, you will have to execute the following steps:
|
|
|
|
1. $ cd ..
|
|
2. $ vi ext/$extname/config.m4
|
|
3. $ ./buildconf
|
|
4. $ ./configure --[with|enable]-$extname
|
|
5. $ make
|
|
6. $ ./sapi/cli/php -f ext/$extname/$extname.php
|
|
7. $ vi ext/$extname/$extname.c
|
|
8. $ make
|
|
|
|
Repeat steps 3-6 until you are satisfied with ext/$extname/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.
|
|
$warning
|
|
eof
|
|
fi
|