Extension:PhpTags

From mediawiki.org
MediaWiki extensions manual
PhpTags
Release status: beta
Implementation Tag , Parser function , Hook
Description Allows users to use the Magic expressions with PHP language syntax
Author(s) Pavel Astakhov (pastakhovtalk)
Latest version 5.5.0 (2015-11-20)
MediaWiki 1.25+
PHP 5.3+
License GNU General Public License 2.0 or later
Download
  • $wgPhpTagsMaxLoops
  • $wgPhpTagsNamespaces
  • $wgPhpTagsBytecodeExptime
phptag
Quarterly downloads 6 (Ranked 144th)
Translate the PhpTags extension if it is available at translatewiki.net
Issues Open tasks · Report a bug

The PhpTags extension implements the concept of Magic expressions with PHP language syntax that allows you to create and use compatible but not monolithic MediaWiki extensions, which greatly increases the convenience, flexibility and performance. More ...

Description[edit]

The PhpTags extension has its own the runtime environment PHP code which supports scalar types, arrays, variables, operators, control structures. It also supports constants, functions and objects but it does not implement any of them except for some language constructs.

When using a function, object or constant PhpTags calls corresponding extension. Therefore, a set of constants, functions, objects and actions that they produce only depend on additionally installed compatible extensions which can be found here.

PhpTags designed so to be as similar to native PHP, therefore you should have the illusion of direct execution PHP code although this never happens.

Usage[edit]

The code should be placed between the tags ‎<phptag> and ‎</phptag>. It can be located in any namespace if it is allowed by the variable $wgPhpTagsNamespaces.

<phptag>
$foo = 'hello world';
echo ucfirst( $foo . "!!!\n" );
</phptag>

It will display:

Hello world!!! 
the function ucfirst is implemented in Extension:PhpTags Functions . More details can be found in the quick start guide.

Installation[edit]

  • Download and move the extracted PhpTags folder to your extensions/ directory.
    Developers and code contributors should install the extension from Git instead, using:cd extensions/
    git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PhpTags
  • Add the following code at the bottom of your LocalSettings.php file:
    wfLoadExtension( 'PhpTags' );
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.


Vagrant installation:

  • If using Vagrant , install with vagrant roles enable phptags --provision


Optional installation[edit]

Additional installation[edit]

The PhpTags extension (core) implements magic expressions only and not, for instance, any PHP function.

For additional features such as functions, you can install additional extensions which are compatible with the magic expressions of the PhpTags extension.

The main extensions are:

Others are Extension:PhpTags SMW and Extension:PhpTags Storage .

Configuration parameters[edit]

Name Description Default
$wgPhpTagsMaxLoops Maximum number of allowed loops 1000
$wgPhpTagsNamespaces Array of namespaces in which the PhpTags extension is allowed to use. Boolean true allows usage in all namespaces true
$wgPhpTagsBytecodeExptime Storage time of the compiled bytecode in cache (30 days) 2592000 (30 days)