Extension:WindowsAzureStorage

MediaWiki extensions manual

WindowsAzureStorage Release status: stable
Implementation	File repository
Description	Allows MediaWiki to use Windows Azure as the file backend
Author(s)	Thai Phan, Markus Glaser
Latest version	1.1.0 (2013-03-31)
MediaWiki	1.20+
License	GPL
Download	Download snapshot (Git master) Git [?]: repo summary browse file tree commit history
Translate the WindowsAzureStorage extension if it is available at translatewiki.net
Check usage and version matrix; code metrics

WindowsAzureStorage enables MediaWiki to store uploaded files to the Windows Azure Storage service.

Requirements

This extension needs to have the WindowsAzureSDK extension installed in order to work.

Download

The extension can be retrieved directly from Git ^[?]:

• Browse code
• Some extensions have tags for stable releases.
  • Browse tags
  • Select the tag
  • Click "snapshot"
• Each branch is associated with a past MediaWiki release. There is also a "master" branch containing the latest alpha version (might require an alpha version of MediaWiki).
  • Browse branches
  • Select a branch name
  • Click "Continue"

Extract the snapshot and place it in the extensions/WindowsAzureStorage/ directory of your MediaWiki installation.

If you are familiar with git and have shell access to your server, you can also obtain the extension as follows:

cd extensions/
git clone https://gerrit.wikimedia.org/r/p/mediawiki/extensions/WindowsAzureStorage.git

Installation

To install this extension, you will need to modify your LocalSettings.php.

Activation

Add the following line to LocalSettings.php and then check to see if it shows up in Special:Version.

require_once("$IP/extensions/WindowsAzureStorage/WindowsAzureStorage.php");

Configuration

Add the following to the end of LocalSettings.php to start using your Windows Azure Storage account as the file backend for your wiki. You will need to change your_azure_storage_account and your_azure_storage_account_key to the relevant values.

$wgFileBackends[] = array(
    'name'         => 'localAzure',
    'class'        => 'WindowsAzureFileBackend',
    'lockManager'  => 'nullLockManager',
    'azureAccount' => 'your_azure_storage_account',
    'azureKey'     => 'your_azure_storage_account_key'
);
 
$wgLocalFileRepo = array (
    'class'             => 'LocalRepo',
    'name'              => 'local',
    'backend'           => 'localAzure',
    'scriptDirUrl'      => $wgScriptPath,
    'scriptExtension'   => $wgScriptExtension,
    'url'               => $wgScriptPath . '/img_auth.php',
    'hashLevels'        => 0,
    'deletedHashLevels' => 0,
    'zones'             => array(
        'public'  => array( 'container' => 'public' ),
        'thumb'   => array( 'container' => 'thumb' ),
        'temp'    => array( 'container' => 'temp' ),
        'deleted' => array( 'container' => 'deleted' )
    )
);
 
$wgImgAuthPublicTest = false;