CiviCRM for Drupal 8 installation notes » History » Revision 8
Revision 7 (Jon Goldberg, 02/13/2019 09:54 PM) → Revision 8/24 (Jon Goldberg, 03/07/2019 09:09 PM)
{{last_updated_at}} by {{last_updated_by}}
# CiviCRM for Drupal 8 installation notes
* Make sure your composer version is up to date! The one that ships with civicrm-buildkit is quite old.
* Run Install Drupal 8 as normal: From the composer command on [David Snopek's blog post](https://www.mydropwizard.com/blog/better-way-install-civicrm-drupal-8) that fits folder above your scenario (creating a new site vs. adding Civi to an existing D8 site).
* New site is: eventual webroot, run: `composer create-project roundearth/drupal-civicrm-project:8.x-dev some-dir drupal-composer/drupal-project:8.x-dev htdocs --stability dev --no-interaction`
* Add the following to `civicrm.settings.php` (modify the last line for your actual CMS root, and paste Follow [the instructions on this after `CIVICRM_UF_BASEURL` is defined):
```php gist](https://gist.github.com/dsnopek/56311dbea347874e75180883efabb620).
$civicrm_setting['URL Preferences']['userFrameworkResourceURL'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_paths['civicrm.root']['url'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_setting['domain']['userFrameworkResourceURL'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_paths['cms.root']['path'] = '/home/jon/local/drupal8test/web';
```
* If you prefer separate Drupal and Civi databases, [dump the Civi tables only](https://stackoverflow.com/a/5269543/2832108) and [drop the Civi tables](https://stackoverflow.com/a/1589324/2832108). Load them into a new database and modify your `CIVICRM_DSN` in `civicrm.settings.php` accordingly.
#### kcfinder
[Note that I have an [open MR](https://gitlab.com/roundearth/civicrm-composer-plugin/merge_requests/1) Copy files to handle `<webroot>/libraries/civicrm` by using the first two steps in `civicrm-composer-plugin`. [script on this ticket](https://lab.civicrm.org/dev/drupal/issues/9).
kcfinder (image browsing/upload within CKEditor) is currently broken. You need to do several things to fix.
* First, [Hack] To get CKEditor/kcfinder working, copy it to libraries/civicrm: `cp -r vendor/civicrm/civicrm-core/packages/kcfinder web/libraries/civicrm/packages/`. $asset_source/packages/kcfinder $asset_dest/packages/`.
* Your `<webroot>/libraries/civicrm/settings_location.php` must contain the correct path to the directory which contains `civicrm.settings.php`.
* Modify `<webroot>/libraries/civicrm/packages/kcfinder/integration/civicrm.php`.
At line 60, add:
```php
case 'Drupal8':
$auth_function = 'authenticate_drupal8';
break;
```
* Finally, add an `authenticate_drupal8` function. You can find some at https://lab.civicrm.org/dev/drupal/issues/42.
#### non-bootstrap scripts
* To get `extern` scripts and `bin/csv/import.php` loading correctly, run this (to create a *second* `settings_location.php`):
```bash
cat << EOF > vendor/civicrm/civicrm-core/settings_location.php $asset_source/settings_location.php
<?php
define('CIVICRM_CONFDIR', '../../../web/sites');
EOF
```
Alternatively, set BOTH `settings_location.php` values to an absolute path, e.g. `/home/jon/local/agbud8/htdocs/web/sites/default`.
* To load images in CKEditor, modify `<webroot>/libraries/civicrm/packages/kcfinder/integration/civicrm.php`.
At line 60, add:
```php
case 'Drupal8':
$auth_function = 'authenticate_drupal8';
break;
```
Somewhere below that, add:
```php
function authenticate_drupal8($config) {
return true;
}
```
* Add the following to `civicrm.settings.php`:
```php
$civicrm_setting['URL Preferences']['userFrameworkResourceURL'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_paths['civicrm.root']['url'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_setting['domain']['userFrameworkResourceURL'] = CIVICRM_UF_BASEURL . '/libraries/civicrm/';
$civicrm_paths['cms.root']['path'] = '/var/www/agbud8.megaphonetech.com/htdocs/web';
```