Articles
Having a local web server to use a fully integrated, virtualized AMP stack (Apache, MySQL, PHP) simulates the development, staging, and production servers you may need to deploy Drupal.
AMP Stack on a Local Machine
A developer's workflow begins with installing and configuring an AMP (Apache, MySQL, PHP) stack on a Windows, Mac, or Linux-based system. Depending on the operating system, there are many different methods available to create an ideal environment. However, when it comes to choosing, there are only three options:
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Visit your site in a web browser. You should be redirected to the installer page at /core/install.php.
A detailed guide with screenshots is provided in Section 3.7 of the Drupal 8 User Guide.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
After installation, check the status of your site at Administration > Reports > Status report (/admin/reports/status). If this page reports any issues, resolve them.
Trusted Hosts
If you did not create a settings.php file (located in sites/default/, unless you are using a multisite setup), it was created for you by the installation script. However, the generated settings.php file does not include the "trusted host" configuration.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Simplified in Drupal 8.8.0
Note: If you started your project using Drupal version 8.8.0 or later, your site already uses the correct file structure and is Composer-ready.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
The quick-start command is new as of Drupal 8.6.x. It is not intended for production use. However, it provides a fast way to install and run Drupal using PHP’s built-in web server on your local machine.
Important: The quick-start command is designed only for launching a local demo version of Drupal. If you need to install Drupal 8 for production, refer to the rest of this guide for the proper instructions.
Step 1 - Install PHP
MacOS
MacOS 10.13 (High Sierra) and later come with PHP 7 pre-installed. No additional setup is needed.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Before You Begin
When updating your Drupal 8 site, there are several options to choose from. If you're not yet familiar with these methods, it's recommended to start with this introductory documentation. It provides a helpful summary of all the available update options to make the process easier and more enjoyable.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Before You Begin
Updating a Drupal site means applying a minor version change, such as from "8.4.4" to "8.4.5". This guide covers how to update your Drupal 8 site.
Upgrading a Drupal site means changing the major version, such as from Drupal 6 to 8 or from Drupal 7 to 8.
Updating Drupal 8 Core
The table below lists various options for updating Drupal core. If you're unsure which method best suits your needs, refer to the "Recommendation" column.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
Before You Begin
If you haven't already, it's recommended to read this overview, which outlines all available methods for updating Drupal 8.
PS: This update procedure is also covered in the Drupal User Guide.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.
This documentation is outdated. Help make it current.
Before You Begin
It is recommended to use Composer for managing Drupal dependencies; see Updating Drupal Core with Composer for more. Drush 9 and later no longer support updating Drupal core—this is now Composer's role. However, you can still use Drush 8 (version 8.1.14 or later) to update Drupal 8 if you're familiar with that workflow.
Drupal’s online documentation is © 2000-2020 by the individual contributors and can be used in accordance with the Creative Commons License, Attribution-ShareAlike 2.0. PHP code is distributed under the GNU General Public License.