9 :Author: Antonio Ospite <ao2@ao2.it>
13 :Manual group: General Commands Manual
18 *drin* <options> [sub-command]
23 Helper commands to create and install new Drupal projects.
25 One problem with setting up a new Drupal project with
26 drupal-composer/drupal-project is that drush and drupal-console are not
27 available until the site dependencies have been downloaded, drupal-init-tools
28 helps to solve this and also adds a nicer command line interface to some
31 drupal-init-tools commands are especially useful when setting up projects in
32 user web directories[1].
34 [1] http://httpd.apache.org/docs/current/howto/public_html.html
46 Available sub-commands:
48 ``new`` `[-h|--help]` `<destdir>` `[composer options (e.g. --devel)]`
49 Create a new Drupal project in the `destdir` directory.
51 ``bootstrap`` `[--devel|--overwrite-profile|-h|--help]`
52 Bootstrap a Drupal project, using settings from a `bootstrap.conf` file.
54 ``clean`` `[-h|--help]`
55 Cleanup the project, removing all the installed files.
57 ``create-profile`` `[-h|--help]` `<title>` `<machine_name>`
58 Create an installation profile from the installed project.
64 Create and install a new Drupal project:
69 drin new drupal_test_site
71 $EDITOR bootstrap.conf
72 drin bootstrap --devel
75 Create an installation profile from the currently installed project:
79 drin create-profile "Test Profile" test_profile
82 Clean and rebuild the whole project to verify that installing from scratch works:
89 NOTES ON DATABASE SETUP
90 =======================
92 The `bootstrap` command in `drupal-init-tools` uses `drush` for the site
93 installation, and `drush` requires MySQL super-user access to create new MySQL
96 On some Linux distributions, like Debian, the MariaDB server is configured by
97 default to only allow access to the `root` user via the `unix_socket` plugin,
98 making it unusable by `drush`. In these cases it's recommended to create e new
101 For password-less access create a MySQL admin user correspondent to the system
102 user which will execute `drush` (e.g. the current user):
106 sudo /usr/bin/mysql -e "GRANT ALL ON *.* TO '$USER'@'localhost' IDENTIFIED VIA unix_socket WITH GRANT OPTION"
109 For password regulated access create a user with a password:
113 sudo /usr/bin/mysql -e "GRANT ALL ON *.* TO 'USERNAME'@'localhost' IDENTIFIED BY 'password' WITH GRANT OPTION"
116 For details see also the **PASSWORDS** section in the README.Debian file
117 provided by the mariadb-server Debian package, either in
118 `/usr/share/doc/mariadb-server-10.1/README.Debian.gz` or at
119 https://salsa.debian.org/mariadb-team/mariadb-10.1/blob/stretch/debian/mariadb-server-10.1.README.Debian#L73
121 The settings in the `bootstrap.conf` file have to be adjusted according to how
122 super-user access has been configured.
128 * drupal-composer/drupal-project: https://github.com/drupal-composer/drupal-project
129 * drush: https://github.com/drush-ops/drush
130 * drupal-console: https://github.com/hechoendrupal/drupal-console
132 .. _drupal-composer/drupal-project: https://github.com/drupal-composer/drupal-project
133 .. _drush: https://github.com/drush-ops/drush
134 .. _drupal-console: https://github.com/hechoendrupal/drupal-console