Per Aaron, fix for r108274: added canUseWikiPage() to context objects to know whether getWikiPage() can be safely called

1 files changed, 14 insertions, 1 deletions

diff --git a/includes/context/IContextSource.php b/includes/context/IContextSource.php
index ed7aba03594f..476035b525ee 100644
--- a/includes/context/IContextSource.php
+++ b/includes/context/IContextSource.php
@@ -43,7 +43,20 @@ interface IContextSource {
 	public function getTitle();
 
 	/**
-	 * Get the WikiPage object
+	 * Check whether a WikiPage object can be get with getWikiPage().
+	 * Callers should expect that an exception is thrown from getWikiPage()
+	 * if this method returns false.
+	 *
+	 * @since 1.19
+	 * @return bool
+	 */
+	public function canUseWikiPage();
+
+	/**
+	 * Get the WikiPage object.
+	 * May throw an exception if there's no Title object set or the Title object
+	 * belongs to a special namespace that doesn't have WikiPage, so use first
+	 * canUseWikiPage() to check whether this method can be called safely.
 	 *
 	 * @since 1.19
 	 * @return WikiPage