Development Environments

  
Last updated April 7, 2022
Site BuildingThemingModule DevelopmentDrupal 9Drupal 8Drupal 7

A development environment is any copy of your site that operates separately from the live site. Development environments allow you to make changes, try new modules, write new code, and test new ideas, on a copy of your site instead of the real thing, ensuring those changes happen in a sandbox where you're not affecting anyone trying to use the live version of your application.

This is typically done by installing the server software required to run Drupal on your own computer and then creating a clone of your existing database and files. Or you might have a separate instance of the site setup on the existing infrastructure.

Here's a basic recipe for setting up a new development environment:

  1. Install web server, database server, PHP, and Git
  2. Either install Drupal if starting from scratch, or clone the code, database, and user-generated files from your live site
  3. Clear the cache

Example tasks

  • Install Drupal on, or copy an existing site to, your computer to do development
  • Test modules and code without affecting the production site
  • Test server configuration changes on your localhost before deploying them to production

Confidence

There are dozens of ways to do this, and none is the only right way. The bare minimum requirement is that you have PHP, a web server, and a database running on the computer where you would like to install Drupal. Beyond that, it's mostly personal preference.

Drupalize.Me resources

First, learn about best practices in Drupal Development.

Tutorial

Best Practice Drupal Development

Free
Module Development, Drupal 8, Drupal 7, Drupal 9
More information

Today's Drupal developer needs more than just a text editor and FTP. Best practice Drupal development involves a suite of tools, processes, and more than one server environment.

This tutorial is directed toward an audience that is not familiar with best practices in Drupal Development and methods involving version control with Git, IDEs, local development environments, and deployment environments (i.e. stage, live). Here we're providing a high-level overview of these topics with links to dive deeper if you need more information.

In this tutorial, we'll cover:

What is a development site? These tutorials from the Drupal 8 User Guide will help you understand what you need in a local development environment, in order to run Drupal locally on your machine.

Tutorial

11.7. Concept: Development Sites

Free
Site Building, Site Administration, Drupal 9, Drupal 8
More information

Overview of development sites with an example deployment workflow for site building.

Tutorial

11.8. Making a Development Site

Free
Site Building, Site Administration, Drupal 9, Drupal 8
More information

How to make a copy of a live site for development purposes.

Learn about the minimum requirements for running Drupal 8. These will also work for Drupal 7. If you're curious about Drupal 7 specifics see the Drupal 7 system requirements

Tutorial

3.1. Concept: Server Requirements

Free
Site Building, Site Administration, Drupal 9, Drupal 8
More information

Overview of server requirements for installing and running the core software.

Learn to use Docker for Drupal Development:

Topic

Docker

Backend and Infrastructure, Drupal 9, Drupal 8, Drupal 7
More information

For the Drupal developer, Docker is a way to provide a local development environment to run web server software.

Learn about why it's important to clone an existing site with Drupal 8. Then do it, either via the Command Line Interface (CLI), or with Graphical User Interface (GUI) tools.

Tutorial

Create a Clone of Your Drupal Site

Site Administration, Drupal 8, Drupal 9
More information

Before you can get started synchronizing configuration between instances of your site, you'll need to create a new instance or "clone" of your Drupal site.

By the end of this tutorial, you should know:

Tutorial

Clone a Drupal Site with GUI Tools

Site Administration, Drupal 8, Drupal 9
More information

The configuration system in Drupal was designed to manage and sync configuration between instances of a Drupal site. So before configuration management can be useful, we must have another instance--or clone--of our Drupal site. In this lesson, you will learn:

Learn how to use Git to keep the code on your development environment in sync with that on the live site.

Topic

Git

Theming, Module Development, Backend and Infrastructure, Community
More information

The Git version control system can help you keep track of changes in your codebase and make sure you don't unintentionally lose work.

Now that you've got a copy of your Drupal site on your local environment, using an IDE (Integrated Development Environment) such as PhpStorm can be highly useful, as it can autocomplete various language constructs, help you quickly locate inherited classes, alert you when a function is deprecated, provide debugging tools, and much more.

Topic

PhpStorm

Theming, Module Development, Drupal 9, Drupal 8, Drupal 7
More information

The PhpStorm integrated development environment (IDE) contains dozens of useful features that make working with a Drupal codebase easier.

Set up your environment for theming in Drupal

Tutorial

Configure Your Environment for Theme Development

Theming, Drupal 9, Drupal 8
More information

Making Drupal fast by default implies having caching layers and CSS and JavaScript aggregation utilities enabled out-of-the-box. As a theme developer this can be annoying, because you must clear these various caches in order to preview any changes. In addition, inspecting variables with debugging tools often produces PHP errors. We'll make some recommendations for PHP settings on your local environment that can prevent these errors from happening so often.

By the end of this tutorial, you should be able to:

More Guides

We have guides on many Drupal skills and topics.

Explore guides

External resources

  • Local Development Guide (drupal.org)
    • The purpose of this guide is to assist you with creating and installing a new Drupal application on your local machine for the purpose of development. Installing Drupal using the following instructions will give you a starting point for a website that can be deployed to a production environment. The intended audience for this guide is a developer.
  • Local Dev Environments for Dummies
    • This MidCamp 2018 presentation by Jeff Geerling covers all the basics you need to know to be able to evaluate and determine what's the best development setup for you, your team or your dev shop.

Choose any of these excellent community-built tools (all Docker-based) to get up-and-running with a local development environment. These free products are all cross-platform.

  • DDEV
    • DDEV is an open source tool that makes it simple to get local PHP development environments up and running in minutes. We use it internally at Drupalize.Me.
    • DDEV Docs (ddev.readthedocs.io)
    • See this repo for many example command snippets from the community: drud/ddev-contrib (github.com)
  • Lando
    • Uses Docker containers with sane defaults for Drupal and other open source web development. Includes configuration defaults for a number of popular open source frameworks, tech stacks, and hosting platform Pantheon.
  • Docksal
    • An all-purpose web-development environment based on Docker and Docker Compose.
  • Drupal VM (drupalvm.com)
    • Uses Ansible, and either a Vagrant VM or Docker containers to set up a Drupal-centered environment. Includes many convenient utilities for local development. A little harder to install but gives more flexibility and bundled features.
  • SimplyTest.me, and Try Drupal (drupal.org)
    • Sometimes you just need to create a quick Drupal site to try out a new module or a proof of concept. SimplyTest.me is the fastest way we know of to do that. If you want something that doesn't expire after 24 hours, try one of the hosting providers with free options from Drupal.org.

There are many others! Check out this panel at BADCamp 2019 with representatives from these and other tools talking local development tools for Drupal developers.