catchdigital / drucker
Docker + drupal composer stack
Installs: 109
Dependents: 0
Suggesters: 0
Security: 0
Stars: 0
Watchers: 4
Forks: 0
Open Issues: 4
Type:project
Requires
- composer/installers: ^1.9
- cweagans/composer-patches: ^1.6
- drupal/core-composer-scaffold: ^10
- drupal/core-project-message: ^10
- drupal/core-recommended: ^10
- drush/drush: ^11
- vlucas/phpdotenv: ^5.0
Requires (Dev)
- drupal/core-dev: ^10
- drupal/twig_vardumper: ^3.1
Conflicts
This package is auto-updated.
Last update: 2024-12-07 10:58:08 UTC
README
Introduction
Docker compose kick-starting set.
Set up
- NGINX: Latest from docker hub.
- PHP 7-fpm: Optimized version 7.4.4
- Percona: Version 5.7
Create a the project
Create a new project with composer. Replace the ${project_name} with your project. That will be the root directory of your application:
composer create-project catchdigital/drucker ${project_name}
If the settings.php file is updated in Drupal core, you'll need to uncomment the last 3 lines of settings.php to include the settings.local.php
Updating the project
An .env file should be created as a copy of .env.example. Feel free to add/update any variables as your needs.
Run docker compose
docker-compose up -d server
If you have the domain in your hosts file, you should be able to hit the site on https://vm.localhost/ or whatever domain you want to run the site.
Other useful commands
Stop docker stack
docker-compose stop
Destroy the whole docker stack. This also delete the database.
docker-compose down
Next steps
Install the contrib themes if needed, create your custom theme, and update webpack with your ${theme} name.
After that, you should be able to build the css and javascript from the root of the project: npm run build
. That will generate the files in a build folder in the theme. Don't forget to create add the build files to your libraries and create different entrypoints for each of your libraries, so they can be splitted around the twig templates.
In oder to add dynamically the dependencies for each entrypoint, you should add the following hook to your theme.
/**
*
* Implements hook_library_info_alter() for webpack chunks dependencies.
*/
function hook_library_info_alter(&$libraries, $extension) {
// We only want to modify current theme extensions
if ($extension === '${theme}') {
// Load chunks dependencies from stats file.
$stats = file_get_contents(DRUPAL_ROOT . "/../webpack.stats.json");
$stats = Json::decode($stats);
// Create and attach code splits.
foreach($stats['namedChunkGroups'] as $name => $lib) {
// Loop through require files.
$reqAssets = $lib['assets'];
if (isset($libraries[$name])) {
$libraries = addNewLibrary($libraries, $reqAssets, $name);
}
}
}
}
function addNewLibrary($libraries, $reqAssets, $name) {
foreach($reqAssets as $asset) {
$requireLib = str_replace('.bundle.js', '', $asset['name']);
// Dependency exists?
if (empty($libraries["asset-$requireLib"])) {
$filename = "build/" . $asset['name'];
$libraries["asset-$requireLib"] = [
"js" => [
$filename => []
]
];
$excludedLibraries = ["500", "396"];
if (in_array($requireLib, $excludedLibraries)) {
$libraries["asset-$requireLib"]["js"][$filename] = [
"minified" => false,
"attributes" => [
"async" => true,
"defer" => true
]
];
}
}
if (isset($libraries[$name]['dependencies'])) {
$libraries[$name]['dependencies'][] = "${theme}/asset-$requireLib";
} else {
$libraries[$name]['dependencies'] = ["${theme}/asset-$requireLib"];
}
}
return $libraries;
}
The individual library for each entry point must be created manually based on the definition on webpack, and they shuold use the same name. If using catchify theme, this is happening automatically.