Home » Tools and Utilities » CodeGen_PECL

Tool to generate PECL extensions from an XML description

This package is unmaintained.

Download latest release 1.1.3 (archived versions might be outdated)

License: PHP

Description

CodeGen_PECL (formerly known as PECL_Gen) is a pure PHP replacement
for the ext_skel shell script that comes with the PHP 4 source.
It reads in configuration options, function prototypes and code fragments
from an XML description file and generates a complete ready-to-compile
PECL extension.

Maintainers

• Hartmut Holzgraefe (hholzgra) — lead, active
• Rasmus Lerdorf (rasmus) — contributor, active
• Carsten Lucke (luckec) — contributor, active
• Pierre-Alain Joye (pajoye) — helper, active
• Johann Peter Hartmann (hartmann) — helper, active

Dependencies

Required

• PHP (>= 5)
• PEAR Installer (>= 1.4.0b1)
• PEAR (>= 1.2)
• CodeGen (>= 1.0.7)

Releases

• 1.1.3 (stable, 2010-09-27)
  Release notes

  License: PHP

  Changes since 1.1.2:
  - support "if" attribute in <constant>
  - changed generated docs to new docs structure
  - changed generated version information to match PECL proposal
  - pecl-gen script can now also be invoked on windows
  - passing array and mixed by reference now works
  - class constant registration now uses Zend API convenience functions
  - improved #line directive support (but still work in progress)

  Bug fixes:
  - Bug #13502 <maintainers> tag no longer works
  - Bug #13531 nested <group> tags confuse the XML parser
  - Bug #13639 "codeGen for zend_register_internal_class_ex not working"

• 1.1.2 (stable, 2008-03-04)
• 1.1.1 (stable, 2008-03-04)
  Release notes

  License: PHP

  Changes since 1.1.0:
  - added appropriate ZEND_ACC_... attributes for __construct/__destruct/__clone
  - implemented nested <group> tag support
  - add generic "unknown" author if none specified to ensure valid package.xml
  - fixed PROP_SET_STRING to actually use the stringl api function instead of the plain string one
  - fixed handling of optional parameters in prototypes

• 1.1.0 (stable, 2007-08-14)
  Release notes

  License: PHP

  Changes since 1.0.4:
  - new function prototype parser
  - added PHP version check to config.m4
  - functions accepting/returning resources or classes
  or using constants for default values now "inherit"
  conditional compilation settings from these elements
  - disabled output of AC_CHECK_TYPE checks for resource
  types due to autoconf version conflicts
  - varargs support

• 1.0.3 (stable, 2006-08-16)
  Release notes

  License: PHP

  Changes since 1.0.2:
  - fixed CodeGen dependency entry
  - disabled #line output by default

• 1.0.1 (stable, 2006-08-14)
  Release notes

  License: PHP

  Changes since 1.0.0:
  - now using codegen helper object for indent and code blocks
  - updated the DTD
  - added DOCTYPE specs to all examples
  - package.xml 1.0 OS dependencies generation fixed
  - some config.m4 generation stuff ended up in CodeGen, now moved back
  - added config.m4 checks for header files
  - added new interface CodeGen_PECL_Element_ObjectInterface for methods
  that can take both Classes and Interfaces as argument
  - fixed typo in class payload constructor code generation
  - allow :: in names when using C++ only
  - use PHP_MALIAS instead of PHP_FALIAS for methods
  - improved attribute checking in XML parser
  - pear channel support
  - pkg-config support in --with options
  - started support for arg_info and pass/return by reference (work in progress)

• 1.0.0 (stable, 2006-02-17)
  Release notes

  License: PHP

  1.0.0 stable release (finally)

• 1.0.0rc1 (beta, 2005-09-22)
  Release notes

  License: PHP

  I'm feature-complete for a 1.0 release now :)

  - object store support for private C/C++ data in objects

  - <lib> and <header> tags within <with>

  - interface and type hints support

  - added a lint option (-l) for syntax checking of spec files

  - write to tmpfiles first, only overwrite -> done
  existing files if actual changes are
  detected, preserve unchanged files
  (to make "make" happy)

  - changed names of variables generated for resource parameters,
  backwards compatibility is provided by checking the extension
  tags version attribute, for versions < 1.0.0dev the old naming
  stile is used

  - added test generation for class member functions

• 0.9.0 (beta, 2005-08-12)
  Release notes

  License: PHP

  Milestone 0.9
  -------------

  - copy <changelog> to generated package.xml - done

  - rewrite the function prototype parser
  - object type specification (as in resources) - done
  - default values - done
  - 'void' treatment - done
  - '...' not handled - done
  - array() as default value - done
  - code generation for 'pass by refecence' - for zval based types yet
  - '...' code generation - if first parameter yet

  FREE_RESOURCE macro - done

  allow defined PHP constants as default value - done

  <define> tag -> #define + <constant>? - done

  allow for embedded base64 or uu encoded logo specs - done

  changeable function prefix? - done

  trick parser to verbatim pass on docbook contentent - done

  add configure compile test for <resource> -done
  to check whether a given payload is a valid type?

  SYSTEM Entity and XInclude support - done

  support for multiple <with> tags with distinct
  names, name defaults to extension name if not given - done

  added version attribute to <extension>
  to control parser features (replaces -x switch) - done

  support <?code ... ?> as alternative to CDATA - done

  check whether <header> checks work - done

  test files are not yet added to package.xml - done

  documentation up to date for all 0.9 features - done

  examples and test cases added - done

• 0.9.0rc5 (beta, 2005-08-04)
  Release notes

  License: PHP

  - implemeted new proto parser, activate with --experimental

Bugs