civicrm/civix

CiviCRM Extension CLI

civix

Civix is a command-line tool for building CiviCRM extensions. It is distributed as part of CiviCRM-Buildkit., _(*1)

Requirements

• PHP 7.3+
• CiviCRM 5.x (Recommended: any release from the prior 12 months)
• (For MAMP, WAMP, XAMPP, etc) PHP command-line configuration (http://wiki.civicrm.org/confluence/display/CRMDOC/Setup+Command-Line+PHP)
• (For CentOS/RHEL) Compatible version of libxml2 (https://github.com/totten/civix/issues/19)

Download

civix is distributed in PHAR format, which is a portable executable file (for PHP). It should run on most Unix-like systems where PHP is installed. Here are three quick ways to download it:, _(*2)

• Download the latest release of civix.phar (SHA256, GPG) and put it in the PATH. For example:, _(*3)

  sudo curl -LsS https://download.civicrm.org/civix/civix.phar -o /usr/local/bin/civix
  sudo chmod +x /usr/local/bin/civix
  

  (Learn more: Install civix.phar as system-wide tool (Linux/BSD/macOS)), _(*4)

• Or... add civix and other CiviCRM tools to a composer project (Drupal 9/10/11), _(*5)

  composer require civicrm/cli-tools
  

  (Learn more: Install civix.phar as project tool (composer)), _(*6)

• Or... use phar.io's phive installer to download, validate, and cache the civix.phar file., _(*7)

  phive install totten/civix
  

  (Learn more: Install civix.phar as project tool (phive)), _(*8)

There are several more options for downloading civix. See also:, _(*9)

• Download URLs for alternate versions
• Comparison of install options
• Install civix as a system-wide/standalone tool
  • Install civix.phar (binary) as system-wide tool (Linux/BSD/macOS)
  • Install civix.git (source) as standalone project (Linux/BSD/macOS)
  • Install civix.git (source) as standalone project (Windows)
• Install civix as a tool within another project
  • Install civix.phar (binary) as project tool (composer)
  • Install civix.phar (binary) as project tool (phive)
  • Install civix.git (source) as project tool (composer)

Documentation

The CiviCRM Developer Guide includes tutorials for building extensions, _(*10)

For reference documentation, civix supports a "--help" option. For example, to get reference materials about the "generate:page" command, run:, _(*11)

civix generate:page --help

Development

If you are developing updates for civix.git, then see doc/develop.md. It discusses PHAR compilation, unit tests, and similar processes., _(*12)