class SiteAuditCheckViewsCacheOutput in Site Audit 7

Class SiteAuditCheckViewsCacheOutput.

Hierarchy

• class \SiteAuditCheckAbstract
  • class \SiteAuditCheckViewsCacheOutput

File

Check/Views/CacheOutput.php, line 10

Contains \SiteAudit\Check\Views\CacheOutput.

class SiteAuditCheckViewsCacheOutput extends SiteAuditCheckAbstract {

  /**
   * Implements \SiteAudit\Check\Abstract\getLabel().
   */
  public function getLabel() {
    return dt('Rendered output caching');
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getDescription().
   */
  public function getDescription() {
    return dt('Check the length of time raw rendered output should be cached.');
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getResultFail().
   */
  public function getResultFail() {
    return dt('No View is caching rendered output!');
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getResultInfo().
   */
  public function getResultInfo() {
    return $this
      ->getResultWarn();
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getResultPass().
   */
  public function getResultPass() {
    if ($this->registry['views_cache_bully_output']) {
      return dt('Views Cache Bully is enforcing rendered output caching.');
    }
    return dt('Caching rendered output for all applicable Views.');
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getResultWarn().
   */
  public function getResultWarn() {
    return dt('The following Views are not caching rendered output: @views_without_output_caching', array(
      '@views_without_output_caching' => implode(', ', $this->registry['views_without_output_caching']),
    ));
  }

  /**
   * Implements \SiteAudit\Check\Abstract\getAction().
   */
  public function getAction() {
    if (!in_array($this->score, array(
      SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_INFO,
      SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_PASS,
    ))) {
      $ret_val = dt('Rendered output should be cached for as long as possible (if the query changes, the output will be refreshed).');
      if (drush_get_option('detail')) {
        $steps = array(
          dt('Go to /admin/structure/views/'),
          dt('Edit the View in question'),
          dt('Select the Display'),
          dt('Click Advanced'),
          dt('Next to Caching, click to edit.'),
          dt('Rendered output: (something other than Never cache)'),
        );
        if (drush_get_option('html') == TRUE) {
          $ret_val .= '<ol><li>' . implode('</li><li>', $steps) . '</li></ol>';
        }
        elseif (drush_get_option('json')) {
          $ret_val = array(
            'Summary' => $ret_val,
            'Steps' => $steps,
          );
        }
        else {
          foreach ($steps as $step) {
            $ret_val .= PHP_EOL;
            $ret_val .= str_repeat(' ', 8);
            $ret_val .= '- ' . $step;
          }
        }
      }
      return $ret_val;
    }
  }

  /**
   * Implements \SiteAudit\Check\Abstract\calculateScore().
   */
  public function calculateScore() {

    // Views Cache Bully.
    $this->registry['views_cache_bully_output'] = FALSE;
    if (module_exists('views_cache_bully') && variable_get('views_cache_bully_output_lifespan', 3600) > 0) {
      $this->registry['views_cache_bully_output'] = TRUE;
    }
    if ($this->registry['views_cache_bully_output']) {
      return SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_PASS;
    }
    $this->registry['output_lifespan'] = array();
    foreach ($this->registry['views'] as $view) {

      // Skip views used for administration purposes.
      if (isset($view->tag) && in_array($view->tag, array(
        'admin',
        'commerce',
      ))) {
        continue;
      }
      foreach ($view->display as $display_name => $display) {

        // Special case - Views Bulk Operations cannot be cached.
        // See https://www.drupal.org/node/1307360#comment-10882272 for details.
        $has_vbo = isset($display->display_options['fields']['views_bulk_operations']);
        if ((!isset($display->disabled) || !$display->disabled) && !$has_vbo) {

          // Default display OR overriding display.
          if (isset($display->display_options['cache'])) {
            if ($display->display_options['cache']['type'] == 'none' || $display->display_options['cache'] == '') {
              if ($display_name == 'default') {
                $this->registry['output_lifespan'][$view->name]['default'] = 'none';
              }
              else {
                $this->registry['output_lifespan'][$view->name]['displays'][$display_name] = 'none';
              }
            }
            else {
              if ($display->display_options['cache']['type'] == 'views_content_cache') {
                $lifespan = $display->display_options['cache']['output_min_lifespan'];
              }
              elseif ($display->display_options['cache']['output_lifespan'] == 'custom') {
                $lifespan = $display->display_options['cache']['output_lifespan_custom'];
              }
              else {
                $lifespan = $display->display_options['cache']['output_lifespan'];
              }

              // Normalize.
              if ($lifespan < 1) {
                $lifespan = 'none';
              }
              if ($display_name == 'default') {
                $this->registry['output_lifespan'][$view->name]['default'] = $lifespan;
              }
              else {
                $this->registry['output_lifespan'][$view->name]['displays'][$display_name] = $lifespan;
              }
            }
          }
          else {
            $this->registry['output_lifespan'][$view->name]['displays'][$display_name] = 'default';
          }
        }
      }
    }
    $this->registry['views_without_output_caching'] = array();
    foreach ($this->registry['output_lifespan'] as $view_name => $view_data) {

      // Views with only master display.
      if (!isset($view_data['displays']) || count($view_data['displays']) == 0) {
        if ($view_data['default'] == 'none') {
          $this->registry['views_without_output_caching'][] = $view_name;
        }
      }
      else {

        // If all the displays are default, consolidate.
        $all_default_displays = TRUE;
        foreach ($view_data['displays'] as $display_name => $lifespan) {
          if ($lifespan != 'default') {
            $all_default_displays = FALSE;
          }
        }
        if ($all_default_displays) {
          if ($view_data['default'] == 'none') {
            $this->registry['views_without_output_caching'][] = $view_name;
          }
        }
        else {
          $uncached_view_string = $view_name;
          $uncached_view_displays = array();
          foreach ($view_data['displays'] as $display_name => $display_data) {
            if ($display_data == 'none' || $display_data == 'default' && $view_data['default'] == 'none') {
              $uncached_view_displays[] = $display_name;
            }
          }
          if (!empty($uncached_view_displays)) {
            $uncached_view_string .= ' (' . implode(', ', $uncached_view_displays) . ')';
            $this->registry['views_without_output_caching'][] = $uncached_view_string;
          }
        }
      }
    }
    if (count($this->registry['views_without_output_caching']) == 0) {
      return SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_PASS;
    }
    if (site_audit_env_is_dev()) {
      return SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_INFO;
    }
    if (count($this->registry['views_without_output_caching']) == count($this->registry['views'])) {
      return SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_FAIL;
    }
    return SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_WARN;
  }

}

Members

Name	Modifiers	Type	Description	Overrides
SiteAuditCheckAbstract::$abort	protected	property	Indicate that no other checks should be run after this check.
SiteAuditCheckAbstract::$optOut	protected	property	User has opted out of this check in configuration.
SiteAuditCheckAbstract::$percentOverride	protected	property	If set, will override the Report's percentage.
SiteAuditCheckAbstract::$registry	protected	property	Use for passing data between checks within a report.
SiteAuditCheckAbstract::$score	protected	property	Quantifiable number associated with result on a scale of 0 to 2.
SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_FAIL		constant
SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_INFO		constant
SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_PASS		constant
SiteAuditCheckAbstract::AUDIT_CHECK_SCORE_WARN		constant
SiteAuditCheckAbstract::getPercentOverride	public	function	Get the report percent override, if any.
SiteAuditCheckAbstract::getRegistry	public	function	Get the check registry.
SiteAuditCheckAbstract::getRelativePath	public	function	Gives path relative to DRUPAL_ROOT of the path is inside Drupal.
SiteAuditCheckAbstract::getResult	public	function	Determine the result message based on the score.
SiteAuditCheckAbstract::getScore	public	function	Get a quantifiable number representing a check result; lazy initialization.
SiteAuditCheckAbstract::getScoreCssClass	public	function	Get the CSS class associated with a score.
SiteAuditCheckAbstract::getScoreDrushLevel	public	function	Get the Drush message level associated with a score.
SiteAuditCheckAbstract::getScoreLabel	public	function	Get a human readable label for a score.
SiteAuditCheckAbstract::renderAction	public	function	Display action items for a user to perform.
SiteAuditCheckAbstract::shouldAbort	public	function	Determine whether the check failed so badly that the report must stop.
SiteAuditCheckAbstract::__construct	public	function	Constructor.
SiteAuditCheckViewsCacheOutput::calculateScore	public	function	Implements \SiteAudit\Check\Abstract\calculateScore(). Overrides SiteAuditCheckAbstract::calculateScore
SiteAuditCheckViewsCacheOutput::getAction	public	function	Implements \SiteAudit\Check\Abstract\getAction(). Overrides SiteAuditCheckAbstract::getAction
SiteAuditCheckViewsCacheOutput::getDescription	public	function	Implements \SiteAudit\Check\Abstract\getDescription(). Overrides SiteAuditCheckAbstract::getDescription
SiteAuditCheckViewsCacheOutput::getLabel	public	function	Implements \SiteAudit\Check\Abstract\getLabel(). Overrides SiteAuditCheckAbstract::getLabel
SiteAuditCheckViewsCacheOutput::getResultFail	public	function	Implements \SiteAudit\Check\Abstract\getResultFail(). Overrides SiteAuditCheckAbstract::getResultFail
SiteAuditCheckViewsCacheOutput::getResultInfo	public	function	Implements \SiteAudit\Check\Abstract\getResultInfo(). Overrides SiteAuditCheckAbstract::getResultInfo
SiteAuditCheckViewsCacheOutput::getResultPass	public	function	Implements \SiteAudit\Check\Abstract\getResultPass(). Overrides SiteAuditCheckAbstract::getResultPass
SiteAuditCheckViewsCacheOutput::getResultWarn	public	function	Implements \SiteAudit\Check\Abstract\getResultWarn(). Overrides SiteAuditCheckAbstract::getResultWarn