History: Composer
Source of version: 30
Copy to clipboard
{include page="SVN deprecation notice"}
Composer is a Software Dependency Manager for PHP, which is heavily used by [https://tiki.org|Tiki].
! Composer
* Official website: https://getcomposer.org/
* Package repositories:
** Main: https://packagist.org/
** Secondary: https://asset-packagist.org (after ((dev:Composer Dependencies not on Packagist|considering other options)))
* Tiki uses Composer to manage [https://gitlab.com/tikiwiki/tiki/-/blob/master/vendor_bundled/composer.json|150+ library dependencies in PHP and JavaScript], which are bundled as part of the regular Tiki install.
* Superfluous code is removed via [https://gitlab.com/tikiwiki/tiki/-/blob/master/lib/core/Tiki/Composer/CleanVendors.php|CleanVendors]
* Starting in ((Tiki18)), there is a web-based tool to install ((Packages)), which permits to manage even more libraries. This is to provide easy access to dependencies that are not shipped as part of the standard Tiki installation.
* [https://packagist.org/packages/cweagans/composer-patches|cweagans/composer-patches] is used to patch dependencies. This is usually used until a patch is incorporated in a released version of a library
** the patches should be versioned as binary files, to avoid problems with line breaks
* The Tiki community runs its own instance of [https://github.com/composer/satis|Satis], a Simple static Composer repository generator. Source: [https://gitlab.com/tikiwiki/tiki/-/blob/master/doc/devtools/satis.json|satis.json], web: http://composer.tiki.org
* Picking and maintaining dependencies is a critical skill because https://www.reddit.com/r/programming/comments/1z09jq/why_your_software_project_will_slowly_die_without/
* Here are guidelines for what should be available via ((dev:Tiki Packages vs built-in)) to Tiki directly, as we are careful to manage complexity and avoid the worst of dependency hell, as explained at https://pluginproblems.com
* Developers coordinate here: https://dev.tiki.org/Composer
!! History
* Tiki started in 2002, and there was no such tool to manage dependencies
* The [https://en.wikipedia.org/wiki/Composer_(software)|first release of Composer was in 2012].
* In 2013, [https://sourceforge.net/p/tikiwiki/code/44846|Tiki started using Composer and progressively porting dependencies] (instead using SVN externals)
* From 2014 to 2017: dependencies are progressively migrated to Composer
* In 2017, ((dev:Composer Dependencies Revamp|Composer usage in Tiki was revamped)) and a web-based Composer tool was added -> ((Packages))
* In 2018, we [https://sourceforge.net/p/tikiwiki/code/65977|added support for asset-packagist.org] for when dependencies are not on Packagist.org but only NPM or Bower.
* In 2018, a simple way to install packages via FTP: https://packages.tiki.org/
* In 2021, we moved to [https://gitlab.com/tikiwiki/tiki/-/merge_requests/785/diffs|Composer v2], in time for ((Tiki23)) so it will be nice and robust for ((Tiki24))LTS
* In 2021, it was announced that [https://github.com/composer/composer/issues/10340|Composer 2.2 is LTS]
!! Troubleshooting Composer
Please visit https://dev.tiki.org/Composer if you are getting an error about Composer or about a package managed with Composer.
!! Stats
{HTML()}<script type='text/javascript' src='https://www.openhub.net/p/composer/widgets/project_factoids_stats?format=js'></script>{HTML}