Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 43
Jack Aponte, 06/04/2019 04:54 PM
added qualification for when you really do need to run the composer commands as root
1 | 14 | Jack Aponte | {{lastupdated_at}} by {{lastupdated_by}} |
---|---|---|---|
2 | |||
3 | 34 | Jack Aponte | {{>toc}} |
4 | |||
5 | 1 | Jack Aponte | h1. Installing Drush for working with Drupal 6-8 and Backdrop |
6 | |||
7 | 40 | Jack Aponte | An important note: we no longer need to install any version of Drush except Drush 8, since that now supports "Drupal 6, 7, <8.3 _and_ Backdrop.":http://docs.drush.org/en/master/install/#drupal-compatibility |
8 | 9 | Jack Aponte | |
9 | 40 | Jack Aponte | h2. Installing and updating Drush 8 for all users |
10 | 1 | Jack Aponte | |
11 | 40 | Jack Aponte | I've followed the "Install a global Drush via Composer" instructions under in the "Drush 8 alternative installation documentation.":http://docs.drush.org/en/8.x/install-alternative/ |
12 | 28 | Jack Aponte | |
13 | 41 | Jack Aponte | Since running @composer install@ as root is a "security risk":https://getcomposer.org/doc/faqs/how-to-install-untrusted-packages-safely.md, you can use commands like these to install Drush in your home directory first, then move it to a globally-accessible location using @sudo@: |
14 | 8 | Jack Aponte | |
15 | 1 | Jack Aponte | <pre> |
16 | 41 | Jack Aponte | COMPOSER_HOME=/home/jack/drush COMPOSER_BIN_DIR=/usr/local/bin COMPOSER_VENDOR_DIR=/home/jack/drush/8 composer require drush/drush:8.2.3 |
17 | cd ~/drush/8/drush/drush |
||
18 | composer install |
||
19 | sudo mv drush /opt/ |
||
20 | sudo ln -s /opt/drush/8/drush/drush/drush /usr/local/bin/drush |
||
21 | 1 | Jack Aponte | </pre> |
22 | 30 | Jack Aponte | |
23 | 43 | Jack Aponte | If you _must_ run @composer install@ and the other commands above as root, e.g. if that's the only user we have access to on the server, you can do so by changing the @COMPOSER_HOME@ and @COMPOSER_VENDOR_DIR@ paths to @/opt/drush@ and @/opt/drush/8@, respectively. |
24 | |||
25 | 40 | Jack Aponte | Replace "8.2.3" (last updated in this documentation on 5/28/19) with the tag of the most recent stable 8.x release (see https://github.com/drush-ops/drush/releases) |
26 | 1 | Jack Aponte | |
27 | 40 | Jack Aponte | Use the same commands with a new version number to update Drush as needed. |
28 | 1 | Jack Aponte | |
29 | h2. Install Drush on May First/People Link (MFPL) and other shared hosting environments |
||
30 | |||
31 | Primarily drawn from "this MFPL ticket;":https://support.mayfirst.org/ticket/11691#comment:3 thanks Ivan! |
||
32 | 17 | Jack Aponte | |
33 | 18 | Jack Aponte | First, install Composer following "these instructions":https://getcomposer.org/download/. |
34 | 17 | Jack Aponte | |
35 | Then to install Drush: |
||
36 | |||
37 | <pre> |
||
38 | echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc |
||
39 | source ~/.bashrc |
||
40 | cd ~/<organization.org>/bin |
||
41 | 40 | Jack Aponte | php composer.phar global require drush/drush:8.2.3 |
42 | 17 | Jack Aponte | which drush |
43 | 23 | Jack Aponte | </pre> |
44 | 25 | Jack Aponte | |
45 | 40 | Jack Aponte | Note that sometimes @cgi-bin@ is present on MF/PL sites instead of @bin@. |
46 | 1 | Jack Aponte | |
47 | 23 | Jack Aponte | If using Drush aliases, you may need to specify the new Drush installation in the shared @aliases.drushrc.php@ file or a local aliases file. Here's an example: |
48 | |||
49 | 19 | Jack Aponte | <pre> |
50 | 20 | Jack Aponte | $aliases['organization'] = array( |
51 | 19 | Jack Aponte | 'remote-host' => 'organization.org', |
52 | 'remote-user' => 'organization', |
||
53 | 20 | Jack Aponte | 'root' => '/home/members/organization/sites/organization.org/web', |
54 | 'uri' => 'organization.org', |
||
55 | 'path-aliases' => array( |
||
56 | '%drush-script' => '/home/members/organization/sites/organization.org/users/organization/.composer/vendor/bin/drush', |
||
57 | 21 | Jack Aponte | '%dump-dir' => '~/drush-backups', |
58 | 19 | Jack Aponte | '%files' => '/home/members/organization/sites/organization.org/web/sites/default/files',), |
59 | 1 | Jack Aponte | ); |
60 | </pre> |
||
61 | 8 | Jack Aponte | |
62 | h2. Install and update Drush Backdrop commands |
||
63 | 1 | Jack Aponte | |
64 | 8 | Jack Aponte | In order for Drush to work with Backdrop, you must install the "Drush Backdrop commands":https://github.com/backdrop-contrib/drush within the Drush 8 installation itself. |
65 | 1 | Jack Aponte | |
66 | 40 | Jack Aponte | Assuming that Drush 8 is installed in @/opt/drush/8/drush/drush@, as specified above: |
67 | 1 | Jack Aponte | |
68 | 10 | Jack Aponte | <pre> |
69 | 42 | Jack Aponte | sudo git clone https://github.com/backdrop-contrib/drush.git /opt/drush/8/drush/drush/commands/backdrop |
70 | 10 | Jack Aponte | </pre> |
71 | |||
72 | 40 | Jack Aponte | To update Drush Backdrop commands later, run @git pull origin@ from within the @drush/commands/backdrop@ directory. |