18.11.2015 Views

Beginning Drupal 8

Todd Tomlinson - Beginning Drupal 8 (The Expert's Voice in Drupal) - 2015

Todd Tomlinson - Beginning Drupal 8 (The Expert's Voice in Drupal) - 2015

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Downloading <strong>Drupal</strong><br />

Appendix A ■ Installing <strong>Drupal</strong><br />

Downloading <strong>Drupal</strong> is a simple matter of visiting www.drupal.org/project/drupal and picking the latest<br />

version and language (such as English or French) of <strong>Drupal</strong> to download from the homepage. <strong>Drupal</strong><br />

version numbers change over time, but it is safe to pick the latest version listed on the homepage as the<br />

version to download, install, and configure. Alternatively, and significantly easier, is to download <strong>Drupal</strong> via<br />

Drush. Please see Chapter 15 for details.<br />

To download <strong>Drupal</strong>, simply right-click the version and format that you wish to install. The compressed<br />

file (tar.gz or zip) will automatically download to your computer into the folder you have configured for<br />

receiving downloads from the Internet.<br />

Decompressing the <strong>Drupal</strong> Installation Package<br />

The file downloaded from <strong>Drupal</strong>.org is a compressed file that has all of the directories and files required to<br />

set up and run <strong>Drupal</strong> 8 on your server. You will need to decompress the tar.gz or zip file into its individual<br />

elements, either by double-clicking the file (this works on OS X and Linux) or by opening the file in a<br />

decompression utility. Double-clicking the file will result in a folder being created on your computer with all<br />

of the directories and files expanded to their original, pre-compressed state.<br />

■■Note<br />

Depending on your operating system and your setting for your operating system’s file manager, you<br />

may or may not see the .htaccess file, as it is classified as a “hidden” file in Linux and OS X. This is a critical<br />

file and must be moved in the next step. If you do not see the .htaccess file, please update your file browser’s<br />

settings to allow you to see hidden files before proceeding to the next step. Other operating systems may have<br />

similar files, such as web.config on IIS.<br />

Moving the <strong>Drupal</strong> Distribution to the Root Directory of Your Web<br />

Server<br />

The next step is to move the contents of the <strong>Drupal</strong> folder that you just decompressed in the previous step, to<br />

the “root” directory of your web server. If you are using XAMPP, the “root” directory is the folder marked as<br />

htdocs in the directory where XAMPP is installed. If you are installing <strong>Drupal</strong> on a hosted platform, the root<br />

directory will be that specified by your hosting company (for example, the hosting company that I use names<br />

the root directory public_html). You should check with your hosting company if you are unsure where to<br />

put your <strong>Drupal</strong> files.<br />

With all of the files in place, you’re ready to take the next step.<br />

Creating the settings.php File<br />

<strong>Drupal</strong> uses a file named settings.php to store configuration parameters for your site, such as the name<br />

of the database and the userID and password used to access that database. <strong>Drupal</strong> ships with a default<br />

settings.php file that we will use as the starting point for our site’s settings.php file. Navigate to the<br />

sites/default directory in the location where you copied the <strong>Drupal</strong> directories and files to in the previous<br />

step. In that directory you will find a default.settings.php file. Copy that file and rename the copied<br />

version to settings.php.<br />

269

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!