Phpstan: fixed return types (docs only)

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Edit/Tab/Super/Config/Grid/Filter/Inventory.php

@@ -28,6 +28,9 @@
  */
 class Mage_Adminhtml_Block_Catalog_Product_Edit_Tab_Super_Config_Grid_Filter_Inventory extends Mage_Adminhtml_Block_Widget_Grid_Column_Filter_Select
 {
+    /**
+     * @return array
+     */
     protected function _getOptions()
     {
         return [

app/code/core/Mage/Adminhtml/Block/Catalog/Product/Helper/Form/Price.php

@@ -28,12 +28,19 @@
  */
 class Mage_Adminhtml_Block_Catalog_Product_Helper_Form_Price extends Varien_Data_Form_Element_Text
 {
+    /**
+     * @param array $attributes
+     */
     public function __construct($attributes= [])
     {
         parent::__construct($attributes);
         $this->addClass('validate-zero-or-greater');
     }
 
+    /**
+     * @return string
+     * @throws Mage_Core_Model_Store_Exception
+     */
     public function getAfterElementHtml()
     {
         $html = parent::getAfterElementHtml();
@@ -61,13 +68,21 @@ public function getAfterElementHtml()
         return $html;
     }
 
+    /**
+     * @param $attribute
+     * @return string
+     */
     protected function _getTaxObservingCode($attribute)
     {
         $spanId = "dynamic-tax-{$attribute->getAttributeCode()}";
 
         return "<script type='text/javascript'>if (dynamicTaxes == undefined) var dynamicTaxes = new Array(); dynamicTaxes[dynamicTaxes.length]='{$attribute->getAttributeCode()}'</script>";
     }
 
+    /**
+     * @param null $index
+     * @return string|null
+     */
     public function getEscapedValue($index=null)
     {
         $value = $this->getValue();

app/code/core/Mage/Adminhtml/Block/Customer/Edit/Tab/Newsletter/Grid/Filter/Status.php

@@ -43,6 +43,9 @@ public function __construct()
         parent::__construct();
     }
 
+    /**
+     * @return array
+     */
     protected function _getOptions()
     {
         $result = [];
@@ -53,9 +56,12 @@ protected function _getOptions()
         return $result;
     }
 
+    /**
+     * @return array|null
+     */
     public function getCondition()
     {
-        if(is_null($this->getValue())) {
+        if (is_null($this->getValue())) {
             return null;
         }
 

app/code/core/Mage/Adminhtml/Block/Customer/Edit/Tab/View.php

@@ -26,14 +26,18 @@
  * @package    Mage_Adminhtml
  * @author     Magento Core Team <core@magentocommerce.com>
  */
-class Mage_Adminhtml_Block_Customer_Edit_Tab_View
- extends Mage_Adminhtml_Block_Template
- implements Mage_Adminhtml_Block_Widget_Tab_Interface
+class Mage_Adminhtml_Block_Customer_Edit_Tab_View extends Mage_Adminhtml_Block_Template implements Mage_Adminhtml_Block_Widget_Tab_Interface
 {
+    /**
+     * @var Mage_Customer_Model_Customer
+     */
     protected $_customer;
 
     protected $_customerLog;
 
+    /**
+     * @return Mage_Customer_Model_Customer
+     */
     public function getCustomer()
     {
         if (!$this->_customer) {
@@ -42,6 +46,9 @@ public function getCustomer()
         return $this->_customer;
     }
 
+    /**
+     * @return string|void
+     */
     public function getGroupName()
     {
         if ($groupId = $this->getCustomer()->getGroupId()) {
@@ -68,20 +75,26 @@ public function getCustomerLog()
     /**
      * Get customer creation date
      *
-     * @return string
+     * @return string|null
      */
     public function getCreateDate()
     {
-        if ( ! $this->getCustomer()->getCreatedAt()) {
+        if (! $this->getCustomer()->getCreatedAt()) {
             return null;
         }
-        return $this->_getCoreHelper()->formatDate($this->getCustomer()->getCreatedAt(),
-            Mage_Core_Model_Locale::FORMAT_TYPE_MEDIUM, true);
+        return $this->_getCoreHelper()->formatDate(
+            $this->getCustomer()->getCreatedAt(),
+            Mage_Core_Model_Locale::FORMAT_TYPE_MEDIUM,
+            true
+        );
     }
 
+    /**
+     * @return string|null
+     */
     public function getStoreCreateDate()
     {
-        if ( ! $this->getCustomer()->getCreatedAt()) {
+        if (! $this->getCustomer()->getCreatedAt()) {
             return null;
         }
         $date = Mage::app()->getLocale()->storeDate(
@@ -112,6 +125,9 @@ public function getLastLoginDate()
         return Mage::helper('customer')->__('Never');
     }
 
+    /**
+     * @return string
+     */
     public function getStoreLastLoginDate()
     {
         if ($date = $this->getCustomerLog()->getLoginAtTimestamp()) {
@@ -131,6 +147,9 @@ public function getStoreLastLoginDateTimezone()
             ->getConfig(Mage_Core_Model_Locale::XML_PATH_DEFAULT_TIMEZONE);
     }
 
+    /**
+     * @return string
+     */
     public function getCurrentStatus()
     {
         $log = $this->getCustomerLog();
@@ -142,6 +161,9 @@ public function getCurrentStatus()
         return Mage::helper('customer')->__('Online');
     }
 
+    /**
+     * @return string
+     */
     public function getIsConfirmedStatus()
     {
         $this->getCustomer();
@@ -164,38 +186,55 @@ public function getStoreId()
         return $this->getCustomer()->getStoreId();
     }
 
+    /**
+     * @return string
+     */
     public function getBillingAddressHtml()
     {
         $html = '';
         if ($address = $this->getCustomer()->getPrimaryBillingAddress()) {
             $html = $address->format('html');
-        }
-        else {
+        } else {
             $html = Mage::helper('customer')->__('The customer does not have default billing address.');
         }
         return $html;
     }
 
+    /**
+     * @return string
+     */
     public function getAccordionHtml()
     {
         return $this->getChildHtml('accordion');
     }
 
+    /**
+     * @return string
+     */
     public function getSalesHtml()
     {
         return $this->getChildHtml('sales');
     }
 
+    /**
+     * @return string
+     */
     public function getTabLabel()
     {
         return Mage::helper('customer')->__('Customer View');
     }
 
+    /**
+     * @return string
+     */
     public function getTabTitle()
     {
         return Mage::helper('customer')->__('Customer View');
     }
 
+    /**
+     * @return bool
+     */
     public function canShowTab()
     {
         if (Mage::registry('current_customer')->getId()) {
@@ -204,6 +243,9 @@ public function canShowTab()
         return false;
     }
 
+    /**
+     * @return bool
+     */
     public function isHidden()
     {
         if (Mage::registry('current_customer')->getId()) {

app/code/core/Mage/Adminhtml/Block/Customer/Form/Element/File.php

@@ -188,8 +188,8 @@ protected function _drawElementHtml($element, array $attributes, $closed = true)
     /**
      * Return escaped value
      *
-     * @param int $index
-     * @return string
+     * @param string|null $index
+     * @return false|string
      */
     public function getEscapedValue($index = null)
     {

app/code/core/Mage/Adminhtml/Block/Customer/Form/Element/Image.php

@@ -80,7 +80,7 @@ protected function _getPreviewHtml()
 
     /**
      * Return Image URL
-     * @return string
+     * @return string|false
      */
     protected function _getPreviewUrl()
     {

app/code/core/Mage/Adminhtml/Block/Newsletter/Subscriber/Grid/Filter/Website.php

@@ -28,18 +28,28 @@
  */
 class Mage_Adminhtml_Block_Newsletter_Subscriber_Grid_Filter_Website extends Mage_Adminhtml_Block_Widget_Grid_Column_Filter_Select
 {
+    /**
+     * @var Mage_Core_Model_Resource_Website_Collection
+     */
     protected $_websiteCollection = null;
 
+    /**
+     * @return array[]
+     */
     protected function _getOptions()
     {
         $result = $this->getCollection()->toOptionArray();
         array_unshift($result, ['label'=>null, 'value'=>null]);
         return $result;
     }
 
+    /**
+     * @return Mage_Core_Model_Resource_Website_Collection
+     * @throws Mage_Core_Exception
+     */
     public function getCollection()
     {
-        if(is_null($this->_websiteCollection)) {
+        if (is_null($this->_websiteCollection)) {
             $this->_websiteCollection = Mage::getResourceModel('core/website_collection')
                 ->load();
         }
@@ -49,11 +59,14 @@ public function getCollection()
         return $this->_websiteCollection;
     }
 
+    /**
+     * @return array|null
+     * @throws Mage_Core_Exception
+     */
     public function getCondition()
     {
-
         $id = $this->getValue();
-        if(!$id) {
+        if (!$id) {
             return null;
         }
 

app/code/core/Mage/Adminhtml/Block/Review/Grid/Filter/Type.php

@@ -28,6 +28,9 @@
  */
 class Mage_Adminhtml_Block_Review_Grid_Filter_Type extends Mage_Adminhtml_Block_Widget_Grid_Column_Filter_Select
 {
+    /**
+     * @return array
+     */
     protected function _getOptions()
     {
         return [
@@ -38,6 +41,9 @@ protected function _getOptions()
         ];
     }
 
+    /**
+     * @return int
+     */
     public function getCondition()
     {
         if ($this->getValue() == 1) {