cfRegeX


Download cfRegex

Select an engine to see download and setup instructions.


Each CFML engine has its own download, with code tailored for it, so be sure to download the package corresponding to the CFML engine you use!

If you work on multiple engines, you will need to download the code for each one. Alternatively, you can download all of them in a single package.

A future release will hopefully provide a unified download (for the recent CFML engines), but this is not yet available.

Supported CFML Engines

cfRegex currently has about 240 unit tests, and a CFML engine must pass over 95% of these to be "supported", including complete success for essential functionality tests.

Where necessary, changes are made to the cfRegex code to allow an engine to pass (assuming the number of users justifies the effort required).

With the release of v0.1, cfRegex supports the CFML engines listed in the left hand column only.

Unsupported CFML Engines

Due to time constraints, cfRegex has not yet been ported to ColdFusion 8 and will not currently work with it, if there is demand, this will be done for the next release.

cfRegex has only been tested against ColdFusion 9.0.1 but not against 9.0.0 - it might work, but it wont be supported until I can verify the unit tests against a 9.0.0 setup.

cfRegex will partially work with Open BlueDragon 1.4, but there are bugs (reported, and fixed in 2.0) which prevent key features working, so it is not supported.

cfRegex has not yet been tested in Railo versions before 3.2 - but there are unlikely to be problems porting it to earlier versions, again - if there is demand for this.

Download cfRegex v0.1
for ColdFusion 9.0.1 and 10

Note: If there is demand, cfRegex v0.2 will have an automated installer for ColdFusion 9.0.1 and 10, however installation must currently be performed manually.

Tag and Object - Manual Setup

  1. Download the archive and extract to a temporary location.
  2. Locate your ColdFusion root directory, referred to as {coldfusion-root} below.
  3. Move Regex.cfc and regex.cfm to {coldfusion-root}/wwwroot/WEB-INF/cftags/
  4. Copy Regex.cfc to {coldfusion-root}/CustomTags/

You can now use the cfregex tag and create Regex objects.

Functions - Manual Setup

Unfortunately there is no way in CF to auto-include user-defined functions, so this must be done manually on each request. This is not ideal, but - unless there is a way I am unaware of, or if Adobe adds such functionality - there is no way to avoid it.

  1. Inside {coldfusion-root}/CustomTags create a cfregex-functions directory.
  2. Move all remaining .cfm files to {coldfusion-root}/CustomTags/cfregex-functions/
  3. Create a mapping /cfregex-functions to this directory.
  4. At the start of every request, do:
    <cfinclude template="/cfregex-functions/include-all.cfm" />

Now you can also use the functions!

Download cfRegex v0.1
for Open BlueDragon 2.0

Note: If there is demand, cfRegex v0.2 will have an automated installer for OpenBD, and might also be implemented as a plugin so it can be installed into the core, however at present installation must be performed manually, and the tag must be referenced as "cf_regex".

Tag and Object - Manual Setup

  1. Download the archive and extract to a temporary location.
  2. Locate your OpenBD WEB-INF directory (e.g. {openbd-root}/webapps/openbd/WEB-INF).
  3. Move Regex.cfc and regex.cfm to {openbd-root}/webapps/openbd/WEB-INF/CustomTags/

You can now use the cf_regex tag and create Regex objects.

Functions - Manual Setup

Unfortunately I have not yet created an OpenBD plugin, which will allow functions to be installed as core functions. In the meantime, it is necessary to include the functions manually on each request.

  1. Inside {openbd-root}/webapps/openbd/WEB-INF/CustomTags create a cfregex-functions directory.
  2. Move all remaining .cfm files to {openbd-root}/webapps/openbd/WEB-INF/CustomTags/cfregex-functions/
  3. Create a mapping /cfregex-functions to this directory.
  4. At the start of every request, do:
    <cfinclude template="/cfregex-functions/include-all.cfm" />

Now you can also use the functions!

Download cfRegex v0.1
for Railo 3.2.2 and above

Note: cfRegex v0.2 will be available as a Railo Extension, making it even easier to setup!

Manual Setup Instructions

  1. Download the archive and extract to a temporary location.
  2. Locate your {railo-server}/context/ directory (e.g. {railo-root}/lib/ext/railo-server/context). *
  3. Copy Regex.cfc to {railo-server}/context/components/ directory.
  4. Copy Regex.cfc to {railo-server}/context/library/tag/ directory.
  5. Copy Regex*.cfm to {railo-server}/context/library/function/ directory.
  6. Restart the Railo server.

You can now use the cfregex tag, create Regex objects, and use all the Regex~ functions as if they were built-in functions.

*For per-context installation (or, if you do not have a {railo-server}/context/components directory), in steps 3..5 above use the {railo-web} directory, that is {webroot}/WEB-INF/railo