Extension:PhpTags

MediaWiki extensions manual

File:OOjs UI icon advanced-invert.svg PhpTags Release status: unmaintained
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	<translate> Download extension</translate> <translate> Git</translate> [?]: <translate> Download Git master</translate> <translate> browse repository</translate> (Phabricator · GitHub) <translate> commit history</translate> <translate> repository contributors (GitHub)</translate> <translate> code review</translate>
Parameters $wgPhpTagsMaxLoops $wgPhpTagsNamespaces $wgPhpTagsBytecodeExptime
Tags phptag
Hooks used ExtensionTypes ParserAfterTidy ParserFirstCallInit ParserLimitReport PhpTagsRuntimeFirstInit
Hooks provided PhpTagsBeforeCallRuntimeHook PhpTagsRuntimeFirstInit
Quarterly downloads
Public wikis using
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

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

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

• <translate> [[<tvar name=2>Special:ExtensionDistributor/PhpTags</tvar>|Download]] and move the extracted <tvar name=name>PhpTags</tvar> folder to your <tvar name=ext>extensions/</tvar> directory.</translate>
  <translate> Developers and code contributors should install the extension [[<tvar name=git>Special:MyLanguage/Download from Git</tvar>|from Git]] instead, using:</translate>cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/PhpTags
• <translate> Add the following code at the bottom of your <tvar name=1>LocalSettings.php </tvar> file:</translate>

  wfLoadExtension( 'PhpTags' );
  

• File:OOjs UI icon check-constructive.svg <translate> Done</translate> – <translate> Navigate to <tvar name=special>Special:Version</tvar> on your wiki to verify that the extension is successfully installed.</translate>

<translate> Vagrant installation:</translate>

• <translate> If using <tvar name=vagrant>Vagrant </tvar>, install with <tvar name=code>vagrant roles enable phptags --provision</tvar></translate>

Optional installation

• CodeMirror extension provides code highlighting in article editor

Additional installation

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:

• Extension:PhpTags Wiki - lets you query various data from MediaWiki core
• Extension:PhpTags Functions - contains many functions for data processing
• Extension:PhpTags Widgets - displays the data in different ways

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

Configuration parameters

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)