From: Ævar Arnfjörð Bjarmason <avar@users.mediawiki.org>
Date: Wed, 21 Dec 2005 00:12:10 +0000 (+0000)
Subject: * File to aid in writing extensions, see documentation
X-Git-Tag: 1.6.0~920
X-Git-Url: http://git.cyclocoop.org/url?a=commitdiff_plain;h=a7dca139624ca900ef9868c20ea5f7dac0b5592d;p=lhc%2Fweb%2Fwiklou.git

* File to aid in writing extensions, see documentation
---

diff --git a/includes/PersistentObject.php b/includes/PersistentObject.php
new file mode 100644
index 0000000000..5c53acde30
--- /dev/null
+++ b/includes/PersistentObject.php
@@ -0,0 +1,51 @@
+<?php
+if ( ! defined( 'MEDIAWIKI' ) )
+	die();
+/**
+ * Sometimes one wants to make an extension that defines a class that one wants
+ * to backreference somewhere else in the code, doing something like:
+ * <code>
+ * class Extension { ... }
+ * function myExtension() { new Extension; }
+ * </class>
+ *
+ * Won't work because PHP will destroy any reference to the initialized
+ * extension when the function goes out of scope, furthermore one might want to
+ * use some functions in the Extension class that won't exist by the time
+ * extensions get parsed which would mean lots of nasty workarounds to get
+ * around initialization and reference issues.
+ *
+ * This class allows one to write hir extension as:
+ *
+ * <code>
+ * function myExtension() {
+ *	class Extension { ... }
+ *	new PersistentObject( new Extension );
+ * }
+ * </code>
+ *
+ * The class will then not get parsed until everything is properly initialized
+ * and references to it won't get destroyed meaning that it's possible to do
+ * something like:
+ *
+ * <code>
+ * $wgParser->setHook( 'tag' , array( &$this, 'tagFunc' ) );
+ * </code>
+ *
+ * And have it work as expected
+ *
+ * @package MediaWiki
+ * @subpackage Extensions
+ *
+ * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
+ * @copyright Copyright © 2005, Ævar Arnfjörð Bjarmason
+ * @license http://www.gnu.org/copyleft/gpl.html GNU General Public License 2.0 or later
+ */
+
+$wgPersistentObjects = array();
+
+class PersistentObject {
+	function PersistentObject( &$obj ) {
+		$wgPersistentObjects[] = $obj;
+	}
+}