Download the PHP package dpi/drupal-local without Composer
On this page you can find all versions of the php package dpi/drupal-local. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package drupal-local
Local Drupal Development
This setup is exclusively for local development only.
Setup
This setup has been tested with :
- Apple Silicon M1
- macOS Monterey
- Local clone
- Git
- Docker for Mac
- Composer
- Brew
Usage
composer create-project dpi/drupal-local
cp .env.dist .env
and add values.composer install
- Install Certificates, see Local TLS section below.
- Optionally copy and remove
dist.
prefix from settings files. docker-compose up -d
Drupal
Drupal is accessible at https://localhost/
Installation
Common tasks
Alternative hostnames
Want to use a hostname other than localhost, such as DOMAIN.localhost? (automat- ically works with Firefox / Chrome) Or any others with editing host file?
- Update URLs and hostnames in
.env
file. - Generate certificates for new hostname (See Local TLS).
docker-compose up -d
Redis
Configuration Export/Import
Config YAML will be exported to ./config/
, alternatively use MySQL dump and
auto restoration per below.
Local TLS
Why local HTTPS? Just because! Also Secure Cookies! And other things probably.
More certificates can be defined in traefik/config/certificates.yaml
.
MySQL Dump
Dump the MySQL database from the PHPCLI container so the setup can be restarted.
The dump will be automatically imported if you docker-compose down
then
restart the application. The app will take a few extra seconds to be ready. Tail
the database log with docker-compose logs -f db
to track progress.
Mailhog
Mailhog will capture emails sent by Drupal. There is no need to configure Drupal
as sendmail_path
is configured.
Mailhog is accessible at https://localhost/mailhog/
Traefik
Dashboard is accessible at https://localhost/traefik/
Development
PHPStan
Optionally customise PHPStan configuration with
cp phpstan.neon.dist phpstan.neon
. The .dist file will be used by default.
PHPCS
Optionally customise PHPCS configuration with
cp phpcs.xml.dist phpcs.xml
. The .dist file will be used by default.
PHPUnit
Optionally customise PHPUnit configuration with
cp phpunit.xml.dist phpunit.xml
. The .dist file will be used by default.
Blackfire
Define client and server ID and tokens in .env.
Web profiling
Browser extension
Enable the browser extension as normal.
Navigate to the page you wish to profile, and click 'Profile!' button.
Note: does not work properly if you're using Firefox container tabs. Use a container-less tab when profiling in Firefox.
Docker compose
docker-compose exec blackfire blackfire curl http://nginx:8080/
Blackfire CLI app
Blackfire client (blackfire
) is built into the PHP CLI container
(Dockerfile-php-cli
):
CLI app profiling
All versions of drupal-local with dependencies
cweagans/composer-patches Version ^1
drupal/admin_toolbar Version ^3.1.1
drupal/core Version ^10.1
drupal/core-composer-scaffold Version ^10.1
drupal/core-project-message Version ^10.1
drupal/redis Version 1.x-dev
drush/drush Version ^11.2.1@rc