/drupal-check

Docksal addon to help run @mglaman Drupal check script. Checks for Drupal code for deprecations and discover bugs via static analysis

Primary LanguageShell

Drupal-check Docksal Addon

Installation

Download or clone the drupal-check addon and place it into your .docksal/addons directory.

This will work regardless of whether your project uses the the Composer based mglaman/drupal-check or not. If you are not using Composer, this addon will install the script from Github for you.

cd .docksal/addons
git clone https://github.com/cbarrettgenuine/drupal-check.git
fin addon install drupal-check

Note: If you want this to remain part of your project's repo, delete the .git folder from within the .docksal/addons/drupal-check folder

Usage

Check Drupal code for deprecations and discover bugs via static analysis using mglaman/drupal-check

1. Run drupal-check

Usage:

fin drupal-check [MODULE NAME] [OPTIONS]

Arguments:

  • MODULE NAME - The modules machine name.
  • OPTIONS - See "Options" for allowed values.

Options:

  • -a Check analysis
  • -d Check deprecations (default)
  • -t Module type {core, custom, profile, contrib (default)}
  • -p Profile name for multi-sites if using a profile type module
  • -v Verbose output

Assumptions:

The -p profile_name and -t profile arguments assume that your profile and modules follow this directory structure:

/var/www/DOCROOT/profiles/custom/PROFILE_DIR/modules/MODULE_NAME

The command fin drupal-check my_profile_module -a -t profile -p my_profile_name will look for your module in:

/var/www/DOCROOT/profiles/custom/my_profile_name/modules/my_profile_module

In the event that this does not match your path, you can use a local.drupal-check file. For best results, copy and rename the example.local.drupal-check file and add your path to the DRUPAL_CHECK_MODULE_PATH variable.

Examples:

  • Check the address contrib module:

    fin drupal-check address
  • Check non-contrib module:

    fin drupal-check custom_module -t custom
  • Check the address contrib module for deprecations:

    fin drupal-check address -d
  • Check the address contrib module for analysis:

    fin drupal-check address -a
  • Check a custom, profile specific module for analysis:

    fin drupal-check my_profile_module -a -t profile -p my_profile_name
  • Check a custom module for analysis with verbose output:

    fin drupal-check my_custom_module -a -t custom -v