Installing Drush for working with Drupal 6-8 and Backdrop » History » Version 52
Jack Aponte, 01/22/2020 08:32 PM
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 | 44 | Jack Aponte | cd ~ |
17 | 51 | Jack Aponte | COMPOSER_HOME=$HOME/drush COMPOSER_VENDOR_DIR=$HOME/drush/8 composer require drush/drush:8.3.2 |
18 | 1 | Jack Aponte | cd ~/drush/8/drush/drush |
19 | 41 | Jack Aponte | composer install |
20 | 47 | Jack Aponte | cd ~ |
21 | 44 | Jack Aponte | sudo mv ~/drush /opt/ |
22 | 47 | Jack Aponte | sudo chown -R root: /opt/drush |
23 | 41 | Jack Aponte | sudo ln -s /opt/drush/8/drush/drush/drush /usr/local/bin/drush |
24 | 1 | Jack Aponte | </pre> |
25 | 30 | Jack Aponte | |
26 | 49 | 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@ path to @/opt/drush@ and @COMPOSER_VENDOR_DIR@ to @/opt/drush/8@ and adjusting the other commands above accordingly. |
27 | 43 | Jack Aponte | |
28 | 52 | Jack Aponte | Replace "8.3.2" (last updated in this documentation on 01/22/2020) with the tag of the most recent stable 8.3.x release (see https://github.com/drush-ops/drush/releases) |
29 | 1 | Jack Aponte | |
30 | 40 | Jack Aponte | Use the same commands with a new version number to update Drush as needed. |
31 | 1 | Jack Aponte | |
32 | 50 | Jack Aponte | h2. Install and update Drush Backdrop commands |
33 | |||
34 | 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. |
||
35 | |||
36 | Assuming that Drush 8 is installed in @/opt/drush/8/drush/drush@, as specified above: |
||
37 | |||
38 | <pre> |
||
39 | sudo git clone https://github.com/backdrop-contrib/drush.git /opt/drush/8/drush/drush/commands/backdrop |
||
40 | </pre> |
||
41 | |||
42 | To update Drush Backdrop commands installed like this: |
||
43 | |||
44 | <pre> |
||
45 | cd /opt/drush/8/drush/drush/commands/backdrop |
||
46 | sudo git pull origin |
||
47 | </pre> |
||
48 | |||
49 | 1 | Jack Aponte | h2. Install Drush on May First/People Link (MFPL) and other shared hosting environments |
50 | |||
51 | Primarily drawn from "this MFPL ticket;":https://support.mayfirst.org/ticket/11691#comment:3 thanks Ivan! |
||
52 | 17 | Jack Aponte | |
53 | 18 | Jack Aponte | First, install Composer following "these instructions":https://getcomposer.org/download/. |
54 | 17 | Jack Aponte | |
55 | Then to install Drush: |
||
56 | |||
57 | <pre> |
||
58 | echo 'export PATH="$HOME/.composer/vendor/bin:$PATH"' >> ~/.bashrc |
||
59 | source ~/.bashrc |
||
60 | cd ~/<organization.org>/bin |
||
61 | 40 | Jack Aponte | php composer.phar global require drush/drush:8.2.3 |
62 | 17 | Jack Aponte | which drush |
63 | 1 | Jack Aponte | </pre> |
64 | 8 | Jack Aponte | |
65 | Note that sometimes @cgi-bin@ is present on MF/PL sites instead of @bin@. |
||
66 | 1 | Jack Aponte | |
67 | 8 | 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: |
68 | 1 | Jack Aponte | |
69 | 40 | Jack Aponte | <pre> |
70 | 1 | Jack Aponte | $aliases['organization'] = array( |
71 | 10 | Jack Aponte | 'remote-host' => 'organization.org', |
72 | 42 | Jack Aponte | 'remote-user' => 'organization', |
73 | 10 | Jack Aponte | 'root' => '/home/members/organization/sites/organization.org/web', |
74 | 'uri' => 'organization.org', |
||
75 | 45 | Jack Aponte | 'path-aliases' => array( |
76 | '%drush-script' => '/home/members/organization/sites/organization.org/users/organization/.composer/vendor/bin/drush', |
||
77 | '%dump-dir' => '~/drush-backups', |
||
78 | '%files' => '/home/members/organization/sites/organization.org/web/sites/default/files',), |
||
79 | ); |
||
80 | </pre> |