Skip to content

🐝 Bee is a command line utility for Backdrop CMS. It includes commands that allow developers to interact with Backdrop sites.

License

Notifications You must be signed in to change notification settings

backdrop-contrib/bee

Repository files navigation

Bee

Bee is a command line utility for Backdrop CMS. It includes commands that allow developers to interact with Backdrop sites, performing actions like:

  • Running cron
  • Clearing caches
  • Downloading and installing Backdrop
  • Downloading, enabling and disabling projects
  • Viewing information about a site and/or available projects

See the Release notes and the Changelog for details of changes between versions.

Requirements

Operating System

Static Badge Static Badge Static Badge Static Badge

  • Bee will work in most Linux based environments.
  • Bee will NOT work natively in Windows but can be used inside Linux based virtual environments such as WSL2.
  • Bee requires the mysql and mysqldump executables to be installed for most database operations (i.e. db-export, db-import, db-drop, sql but NOT db-query).

PHP

Static Badge Static Badge Static Badge Static Badge Static Badge Static Badge

  • Bee is tested and works from 7.4 up to 8.3.

Installation

  • Download (or clone) Bee to your computer/server.
    This will create a folder called bee with lots of files inside. Your home directory is a good location for this folder. It is neither required nor recommended to place this folder within the Backdrop web root.

  • Make sure bee/bee.php is executable.
    It should be by default, but it doesn't hurt to double-check.

  • Make it easy to run bee commands.
    There are two ways to do this:

    1. Put a symlink to bee/bee.php in your $PATH (e.g. sudo ln -s /path/to/bee/bee.php /usr/local/bin/bee)

    2. Make a Bash alias for bee (e.g. add alias bee='/path/to/bee/bee.php' to your .bash_aliases file)

  • Test to make sure it works.
    Simply type bee in your terminal and you should see a list of available commands displayed.

More advanced/specialised installation instructions can be found in the wiki.

Extending

Bee can be extended (i.e. custom/additional commands added) by Backdrop contrib modules or by individual users. See API.md for details.

Issues

Bugs and feature requests should be reported in the issue queue: https://github.com/backdrop-contrib/bee/issues.

Current Maintainers

Credits

License

This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.