Introduction to Composer for Drupal
1 like780 views
This is the presentation I would have loved to see when I started using Composer with Drupal. Based on my experience working with Composer and Drupal 7 + Drupal 8. Learn about the basics working with the Dependency Management for PHP: Composer. Dicover the commands, files (composer.lock and composer.json), the pros but also the cons of using the tool. This was presented in October 2016 in Cebu for Cebu Drupal Meetups, and Drupalcamp Japan 2017 in Tokyo in January 2017.
![Composer for Drupal
Patches?
Use composer-patches
https://github.com/cweagans/composer-patches
"extra": {
"patches": {
"drupal/date": {
"7.2.9": [
{
"title": "Fix an issue with undefined index: show_remaining_days in
date_field_formatter_view()",
"url":
"https://www.drupal.org/files/issues/date-show_remaining_days_notice-2469189-1.patch"
}
]
},
},
}](https://image.slidesharecdn.com/introductiontocomposerfordrupal-161102050624/85/Introduction-to-Composer-for-Drupal-25-320.jpg)
![ありがとう
Twitter @luukyb
email: luc [at] webizat.com
web: webizat.com](https://image.slidesharecdn.com/introductiontocomposerfordrupal-161102050624/85/Introduction-to-Composer-for-Drupal-36-320.jpg)
![[drupalday2017] - Devel - D8 release party](https://cdn.slidesharecdn.com/ss_thumbnails/luca-lussodday2017-170315152155-thumbnail.jpg?width=560&fit=bounds)
Ad
More Related Content
What's hot (20)
Similar to Introduction to Composer for Drupal (20)
Ad
More from Luc Bézier (8)
Ad
Recently uploaded (20)
Introduction to Composer for Drupal
- 1. Introduction to Composer for Drupal Drupal Camp Japan in Tokyoとは 2017
- 2. About me Luc Bezier, Drupal & Open Source freelance. France 出身です. Drupal development since 2010. URL: webizat.com Organizer of Drupalcamp Cebu (Philippines) Worked with BBC Worldwide, UK Government agency, Ben&Jerry’s, European commission …
- 3. Solution Architect & Consultant Architecture and drupal development on large projects.
- 4. Promet Source and Composer + Drupal Using Drupal with Composer since 2014. Drupal 7, Drupal 8.
- 5. What is Composer? Dependency Manager for PHP. Declare the libraries of your project and Composer will manage (install/update) them for you.
- 6. これはいくらですか？ How much does it cost? Composer is Free and Open source. By Nils Adermann and Jordi Boggiano in 2012. Not only Drupal, used in other PHP projects like Symfony.
- 7. BTW, the logo? Could this man be a composer too, but what he is doing is conducting.
- 8. Why using Composer? Never miss a dependency again. Clear view on your project’s requirements. Smaller amount of data in your git repo. Makes maintenance easier.
- 9. Why using Composer? Drupal 8 adopted Composer. Contributed modules are using composer to manage their PHP depencencies.
- 10. Composer commands $ composer install Creates a resource (vendor) folder and downloads all dependencies. $ composer update Updates the dependencies according to composer.json.
- 11. Composer commands $ composer require Adds a new dependency. $ composer remove Removes a dependency.
- 12. Composer commands Debugging? $ composer install -vvv Verbose mode will let you see what is composer doing.
- 13. Composer’s files Simply remember composer.json: list of dependencies for the project. composer.lock: expected install state.
- 14. composer.json … "require": { "drupal/core": "~8.0", "drush/drush": "^8.1", "drupal/console": "~0.10", "drupal/field_group": "~8.1@alpha", "drupal/honeypot": "^8.1", "drupal/google_analytics": "^8.2", "drupal/avatars": "^8.1@beta" }, ...
- 15. composer.json Composer.json uses versions. "drupal/core": "~8.0", ~8.0 is equivalent to >=8.0 <9.0 The ~ will keep our version as Drupal 8. Doc: https://getcomposer.org/doc/articles/versions.md
- 16. composer.lock The file composer.lock contains all informations about your dependencies, including which exact version is in use. "name": "drupal/core", "version": "8.1.10", "source": { "type": "git", "url": "https://github.com/drupal-composer/drupal-core.git", "reference": "9562f733cdefd735337bf827b3ba5ad031aba4c3" },
- 17. Composer and git Commit composer.json and composer.lock Do not commit the vendor folder. It would defeat the purpose of using composer to manage your dependencies.
- 18. Composer for Drupal Drupal 8 tarball from drupal.org ships with a composer.json and composer.lock files. Better way: composer templates.
- 19. Composer for Drupal Two templates to use composer with Drupal. drupal/drupal drupal-composer/drupal-project (https://www.drupal.org/node/2718229)
- 20. Composer for Drupal I recommend the drupal-composer template. Quick installation via: $ composer create-project drupal-composer/drupal-project https://github.com/drupal-composer/drupal-project
- 21. Composer for Drupal Using the template for Drupal projects, files used by Drupal (such as modules) will be placed at the right location. Core -> web/core Contrib modules -> web/modules/contrib Contrib themes -> web/themes/contrib
- 22. No composer template Drupal Composer template web Example, the core folder is not in git.
- 23. Composer for Drupal Need a new module? $ composer require drupal/pathauto Enable the module.
- 24. Composer for Drupal Update all dependencies (can be slow). $ composer update Update Drupal core. $ composer update drupal/core --with-dependencies Update a module. $ composer update drupal/panels --with-dependencies
- 25. Composer for Drupal Patches? Use composer-patches https://github.com/cweagans/composer-patches "extra": { "patches": { "drupal/date": { "7.2.9": [ { "title": "Fix an issue with undefined index: show_remaining_days in date_field_formatter_view()", "url": "https://www.drupal.org/files/issues/date-show_remaining_days_notice-2469189-1.patch" } ] }, }, }
- 26. Warning, this is the sad part.
- 28. Composer performance Composer is slow. Composer will check all the available tags when updating a dependency for example. The more dependencies, the slower. That can be an issue with some Drupal projects.
- 29. Composer performance Update specific packages, not everything. $ composer update drupal/panels --with-dependencies Not $ composer update
- 30. Composer performance You are using Vagrant? Execute composer from your local, not the VM. You are using Docker? Execute composer from your local, not the container. When possible, use the latest version of PHP to execute composer. PHP 7 (https://secure.php.net/releases/)
- 31. Composer performance Other solutions (I haven’t tried)? Local mirror of the packages using Satis* getcomposer.org/doc/articles/handling-private-packages-with-satis.md Parallel download with prestissimo** github.com/hirak/prestissimo * Thanks to Johnnie Fox for sharing. ** Thanks Koyama Tetsuji for sharing.
- 32. Composer performance Most Drupal Platform as a Service (PaaS) (Acquia, Pantheon ...) do not yet support composer. Check the documentation.
- 33. Composer and Drupal My blog article webizat.com/blog/composer-for-drupal (feel free to comment!)
- 34. Composer and Drupal Great article by Matt Glaman https://glamanate.com/blog/managing-your-drupal-pr oject-composer Useful links and resources: https://github.com/drupal-composer/drupal-project https://github.com/cweagans/composer-patches
- 35. Test it with Expresso PHP Docker for PHP developers Simple and easy to understand. Original images only. Nginx + PHP (7 / 5) Apache + PHP (7 / 5) github.com/expresso-php/expresso-php
- 36. ありがとう Twitter @luukyb email: luc [at] webizat.com web: webizat.com