palantirnet/the-build

Project setup templates and Phing build tasks for Drupal projects.

4.2.0 2024-10-14 17:45 UTC

README

This repository contains project setup templates and reusable phing build targets for Drupal projects.

Note: If you are starting a new a project, you may be looking for the drupal-skeleton.

Adding the-build with composer

$> composer require palantirnet/the-build

Composer 2.2.2 or greater is required for the-build.

Setting up

Install the default templates and phing targets to your project:

$> vendor/bin/the-build-installer

This will trigger an interactive prompt to configure your basic build properties, adding the following templated files and directories:

  • .circleci/
  • .the-build/
  • behat.yml
  • build.xml
  • drush/drushrc.php
  • drush/*.aliases.drushrc.php
  • config/
  • (web|docroot)/sites/default/settings.php
  • (web|docroot)/sites/default/settings.(host).php

These files should be checked in to your project.

Configure your build by editing .the-build/build.yml. You can find more properties in defaults.yml, and override the defaults by copying them into your project's properties files.

Using the-build

Everyday commands

Reinstall the Drupal site from config:

$> vendor/bin/phing install

Rebuild the settings.build.php configuration, and the styleguide if it's available (run automatically when you call install):

$> vendor/bin/phing build

Run code reviews and tests:

$> vendor/bin/phing test

Other commands

View a list of other available targets with:

$> vendor/bin/phing -l

Additional documentation

Copyright 2016-2020 Palantir.net, Inc.