Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
The PHP Interpreter
C PHP C++ Shell JavaScript Makefile Other
branch: PHP-5.2

This branch is 49271 commits behind master

Failed to load latest commit information.
TSRM sed -i "s#1997-2009#1997-2010#g" **/*.c **/*.h **/*.php
Zend Fixed bug #54265 (crash when variable gets reassigned in error handler)
build - Update shtool to 2.0.8
ext
main back to dev
netware sed -i "s#1997-2009#1997-2010#g" **/*.c **/*.h **/*.php
pear Fixed bug#49578 (make install-pear fails)
regex MFH
sapi - Fixed bug #52162 (custom request header variables with numbers are …
scripts MFT: Fixed bug #52037 (Concurrent builds fail in install-programs) --…
tests - Fixed typo (reported by eyal.t at zend dot com)
win32 - add it to 5.2 too, cannot hurt and will spare some work later with …
.gdbinit - Added a function to print all CVs from the local scope.
CODING_STANDARDS Multi-branch test commit to see if email notifications are working
CREDITS Let's pretend this is up-to-date now
ChangeLog ChangeLog update
ChangeLog.1999.gz * separated and compressed changelogs from 1999 and 2000
ChangeLog.2000.gz * separated and compressed changelogs from 1999 and 2000
ChangeLog.2001.gz * archive the 2001 changelog
ChangeLog.2002.gz rotate changelog
ChangeLog.2003.gz - Compress 2003 changelog
ChangeLog.2004.gz - Compressed 2004 Changelog
EXTENSIONS Add myself as pdo_pgsql maintainer
INSTALL cvs->svn
LICENSE Update copyright year for the license
Makefile.frag - Allow build without flex/bison installed (fixes builddir != srcdir …
Makefile.gcov - Fixed bug #52019 (make lcov doesn't support TESTS variable anymore)
Makefile.global
NEWS Fixed bug #54265 (crash when variable gets reassigned in error handler)
README.EXTENSIONS * zend_module_entry change: apino, debug and zts are moved first,
README.EXT_SKEL
README.PARAMETER_PARSING_API - MFH: Fix type in example
README.PHP4-TO-PHP5-THIN-CHANGES new incompatibilities. maybe someone from the doc group will update the
README.QNX PHP 4.0
README.SELF-CONTAINED-EXTENSIONS Improve the wording in this paragraph.
README.STREAMS Added notes about locking functions.
README.SUBMITTING_PATCH cvs->svn
README.SVN-RULES MFH: cvs->svn
README.TESTING clarification of wwwhether 'make test' needs the PHP xecutable to be set
README.TESTING2 Fixed bug#46445 (run-tests2.php is missing or README.TESTING2 is unne…
README.UNIX-BUILD-SYSTEM Update documentation for PHP 5.
README.UPDATE_5_2 - add notice about glob regression (Lukas)
README.WIN32-BUILD-SYSTEM Now that it has matured somewhat, don't discourage questions about it
README.Zeus - Change from PHP5 -> PHP 5
README.input_filter Pierre requested an update to this. I don't think it makes sense to
TODO Removed completed TODO items
TODO-5.1 Slated for PHP 6
TODO-PHP5 Update TODO: filter extension was added
UPGRADING Multi-branch test commit to see if email notifications are working
acconfig.h.in Wipe out acconfig.h.in and rewrite some checks to use PHP_ARG_ENABLE.
acinclude.m4 - Fixed bug #51740 (acinclude.m4 macro PHP_CHECK_SIZEOF is not proper…
buildconf - Removed unused parts
buildconf.bat MFH:
config.guess - Upgraded bundled libtool to 1.5.26
config.sub - Upgraded bundled libtool to 1.5.26
configure.in back to dev
footer consistent with the used style
genfiles MFH
header
ltmain.sh - Upgraded bundled libtool to 1.5.26
makedist MFH: CVS->SVN
makerpm - Change from PHP5 -> PHP 5
php.gif fix logo (proper spacing between the letters)
php.ini-dist Fixed bug #52593 (exif is placed before mbstring in php.ini)
php.ini-recommended Fixed bug #52593 (exif is placed before mbstring in php.ini)
php5.spec.in - Renamed all *php4* files to *php5*, changed all php4/PHP4 to php5/PHP5
run-tests.php Loosen the valgrind version check slightly in run-tests.php so that i…
server-tests-config.php - MFH Fix filename
server-tests.php sed -i "s#1997-2009#1997-2010#g" **/*.c **/*.h **/*.php
snapshot Integration of -ng changes. Changes:
stamp-h.in # Fix ColorResolve bogosity
stub.c Add newline. Recent GCC snapshots segfault, if the input file is comp…
svnclean.bat - rename to svn
vcsclean MFH: dropped some more mime types, svnclean -> clean for multiple VCS

README.EXT_SKEL

(NOTE: you may also want to take a look at the pear package
	     PECL_Gen, a PHP-only alternative for this script that
			 supports way more extension writing tasks and is 
			 supposed to replace ext_skel completely in the long run ...)

WHAT IT IS

  It's a tool for automatically creating the basic framework for a PHP module
  and writing C code handling arguments passed to your functions from a simple
  configuration file. See an example at the end of this file.

HOW TO USE IT

  Very simple. First, change to the ext/ directory of the PHP 4 sources. If
  you just need the basic framework and will be writing all the code in your
  functions yourself, you can now do

   ./ext_skel --extname=module_name

  and everything you need is placed in directory module_name. 

  [ Note that GNU awk is likely required for this script to work.  Debian 
    systems seem to default to using mawk, so you may need to change the 
    #! line in skeleton/create_stubs and the cat $proto | awk line in
    ext_skel to use gawk explicitly. ]

  If you don't need to test the existence of any external header files, 
  libraries or functions in them, the module is already almost ready to be 
  compiled in PHP.  Just remove 3 comments in your_module_name/config.m4, 
  change back up to PHP sources top directory, and do

    ./buildconf; ./configure --enable-module_name; make

  But if you already have planned the overall scheme of your module, what
  functions it will contain, their return types and the arguments they take
  (a very good idea) and don't want to bother yourself with creating function
  definitions and handling arguments passed yourself, it's time to create a
  function definitions file, which you will give as an argument to ext_skel
  with option

    --proto=filename.

FORMAT OF FUNCTION DEFINITIONS FILE

  All the definitions must be on one line. In it's simplest form, it's just
  the function name, e.g.

    my_function

  but then you'll be left with an almost empty function body without any
  argument handling.

  Arguments are given in parenthesis after the function name, and are of
  the form 'argument_type argument_name'. Arguments are separated from each
  other with a comma and optional space. Argument_type can be one of int,
  bool, double, float, string, array, object or mixed.

  An optional argument is separated from the previous by an optional space,
  then '[' and of course comma and optional space, like all the other
  arguments. You should close a row of optional arguments with same amount of
  ']'s as there where '['s. Currently, it does not harm if you forget to do it
  or there is a wrong amount of ']'s, but this may change in the future.

	An additional short description may be added after the parameters. 
  If present it will be filled into the 'proto' header comments in the stubs
  code and the <refpurpose> tag in the XML documentation.

  An example:

    my_function(int arg1, int arg2 [, int arg3 [, int arg4]]) this is my 1st

  Arguments arg3 and arg4 are optional.

  If possible, the function definition should also contain it's return type
  in front of the definition. It's not actually used for any C code generating
  purposes but PHP in-source documentation instead, and as such, very useful.
  It can be any of int, double, string, bool, array, object, resource, mixed
  or void.

  The file must contain nothing else but function definitions, no comments or
  empty lines.

OTHER OPTIONS

    --no-help

  By default, ext_skel creates both comments in the source code and a test
  function to help first time module writers to get started and testing
  configuring and compiling their module. This option turns off all such things
  which may just annoy experienced PHP module coders. Especially useful with

    --stubs=file

  which will leave out also all module specific stuff and write just function
  stubs with function value declarations and passed argument handling, and
  function entries and definitions at the end of the file, for copying and
  pasting into an already existing module.

    --assign-params
    --string-lens

  By default, function proto 'void foo(string bar)' creates the following:
     ...
     zval **bar;
     ... (zend_get_parameters_ex() called in the middle...)
     convert_to_string_ex(bar);

  Specifying both of these options changes the generated code to:
     ...
     zval **bar_arg;
     int bar_len;
     char *bar = NULL;
     ... (zend_get_parameters_ex() called in the middle...)
     convert_to_string_ex(bar_arg);
     bar = Z_STRVAL_PP(bar_arg);
     bar_len = Z_STRLEN_PP(bar_arg);

  You shouldn't have to ask what happens if you leave --string-lens out. If you
  have to, it's questionable whether you should be reading this document.

    --with-xml[=file]

  Creates the basics for phpdoc .xml file.

    --full-xml

  Not implemented yet. When or if there will ever be created a framework for
  self-contained extensions to use phpdoc system for their documentation, this
  option enables it on the created xml file.

CURRENT LIMITATIONS, BUGS AND OTHER ODDITIES

  Only arguments of types int, bool, double, float, string and array are
  handled. For other types you must write the code yourself. And for type
  mixed, it wouldn't even be possible to write anything, because only you
  know what to expect.
  
  It can't handle correctly, and probably never will, variable list of
  of arguments. (void foo(int bar [, ...])

  Don't trust the generated code too much. It tries to be useful in most of
  the situations you might encounter, but automatic code generation will never
  beat a programmer who knows the real situation at hand. ext_skel is generally
  best suited for quickly generating a wrapper for c-library functions you
  might want to have available in PHP too.

  This program doesn't have a --help option. It has --no-help instead.

EXAMPLE

  The following _one_ line

  bool my_drawtext(resource image, string text, resource font, int x, int y [, int color])

  will create this function definition for you (note that there are a few
  question marks to be replaced by you, and you must of course add your own
  value definitions too):

/* {{{ proto bool my_drawtext(resource image, string text, resource font, int x, int y[, int color])
    */
PHP_FUNCTION(my_drawtext)
{
	zval **image, **text, **font, **x, **y, **color;
	int argc;
	int image_id = -1;
	int font_id = -1;

	argc = ZEND_NUM_ARGS();
	if (argc < 5 || argc > 6 || zend_get_parameters_ex(argc, &image, &text, &font, &x, &y, &color) == FAILURE) {
		WRONG_PARAM_COUNT;
	}

	ZEND_FETCH_RESOURCE(???, ???, image, image_id, "???", ???_rsrc_id);
	ZEND_FETCH_RESOURCE(???, ???, font, font_id, "???", ???_rsrc_id);

	switch (argc) {
		case 6:
			convert_to_long_ex(color);
			/* Fall-through. */
		case 5:
			convert_to_long_ex(y);
			convert_to_long_ex(x);
			/* font: fetching resources already handled. */
			convert_to_string_ex(text);
			/* image: fetching resources already handled. */
			break;
		default:
			WRONG_PARAM_COUNT;
	}

	php_error(E_WARNING, "my_drawtext: not yet implemented");
}
/* }}} */

Something went wrong with that request. Please try again.