Extension:PhpTags

From MediaWiki.org
Jump to navigation Jump to search

Other languages:
English • ‎dansk • ‎español • ‎français • ‎polski • ‎português do Brasil • ‎русский • ‎中文 • ‎日本語
MediaWiki extensions manual
OOjs UI icon advanced.svg
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+
Database changes No
License GNU General Public License 2.0 or later
Download
Example test.foxway.org
  • $wgPhpTagsMaxLoops
  • $wgPhpTagsNamespaces
  • $wgPhpTagsBytecodeExptime
phptag
Translate the PhpTags extension if it is available at translatewiki.net
Check usage and version matrix.
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!!! 

Demo

the function ucfirst is implemented in Extension:PhpTags_Functions. More details can be found in the quick start guide.

Installation[edit]

  • If using Vagrant , install with vagrant roles enable phptags --provision
Manual installation
  • Download and place the file(s) in a directory called PhpTags in your extensions/ folder.
  • Add the following code at the bottom of your LocalSettings.php:
    require_once "$IP/extensions/PhpTags/PhpTags.php";
    
  • Yes Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.

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)