X-Git-Url: https://git.toastfreeware.priv.at/toast/cookiecaptcha.git/blobdiff_plain/1bbd72e5fd08c28a5b1b72dca811ed84fe8ef470..e6592cce5c1fa3965d5a4d22b1209f25f32d7721:/CaptchaStore.php

diff --git a/CaptchaStore.php b/CaptchaStore.php
index b32d637..7b29e44 100644
--- a/CaptchaStore.php
+++ b/CaptchaStore.php
@@ -1,5 +1,63 @@
 <?php
-class CaptchaSessionStore {
+
+abstract class CaptchaStore {
+	/**
+	 * Store the correct answer for a given captcha
+	 * @param  $index String
+	 * @param  $info String the captcha result
+	 */
+	public abstract function store( $index, $info );
+
+	/**
+	 * Retrieve the answer for a given captcha
+	 * @param  $index String
+	 * @return String
+	 */
+	public abstract function retrieve( $index );
+
+	/**
+	 * Delete a result once the captcha has been used, so it cannot be reused
+	 * @param  $index
+	 */
+	public abstract function clear( $index );
+
+	/**
+	 * Whether this type of CaptchaStore needs cookies
+	 * @return Bool
+	 */
+	public abstract function cookiesNeeded();
+
+	/**
+	 * The singleton instance
+	 * @var CaptchaStore
+	 */
+	private static $instance;
+
+	/**
+	 * Get somewhere to store captcha data that will persist between requests
+	 *
+	 * @throws MWException
+	 * @return CaptchaStore
+	 */
+	public final static function get() {
+		if( !self::$instance instanceof self ){
+			global $wgCaptchaStorageClass;
+			if( in_array( 'CaptchaStore', class_parents( $wgCaptchaStorageClass ) ) ) {
+				self::$instance = new $wgCaptchaStorageClass;
+			} else {
+				throw new MWException( "Invalid CaptchaStore class $wgCaptchaStorageClass" );
+			}
+		}
+		return self::$instance;
+	}
+
+	/**
+	 * Protected constructor: no creating instances except through the factory method above
+	 */
+	protected function __construct(){}
+}
+
+class CaptchaSessionStore extends CaptchaStore {
 
 	function store( $index, $info ) {
 		$_SESSION['captcha' . $info['index']] = $info;
@@ -22,7 +80,7 @@ class CaptchaSessionStore {
 	}
 }
 
-class CaptchaCacheStore {
+class CaptchaCacheStore extends CaptchaStore {
 
 	function store( $index, $info ) {
 		global $wgMemc, $wgCaptchaSessionExpiration;