{version:type}

Description

Returns information about the running ActionApps installation - its version, the SVN revision, or the PHP version. The optional type argument selects what to return: with no argument (or an unknown value) it returns the full descriptive string. Because the output reflects the live install (and the full form includes the visitor IP), it is never cached and is install- and request-dependent, not a fixed value. Typical use is a footer or an admin diagnostics line that shows which AA build is running.

Parameters

type optional default full

What to return. Omit it (or pass an unrecognised value) to get the full string. See the allowed values below.

Allowed values full = the full descriptive build string (default); aa = the ActionApps version only (e.g. 2026.5); svn = the SVN revision number as an integer; svn2 = the exact revision via svnversion (slower; may say Unversioned directory); php = the PHP version (e.g. 8.4.22).

Examples

virtual{version:aa}
Expected2026.5
Actual2026.5
The bare ActionApps version string. Changes with each release, so it is install-dependent (shown here as the value this install returned).
virtual{version}
ExpectedActionApps 2026.5 ($Date: 2026-06-02 13:11:20 +0200 (Tue, 02 Jun 2026) $, $Revision: 5261 $), PHP 8.4.22, REMOTE_ADDR:
ActualActionApps 2026.5 ($Date: 2026-06-02 13:11:20 +0200 (Tue, 02 Jun 2026) $, $Revision: 5261 $), PHP 8.4.22, REMOTE_ADDR: 216.73.217.87
With no type argument the default is full: the descriptive build string. It includes the SVN date and revision, the PHP version, and the visitor IP, so it varies by install and by request.
virtual{version:full}
ExpectedActionApps 2026.5 ($Date: 2026-06-02 13:11:20 +0200 (Tue, 02 Jun 2026) $, $Revision: 5261 $), PHP 8.4.22, REMOTE_ADDR:
ActualActionApps 2026.5 ($Date: 2026-06-02 13:11:20 +0200 (Tue, 02 Jun 2026) $, $Revision: 5261 $), PHP 8.4.22, REMOTE_ADDR: 216.73.217.87
Passing full explicitly is the same as the default. Any unrecognised type value also falls back to this full string.
virtual{version:php}
Expected8.4.22
Actual8.4.22
The PHP version running the server. Install-dependent.
virtual{version:svn}
Expected5261
Actual5261
The SVN revision number as an integer, parsed from the build string. Changes with each AA commit.
virtual{version:svn2}
ExpectedUnversioned directory
ActualUnversioned directory
svn2 asks the working copy directly via svnversion - more accurate for the whole tree but slower. On an install that is not a clean SVN checkout it returns a marker like Unversioned directory instead of a number.
virtualRunning ActionApps {version:aa} on PHP {version:php}
ExpectedRunning ActionApps 2026.5 on PHP 8.4.22
ActualRunning ActionApps 2026.5 on PHP 8.4.22
A common real-world use: a site footer or admin diagnostics line that names the build. Combine the bare aa version with php.
← All expressions